Hptsu Mcp

su.hptPublished by hpt.suOfficial publisherv0.4.4Updated Oct 24, 2026

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

VerifiedStreamable HTTPWeb executableWeb Search & ScrapingBusiness & Commerce

Overview

AI-generated overview

Lets an AI assistant search the hpt.su registry of Russian and EAEU vehicle compliance documents, including type approvals, certificates, declarations and VIN-

What you can do
Search and read compliance documents: cross-registry search by number, fetch a full record, and search certificates, declarations, ОТТС, ОТШ, ЗОТТС, ЗОТШ, СБКТС, ЗОЕТС and СУТ registries by number, applicant, status, scheme, regulations or product. Look up vehicles by VIN across the type-approval and safety-certificate registries. Run full-text search inside ОТТС, ОТШ, ЗОТТС and ЗОТШ PDF bodies (paid tier). List and get links for files attached to a document. Resolve reference names for brands, vehicle models, testing labs, certification bodies, TN VED codes and registry kinds.
When to use it
Useful when checking Russian or EAEU vehicle certification: finding the type approval for a given truck or bus, checking the status of a declaration or certificate, listing certificates issued to an applicant, or tracing a VIN to its approvals and safety certificates.
Requirements
Either the hosted endpoint at mcp.hpt.su (OAuth 2.0 or an X-API-Key header) or the local hptsu-mcp package run with uvx, pipx or pip. An hpt.su account and an API key set as HPTSU_API_KEY or sent as X-API-Key; a free tier exists. Network access to hpt.su.
Before you install
The API key is a secret and must be kept out of shared configs. The free tier is throttled to 50 requests per day; full-text search and signed direct downloads need a paid plan, so costs may apply. The server is described as read-only, but search queries and VINs are sent to the third-party hpt.su service.

Installation

In SourceWeft

  1. Open Hptsu Mcp in the dashboard and add it to a workspace.
  2. Connect the required credentials. They are stored privately and never shown on public pages.
  3. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/su.hpt%2Fhptsu-mcp/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config. The client completes OAuth sign-in on first connect.

{
  "mcpServers": {
    "hptsu": {
      "type": "http",
      "url": "https://mcp.hpt.su/mcp"
    }
  }
}

README

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

bash
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:

TierThrottlePriceWhere to get
Free MCP50 requests/day; site subscribers: 500/day on subscribed registries (+50/day elsewhere)Free, signup requiredhpt.su/user/mcp/
Paid API tiers (Lite/Standard/Pro)500–10 000 requests/day, fulltext + direct downloadsSee pricinghpt.su/pricing/#api-tiers

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)
json
{  "mcpServers": {    "hpt-su": {      "command": "hptsu-mcp",      "env": {        "HPTSU_API_KEY": "your-key-here"      }    }  }}
Cursor (.cursor/mcp.json)
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

ToolWhat it doesTier
search_documentsCross-registry search by document number — use when the registry kind is unknown.Free
get_documentFetch one document's full record by slug + kind (both taken from a search result).Free
search_certificatesConformity certificates (ТР ТС / ТР ЕАЭС) — number, applicant, status, scheme, regulations, product.Free
search_declarationsDeclarations of conformity (ТР ТС / ТР ЕАЭС).Free
search_ottsОТТС — vehicle type approvals (ТР ТС 018/2011).Free
search_otchОТШ — chassis type approvals.Free
search_zottsЗОТТС — vehicle conformity assessment conclusions.Free
search_zotchЗОТШ — chassis conformity assessment conclusions.Free
search_sbktsСБКТС — vehicle safety-of-design certificates.Free
search_zoetsЗОЕТС — single-vehicle technical expertise conclusions.Free
search_soutСУТ — type-approval notifications (small dataset, basic fields only).Free
search_by_vinAggregated VIN search across ОТТС / ОТШ / ЗОТТС / ЗОТШ / СБКТС / ЗОЕТС.Free
fulltext_searchFull-text search inside ОТТС / ОТШ / ЗОТТС / ЗОТШ PDF bodies.Paid
list_document_filesList the files attached to a document (returns file_uids for download).Free
download_document_fileGet links for a document file — page URL is always returned; the signed direct-download URL needs a plan that includes it.Free / Paid

Reference dictionaries

ToolWhat it does
list_brandsResolve vehicle brand names.
list_vehicle_modelsResolve vehicle model names within a brand.
list_test_labsAccredited testing laboratories.
list_certification_bodiesAccredited certification bodies.
list_tnved_codesTN VED EAEU classifier (cert/decl context only).
list_registry_kindsEnumerate 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

VariableDefaultMeaning
HPTSU_API_KEYrequiredBearer key from hpt.su cabinet.
HPTSU_BASE_URLhttps://hpt.su/api/v1Override for staging / on-prem deployments.
HPTSU_TRANSPORTstdiostdio · streamable-http · sse.
HPTSU_TIMEOUT30.0Per-request HTTP timeout (s).
HPTSU_USER_AGENThptsu-mcp/0.1User-Agent header.
HPTSU_LOG_LEVELINFOStandard 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

bash
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

mcp-name: su.hpt/hptsu-mcp

Source: README.md at commit 1ef6181

Tools

0
This server asks you to sign in, so SourceWeft could not read its tools without an account and has not indexed them. What a connected account sees can depend on that account and its permissions.

Version history

1
  1. v0.4.4LatestSep 16, 2026

Score

85% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts