# hptsu-mcp MCP server

Search hpt.su — Russian/EAEU vehicle compliance documents: type approvals, certificates, VIN lookup.

## Links
- Registry page: https://www.getdrio.com/mcp/su-hpt-hptsu-mcp
- Repository: https://github.com/hpt-su/hptsu-mcp
- Website: https://hpt.su

## Install
- Command: `uvx hptsu-mcp`
- Endpoint: https://mcp.hpt.su/mcp
- Auth: Auth required by registry metadata

## Setup notes
- Remote header: X-API-Key (required; secret)
- Package: Pypi hptsu-mcp v0.4.1
- Environment variable: HPTSU_API_KEY (required; secret)
- Environment variable: HPTSU_BASE_URL (default https://hpt.su/api/v1)
- The upstream registry signals required auth or secrets.
- Remote endpoint: https://mcp.hpt.su/mcp
- Header: X-API-Key

## Tools
- search_documents - Cross-registry search by document number across all hpt.su kinds. Endpoint: https://mcp.hpt.su/mcp
- get_document - Fetch a single Document by slug+kind. Endpoint: https://mcp.hpt.su/mcp
- search_certificates - Search conformity certificates (ТР ТС / ТР ЕАЭС). Endpoint: https://mcp.hpt.su/mcp
- search_declarations - Search declarations of conformity (ТР ТС / ТР ЕАЭС). Endpoint: https://mcp.hpt.su/mcp
- search_otts - Search ОТТС (vehicle type approvals, ТР ТС 018/2011). Endpoint: https://mcp.hpt.su/mcp
- search_otch - Search ОТШ (chassis type approvals). Endpoint: https://mcp.hpt.su/mcp
- search_zotts - Search ЗОТТС (vehicle conformity assessment conclusion). Endpoint: https://mcp.hpt.su/mcp
- search_zotch - Search ЗОТШ (chassis conformity assessment conclusion). Endpoint: https://mcp.hpt.su/mcp
- search_sbkts - Search СБКТС (vehicle safety certificate). Endpoint: https://mcp.hpt.su/mcp
- search_zoets - Search ЗОЕТС (vehicle technical expertise conclusion). Endpoint: https://mcp.hpt.su/mcp
- search_sout - Search СУТ (vehicle type notification — small dataset, only basic fields). Endpoint: https://mcp.hpt.su/mcp
- search_by_vin - Aggregated search by VIN across all car-kinds (ОТТС/ОТШ/ЗОТТС/ЗОТШ/
    СБКТС/ЗОЕТС). Open for any active API key — no subscription required.

    Returns documents whose VIN field contains the given fragment, newest
    first. For exact full-VIN search within a single registry use the
    per-kind tool (search_otts/search_sbkts/…) with its `vin` parameter.
     Endpoint: https://mcp.hpt.su/mcp
- fulltext_search - Full-text search inside type-approval document bodies (PDF text).

    Covers ОТТС / ОТШ / ЗОТТС / ЗОТШ. Other document kinds (СБКТС / ЗОЕТС /
    СУТ / cert / decl) are not covered by full-text search.

    **Premium feature** — requires a plan that includes full-text search
    (see https://hpt.su/pricing/) with a subscription covering at least
    one type-approval kind.
     Endpoint: https://mcp.hpt.su/mcp
- list_document_files - List the files attached to a document.

    Returns `[{file_uid, file_name, kind, pages_count, published_at}]` —
    each entry's `file_uid` can be passed to `download_document_file`.

    A document often has several PDFs (e.g. cleaned + original); use this
    tool to enumerate them and pick the right one before download.
     Endpoint: https://mcp.hpt.su/mcp
- download_document_file - Get links for a document file: page URL for everyone, direct
    download URL when the plan allows it.

    Always returns `document_page_url` — the document's page on hpt.su
    where the user can download the file manually under their account.
    Share this link with the user.

    When the plan includes direct downloads, the response also contains
    `download_url` — a personal link to the PDF (works only when signed
    in to hpt.su under the same account that owns the API key; the
    download quota is charged at actual download time). Otherwise
    `download_url` is null and `download_note` explains why.
     Endpoint: https://mcp.hpt.su/mcp
- list_brands - Resolve a vehicle brand name to its canonical record (used to filter
    type approvals). Endpoint: https://mcp.hpt.su/mcp
- list_vehicle_models - Resolve a vehicle model name (within a brand) to canonical record. Endpoint: https://mcp.hpt.su/mcp
- list_test_labs - Lookup accredited testing laboratories (issuers of СБКТС/ЗОЕТС). Endpoint: https://mcp.hpt.su/mcp
- list_certification_bodies - Lookup accredited certification bodies (issuers of сертификатов/деклараций). Endpoint: https://mcp.hpt.su/mcp
- list_tnved_codes - TN VED EAEU classifier lookup.

    Note: TN VED codes are linked **only** to certificates and declarations —
    not to vehicle type approvals or safety reports.
     Endpoint: https://mcp.hpt.su/mcp
- list_registry_kinds - Return the catalogue of registry kinds exposed by the hpt.su public API. Endpoint: https://mcp.hpt.su/mcp

## Resources
- hptsu://about - MIME type: text/plain

## Prompts
Not captured

## Metadata
- Owner: su.hpt
- Version: 0.4.1
- Runtime: Pypi
- Transports: STDIO, HTTP
- License: Not captured
- Language: Not captured
- Stars: Not captured
- Updated: Jul 30, 2026
- Source: https://registry.modelcontextprotocol.io