hptsu-mcp 0.3.0

MCP server for searching Russian/EAEU vehicle compliance documents on hpt.su — type approvals (ОТТС/СБКТС/ОТШ), conformity certificates, declarations, type-approval notifications (СУТ).

hpt.su MCP Server

Model Context Protocol server for the hpt.su registry of Russian and EAEU vehicle compliance documents — type approvals (ОТТС / СБКТС / ОТШ), conformity certificates (ТР ТС / ТР ЕАЭС), declarations of conformity, type-approval notifications (СУТ), and single-vehicle evaluation reports.

What this is

hptsu-mcp lets any MCP-compatible AI assistant (Claude Desktop, Cursor, Cline, Continue, Goose, Cherry Studio, 5ire, LM Studio, ChatGPT Desktop, …) search the hpt.su registry directly — without you copy-pasting numbers between the chat window and the website.

hpt.su is the largest aggregated database in the Russian Federation and the EAEU customs union for:

• Сертификаты соответствия — conformity certificates issued under TR CU / TR EAEU technical regulations. Browse at hpt.su/documents/cert/.
• Декларации о соответствии — declarations of conformity. Browse at hpt.su/documents/decl/.
• ОТТС — Vehicle Type Approval (Одобрение типа транспортного средства) under TR CU 018/2011 — covers automobiles, trucks, buses, trailers, motorcycles. Browse at hpt.su/documents/otts/.
• СБКТС — Vehicle Safety-of-Design Certificate (Свидетельство о безопасности конструкции транспортного средства). Browse at hpt.su/documents/sbkts/.
• ОТШ — Chassis Type Approval (Одобрение типа шасси). Browse at hpt.su/documents/otch/.
• СУТ — Notification of Type Approval (Сообщение об утверждении типа транспортного средства). Browse at hpt.su/documents/sout/.
• ЗОЕТС / ЗОТШ / ЗОТТС — single-vehicle / chassis / vehicle evaluation reports issued by accredited testing laboratories. Browse at hpt.su/documents/zoets/, zotch/, zotts/.

Use cases an LLM agent can solve through this server:

• "Find the type approval for a 2024 KAMAZ-43118 truck."
• "What is the status of EAC declaration ЕАЭС N RU Д-RU.HA67.B.12345/24?"
• "List recent conformity certificates issued to applicant 'Group GAZ' under scheme 1с."
• "Has SBKTS been issued for VIN-derived chassis number XYZ123…?"
• "Fetch type-approval notifications (СУТ) issued for manufacturer X."

Quick start

1. Install

uv tool install hptsu-mcp
# or
pipx install hptsu-mcp
# or with plain pip
pip install hptsu-mcp

2. Get an API key

Two tiers exist for MCP:

Tier	Throttle	Price	Where to get
Free MCP	50 requests/day	Free, signup required	hpt.su/user/mcp/
Paid MCP	10 000 requests/day, fulltext + downloads	See pricing	hpt.su/pricing/

The free tier is plenty for demos and personal use. Upgrade unlocks fulltext_search, download_document_file, the VIN aggregator, and the higher daily limit.

1. Create an account at hpt.su/accounts/signup/.
2. Click "Get free MCP key" in hpt.su/user/mcp/.
3. (Optional) Upgrade on hpt.su/pricing/.

API documentation (Swagger UI): https://hpt.su/api/v1/docs/ · OpenAPI schema: https://hpt.su/api/v1/schema/

3. Wire it into your MCP client

Claude Desktop (claude_desktop_config.json)

{
  "mcpServers": {
    "hpt-su": {
      "command": "hptsu-mcp",
      "env": {
        "HPTSU_API_KEY": "your-key-here"
      }
    }
  }
}

Cursor (.cursor/mcp.json)

{
  "mcpServers": {
    "hpt-su": {
      "command": "hptsu-mcp",
      "env": { "HPTSU_API_KEY": "your-key-here" }
    }
  }
}

Cline / Continue / Goose / etc.

Any MCP client that supports stdio transport works the same way — point it at the hptsu-mcp executable and pass HPTSU_API_KEY in the environment.

HTTP / SSE transport

For hosted MCP gateways set HPTSU_TRANSPORT=streamable-http (or sse) and call the server over the network.

Tools

Search & retrieval

Tool	What it does	Tier
search_documents	Cross-registry search by document number (any kind).	Free
get_document	Fetch a single Document by UUID.	Free
search_certificates	Conformity certificates — filter by number, applicant, status, scheme, TN VED code.	Free
search_declarations	Declarations of conformity.	Free
search_type_approvals	Vehicle (ОТТС) or chassis (ОТШ) type approvals — filter by brand / model / year / applicant.	Free
search_safety_reports	СБКТС / СУТ / ЗОЕТС / ЗОТШ / ЗОТТС feeds.	Free
search_by_vin	Aggregated VIN search across ОТТС / СБКТС / ЗОЕТС / ЗОТТС.	Free
fulltext_search	Full-text search inside PDF bodies.	Paid
download_document_file	Issue a time-limited signed PDF download URL.	Paid

Reference dictionaries

Tool	What it does
list_brands	Resolve vehicle brand names.
list_vehicle_models	Resolve vehicle model names within a brand.
list_test_labs	Accredited testing laboratories.
list_certification_bodies	Accredited certification bodies.
list_tnved_codes	TN VED EAEU classifier (cert/decl context only).
list_registry_kinds	Enumerate registry kinds the API exposes.

Reference filters accept names, not internal ids. The search tools resolve human-readable values automatically — pass issuer="НАМИ", brand="KAMAZ", eco_class="5", wheel_formula="4x2", axis_count="2" and the server looks up the reference id for you (issuer / brand also take a numeric id directly). An ambiguous name returns the matching candidates to pick from.

Configuration

Variable	Default	Meaning
HPTSU_API_KEY	required	Bearer key from hpt.su cabinet.
HPTSU_BASE_URL	https://hpt.su/api/v1	Override for staging / on-prem deployments.
HPTSU_TRANSPORT	stdio	stdio · streamable-http · sse.
HPTSU_TIMEOUT	30.0	Per-request HTTP timeout (s).
HPTSU_USER_AGENT	hptsu-mcp/0.1	User-Agent header.
HPTSU_LOG_LEVEL	INFO	Standard logging levels.

SEO description (for catalogue listings)

hpt.su MCP server — let your AI assistant search the hpt.su database of Russian and EAEU vehicle compliance documents directly. Covers type approvals (ОТТС, ОТШ), safety-of-design certificates (СБКТС), conformity certificates and declarations under TR CU / TR EAEU technical regulations, and type-approval notifications (СУТ). Source registry: https://hpt.su. API documentation: https://hpt.su/api/v1/docs/. Read-only, Bearer-key auth, MIT licence.

Russian-language version:

MCP-сервер hpt.su — поиск по крупнейшей базе российских и ЕАЭС документов соответствия для автотранспорта: ОТТС, СБКТС, ОТШ, СУТ (сообщения об утверждении типа), сертификаты соответствия и декларации (ТР ТС / ТР ЕАЭС). Источник: https://hpt.su. REST API: https://hpt.su/api/v1/docs/. Только чтение, Bearer-аутентификация, лицензия MIT.

Keywords

mcp · model-context-protocol · hpt.su · vehicle certification · type approval · ОТТС · СБКТС · EAEU · TR CU 018 · conformity certificate · declaration of conformity · сертификат соответствия · декларация о соответствии · СУТ · Russian compliance database · AI agent · Claude · Cursor · Cline

Development

git clone https://github.com/hpt-su/hptsu-mcp
cd hptsu-mcp
uv sync --all-groups
uv run pytest
uv run hptsu-mcp           # launch via stdio

License

MIT — see LICENSE.

Links

• Source registry: https://hpt.su
• MCP landing page: https://hpt.su/mcp/
• MCP key cabinet: https://hpt.su/user/mcp/
• API documentation: https://hpt.su/api/v1/docs/
• OpenAPI schema: https://hpt.su/api/v1/schema/
• Public pricing: https://hpt.su/pricing/
• Issue tracker: https://github.com/hpt-su/hptsu-mcp/issues
• Contact: [e-mail]
• Model Context Protocol: https://modelcontextprotocol.io