Hptsu Mcp

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.

[License: MIT] [Python 3.11+]

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# orpipx install hptsu-mcp# or with plain pippip install hptsu-mcp

2. Get an API key

Two tiers exist for MCP:

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.

OAuth (hosted mode)

The hosted instance at https://mcp.hpt.su/mcp acts as an OAuth 2.0 protected resource (RFC 9728): it publishes /.well-known/oauth-protected-resource/mcp pointing at https://hpt.su as the authorization server, and challenges unauthenticated requests to /mcp with 401 WWW-Authenticate: Bearer resource_metadata="...". This lets clients that do OAuth discovery connect without a manually issued API key.

Two credential styles both work against the hosted endpoint:

• X-API-Key: <public_id>:<secret> — a static key from hpt.su/user/mcp/. Works with any client that lets you set a custom header (Cursor, Cline, Continue, local scripts, …).
• OAuth 2.0 Bearer — obtained via the standard MCP OAuth flow (discovery → dynamic client registration → authorization code + PKCE). Supported by clients that implement MCP's OAuth discovery, including:
  • ChatGPT (Developer Mode / Connectors);
  • Claude.ai / claude.com (custom connectors);
  • VS Code (MCP extension host);
  • Cursor, via its cursor:// deep-link callback;
  • Local/loopback clients that redirect to 127.0.0.1/localhost (the typical desktop-app OAuth callback pattern).

A Bearer token bound to a different MCP resource (RFC 8707) or that has expired/been revoked is rejected with a transport 401 — the client should refresh or re-run the OAuth flow, not treat it as a data response.

Tools

Search & retrieval

Reference dictionaries

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

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-mcpcd hptsu-mcpuv sync --all-groupsuv run pytestuv 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: [email protected]
• Model Context Protocol: https://modelcontextprotocol.io

mcp-name: su.hpt/hptsu-mcp