{
  "markdown": "# hpt.su MCP Server\n\n> **Model Context Protocol server for the [hpt.su](https://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.\n\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n[![Python 3.11+](https://img.shields.io/badge/python-3.11+-blue.svg)](https://www.python.org/downloads/)\n\n## What this is\n\n`hptsu-mcp` lets any [MCP-compatible](https://modelcontextprotocol.io) 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.\n\n[**hpt.su**](https://hpt.su) is the largest aggregated database in the Russian Federation and the EAEU customs union for:\n\n- **Сертификаты соответствия** — conformity certificates issued under TR CU / TR EAEU technical regulations. Browse at [hpt.su/documents/cert/](https://hpt.su/documents/cert/index.html).\n- **Декларации о соответствии** — declarations of conformity. Browse at [hpt.su/documents/decl/](https://hpt.su/documents/decl/index.html).\n- **ОТТС** — Vehicle Type Approval (Одобрение типа транспортного средства) under TR CU 018/2011 — covers automobiles, trucks, buses, trailers, motorcycles. Browse at [hpt.su/documents/otts/](https://hpt.su/documents/otts/index.html).\n- **СБКТС** — Vehicle Safety-of-Design Certificate (Свидетельство о безопасности конструкции транспортного средства). Browse at [hpt.su/documents/sbkts/](https://hpt.su/documents/sbkts/index.html).\n- **ОТШ** — Chassis Type Approval (Одобрение типа шасси). Browse at [hpt.su/documents/otch/](https://hpt.su/documents/otch/index.html).\n- **СУТ** — Notification of Type Approval (Сообщение об утверждении типа транспортного средства). Browse at [hpt.su/documents/sout/](https://hpt.su/documents/sout/index.html).\n- **ЗОЕТС / ЗОТШ / ЗОТТС** — single-vehicle / chassis / vehicle evaluation reports issued by accredited testing laboratories. Browse at [hpt.su/documents/zoets/](https://hpt.su/documents/zoets/index.html), [zotch/](https://hpt.su/documents/zotch/index.html), [zotts/](https://hpt.su/documents/zotts/index.html).\n\nUse cases an LLM agent can solve through this server:\n\n- *\"Find the type approval for a 2024 KAMAZ-43118 truck.\"*\n- *\"What is the status of EAC declaration ЕАЭС N RU Д-RU.HA67.B.12345/24?\"*\n- *\"List recent conformity certificates issued to applicant 'Group GAZ' under scheme 1с.\"*\n- *\"Has SBKTS been issued for VIN-derived chassis number XYZ123…?\"*\n- *\"Fetch type-approval notifications (СУТ) issued for manufacturer X.\"*\n\n## Quick start\n\n### 1. Install\n\n```bash\nuv tool install hptsu-mcp\n# or\npipx install hptsu-mcp\n# or with plain pip\npip install hptsu-mcp\n```\n\n### 2. Get an API key\n\nTwo tiers exist for MCP:\n\n| Tier | Throttle | Price | Where to get |\n|------|---------|-------|--------------|\n| **Free MCP** | 50 requests/day; site subscribers: 500/day on subscribed registries (+50/day elsewhere) | Free, signup required | [hpt.su/user/mcp/](https://hpt.su/user/mcp/) |\n| **Paid MCP** | 10 000 requests/day, fulltext + downloads | See pricing | [hpt.su/pricing/](https://hpt.su/pricing/) |\n\nThe free tier is plenty for demos and personal use. Upgrade unlocks `fulltext_search`, `download_document_file`, the VIN aggregator, and the higher daily limit.\n\n1. Create an account at [hpt.su/accounts/signup/](https://hpt.su/accounts/signup/).\n2. Click \"Get free MCP key\" in [hpt.su/user/mcp/](https://hpt.su/user/mcp/).\n3. (Optional) Upgrade on [hpt.su/pricing/](https://hpt.su/pricing/).\n\nAPI documentation (Swagger UI): https://hpt.su/api/v1/docs/ · OpenAPI schema: https://hpt.su/api/v1/schema/\n\n### 3. Wire it into your MCP client\n\n#### Claude Desktop (`claude_desktop_config.json`)\n\n```json\n{\n  \"mcpServers\": {\n    \"hpt-su\": {\n      \"command\": \"hptsu-mcp\",\n      \"env\": {\n        \"HPTSU_API_KEY\": \"your-key-here\"\n      }\n    }\n  }\n}\n```\n\n#### Cursor (`.cursor/mcp.json`)\n\n```json\n{\n  \"mcpServers\": {\n    \"hpt-su\": {\n      \"command\": \"hptsu-mcp\",\n      \"env\": { \"HPTSU_API_KEY\": \"your-key-here\" }\n    }\n  }\n}\n```\n\n#### Cline / Continue / Goose / etc.\n\nAny 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.\n\n#### HTTP / SSE transport\n\nFor hosted MCP gateways set `HPTSU_TRANSPORT=streamable-http` (or `sse`) and call the server over the network.\n\n## Tools\n\n### Search & retrieval\n\n| Tool | What it does | Tier |\n|------|-------------|------|\n| `search_documents` | Cross-registry search by document number (any kind). | Free |\n| `get_document` | Fetch a single Document by UUID. | Free |\n| `search_certificates` | Conformity certificates — filter by number, applicant, status, scheme, TN VED code. | Free |\n| `search_declarations` | Declarations of conformity. | Free |\n| `search_type_approvals` | Vehicle (ОТТС) or chassis (ОТШ) type approvals — filter by brand / model / year / applicant. | Free |\n| `search_safety_reports` | СБКТС / СУТ / ЗОЕТС / ЗОТШ / ЗОТТС feeds. | Free |\n| `search_by_vin` | Aggregated VIN search across ОТТС / СБКТС / ЗОЕТС / ЗОТТС. | Free |\n| `fulltext_search` | Full-text search inside PDF bodies. | **Paid** |\n| `download_document_file` | Issue a time-limited signed PDF download URL. | **Paid** |\n\n### Reference dictionaries\n\n| Tool | What it does |\n|------|-------------|\n| `list_brands` | Resolve vehicle brand names. |\n| `list_vehicle_models` | Resolve vehicle model names within a brand. |\n| `list_test_labs` | Accredited testing laboratories. |\n| `list_certification_bodies` | Accredited certification bodies. |\n| `list_tnved_codes` | TN VED EAEU classifier (cert/decl context only). |\n| `list_registry_kinds` | Enumerate registry kinds the API exposes. |\n\n> **Reference filters accept names, not internal ids.** The search tools resolve\n> human-readable values automatically — pass `issuer=\"НАМИ\"`, `brand=\"KAMAZ\"`,\n> `eco_class=\"5\"`, `wheel_formula=\"4x2\"`, `axis_count=\"2\"` and the server looks up\n> the reference id for you (`issuer` / `brand` also take a numeric id directly).\n> An ambiguous name returns the matching candidates to pick from.\n\n## Configuration\n\n| Variable | Default | Meaning |\n|----------|---------|---------|\n| `HPTSU_API_KEY` | _required_ | Bearer key from hpt.su cabinet. |\n| `HPTSU_BASE_URL` | `https://hpt.su/api/v1` | Override for staging / on-prem deployments. |\n| `HPTSU_TRANSPORT` | `stdio` | `stdio` · `streamable-http` · `sse`. |\n| `HPTSU_TIMEOUT` | `30.0` | Per-request HTTP timeout (s). |\n| `HPTSU_USER_AGENT` | `hptsu-mcp/0.1` | User-Agent header. |\n| `HPTSU_LOG_LEVEL` | `INFO` | Standard `logging` levels. |\n\n## SEO description (for catalogue listings)\n\n> **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](https://hpt.su). API documentation: [https://hpt.su/api/v1/docs/](https://hpt.su/api/v1/docs/). Read-only, Bearer-key auth, MIT licence.\n\nRussian-language version:\n\n> **MCP-сервер hpt.su** — поиск по крупнейшей базе российских и ЕАЭС документов соответствия для автотранспорта: ОТТС, СБКТС, ОТШ, СУТ (сообщения об утверждении типа), сертификаты соответствия и декларации (ТР ТС / ТР ЕАЭС). Источник: [https://hpt.su](https://hpt.su). REST API: [https://hpt.su/api/v1/docs/](https://hpt.su/api/v1/docs/). Только чтение, Bearer-аутентификация, лицензия MIT.\n\n## Keywords\n\n`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`\n\n## Development\n\n```bash\ngit clone https://github.com/hpt-su/hptsu-mcp\ncd hptsu-mcp\nuv sync --all-groups\nuv run pytest\nuv run hptsu-mcp           # launch via stdio\n```\n\n## License\n\nMIT — see [LICENSE](./LICENSE).\n\n## Links\n\n- Source registry: **https://hpt.su**\n- MCP landing page: **https://hpt.su/mcp/**\n- MCP key cabinet: **https://hpt.su/user/mcp/**\n- API documentation: **https://hpt.su/api/v1/docs/**\n- OpenAPI schema: **https://hpt.su/api/v1/schema/**\n- Public pricing: **https://hpt.su/pricing/**\n- Issue tracker: **https://github.com/hpt-su/hptsu-mcp/issues**\n- Contact: **mcp@hpt.su**\n- Model Context Protocol: **https://modelcontextprotocol.io**\n\nmcp-name: su.hpt/hptsu-mcp\n",
  "bytes": 8851,
  "sha": "383d6be64b1ec89f281cc64ac5b0041c04ddedb958019971e0109d892aab8092",
  "repo_slug": "hpt-su/hptsu-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_su_hpt_hptsu_mcp_e6b52d5f/readme"
}