chestny-znak-mcp-ru
MCP server for the Russian Chestny Znak (CRPT/СУЗ) API that lets AI assistants search, describe, and safely call read/write/destructive endpoints, plus raw requests and credential management.
Explore the API: list sections, search methods by Russian/English keywords, get the capabilities map, and view full endpoint cards (method, path, params, safety).
Call catalog endpoints safely: read methods run immediately; writes require confirm_write; destructive ops also require i_understand_this_modifies_data.
Execute raw HTTP requests to any path, with safe verbs for reads and restricted write/delete verbs with confirmation.
Auto-paginate read endpoints and fetch many rows in one response.
Manage API tokens/cabinets locally: list, add, switch, rotate, remove cabinets, with secret values kept out of chat unless explicitly consented.
Typical business tasks: verify marking codes, check emissions orders, export participant's codes, trace product route by GTIN.
chestny-znak-mcp-ru
API Честного знака (ГИС МТ и СУЗ) для ИИ-ассистентов: сведения о кодах маркировки, выгрузка по фильтру, маршрут товара по GTIN, заказы на эмиссию, отчёты о нанесении, проверка подлинности.
Каталог собран из первоисточника (открытые SDK True API и СУЗ) и лежит в репозитории как
crpt_mcp/endpoints.yaml: 33 метода, из них 24 на чтение,
9 на запись и 0 необратимых. Сервер исполняет ровно этот файл,
поэтому таблица ниже не может разойтись с кодом.
Документация ЦРПТ открыта: https://docs.crpt.ru/gismt/True_API/. Машиночитаемой спеки при этом нет,
/api/v3/true-api/swagger.jsonотдаёт 401, поэтому каталог не сгенерирован из спеки, а собран по открытым SDK, и у каждой записи стоитverified: false. Это карта для разведки: пути надёжные, глаголы и параметры сверяются с документацией и на живом контуре. Сервер показывает этот статус вdescribe_method, чтобы агент не выдавал догадку за факт.
Установка
Два пути, выбирайте по тому, есть ли у вас терминал.
Без терминала: файл .mcpb
Скачайте chestny-znak-mcp-ru-vX.Y.Z.mcpb со страницы релизов
и откройте двойным щелчком. Claude Desktop поставит сервер сам и спросит ключи
в отдельном окне, в конфиг лезть не придётся. Нужен Python 3.10 или новее:
зависимости сервер доставит себе при первом запуске.
В терминале
uvx chestny-znak-mcp-ruClaude Desktop, claude_desktop_config.json:
{
"mcpServers": {
"crpt-mcp": {
"command": "uvx",
"args": ["chestny-znak-mcp-ru"],
"env": { "CRPT_TOKEN": "..." }
}
}
}Related MCP server: chestnyznak-mcp
Ключи
GET /api/v3/true-api/auth/key отдаёт случайные данные, их подписывают КЭП через КриптоПро на машине пользователя, а POST /api/v3/true-api/auth/simpleSignIn меняет подпись на токен. Токен живёт около 10 часов. Закрытый ключ в сервер не попадает.
переменная | секрет | что это |
| да | Токен ГИС МТ, выдаётся в обмен на данные, подписанные КЭП. Живёт около 10 часов. |
Ключи можно не держать в окружении: сервер умеет кабинеты и кладёт их в
~/.ru-mcp/cabinets.json с правами 600, вне репозитория.
Карта методов
раздел | методов | чтение | запись | необратимое |
Проверка кодов | 8 | 7 | 1 | 0 |
Коды маркировки | 6 | 5 | 1 | 0 |
Заказы на эмиссию | 5 | 3 | 2 | 0 |
Служебные | 4 | 4 | 0 | 0 |
Чеки | 3 | 1 | 2 | 0 |
Авторизация | 2 | 1 | 1 | 0 |
Документы ГИС МТ | 2 | 2 | 0 | 0 |
Отчёты о нанесении | 2 | 0 | 2 | 0 |
Товары и GTIN | 1 | 1 | 0 | 0 |
всего | 33 | 24 | 9 | 0 |
Как это выглядит в чате
Вы: коды маркировки в обороте
crpt_search_methods("коды маркировки в обороте")
crpt_gis_cises_my GET /api/v3/true-api/cises/my чтение
crpt_gis_cis_outcheck GET /api/v1/cis/outCheck чтение
crpt_suz_codes GET /api/v3/codes чтение
crpt_describe_method("crpt_gis_cises_my")
Коды маркировки, принадлежащие участнику оборота
GET markirovka.crpt.ru/api/v3/true-api/cises/my
параметры: нет
класс доступа: чтение
crpt_call_method("crpt_gis_cises_my", {})Три инструмента вместо 33 функций: агент ищет метод словами, читает его карточку и вызывает. Запись и необратимое спрашивают подтверждение.
Что обычно просят:
Проверить пачку кодов маркировки перед приёмкой товара.
Посмотреть статус заказа на эмиссию кодов в СУЗ.
Выгрузить коды, принадлежащие участнику оборота.
Посмотреть маршрут товара по GTIN.
Безопасность
Сервер работает на машине пользователя, ключи наружу не уходят. У методов три класса доступа: чтение идёт сразу, запись и необратимые действия требуют подтверждения. Заголовок авторизации не покидает домены сервиса даже при вызове произвольного пути.
Проверить установку
uvx chestny-znak-mcp-ru doctorПечатает, сколько методов загрузилось, найдены ли ключи и откуда. Секреты не
показывает. С --live делает один дешёвый реальный вызов на чтение.
Родня
Ядро вынесено в schema-mcp-core. Соседние серверы: vk-mcp-ru, diadoc-mcp-ru, sbis-mcp-ru. Маркетплейсы живут отдельно: marketplaces-mcp-ru.
MIT. Автор Илья Утов.
Все проекты одним списком, разобранные по назначению: ilyautov.github.io.
Privacy Policy
chestny-znak-mcp-ru не собирает и не передаёт ваши данные: ключи лежат локально в
~/.ru-mcp/cabinets.json, запросы идут только в API Честный знак (ГИС МТ и СУЗ), телеметрии нет.
Полный текст: PRIVACY_POLICY.md.
Available Tools
18 toolscrpt_add_cabinetAIdempotent
Add or update a cabinet (a named set of API credentials), from chat.
⚠️ This puts the key into the chat transcript — requires i_understand_key_goes_to_chat=true. The terminal-free safe alternative is the installer (install.py / double-click), where the key never enters chat.
Args: credentials: dict with the required fields for this service ({fields}). For Ozon: {{"client_id": "...", "api_key": "..."}}; for WB: {{"token": "..."}}. name: optional label. If omitted, the cabinet is named after the real shop name fetched from the marketplace (falls back to "main"). i_understand_key_goes_to_chat: must be true to proceed. Saved to ~/.marketplace-mcp/cabinets.json (local, chmod 600), never echoed.
Inputs: credentials (required), name, i_understand_key_goes_to_chat. Returns: result
crpt_call_methodARead-only
Execute one READ endpoint from the catalog by operation_id.
Target API: ГИС МТ и СУЗ «Честный знак» (markirovka.crpt.ru, suzgrid.crpt.ru).
Reads only: nothing here changes data, so it runs without confirmation. To change data use crpt_write_method, to delete use crpt_delete_method.
Args: operation_id: id from the catalog (see crpt_search_methods). path_values: values for {placeholders} in the path. query: query-string parameters. body: JSON request body (a few read endpoints take one). Returns JSON: {"ok": true, "status", "data"} or the error envelope.
Inputs: operation_id (required), body, query, path_values. Returns: result
crpt_check_authARead-only
Check whether the required credentials are present in the environment.
Does NOT reveal secret values — only reports which variables are set. Returns JSON: {"ready": bool, "missing": [str], "required": [str]}.
Inputs: no named parameters. Returns: result
crpt_delete_methodADestructive
Execute one DESTRUCTIVE endpoint: deletes or irreversibly changes data.
Target API: ГИС МТ и СУЗ «Честный знак» (markirovka.crpt.ru, suzgrid.crpt.ru).
Both confirm_write=true and i_understand_this_modifies_data=true are required; nothing is sent without both.
Args: operation_id: id from the catalog (see crpt_search_methods). path_values: values for {placeholders} in the path. query: query-string parameters. body: JSON request body. confirm_write: must be true. i_understand_this_modifies_data: must be true. Returns JSON: {"ok": true, "status", "data"} or the error envelope.
Inputs: operation_id (required), body, query, path_values, +2 more. Returns: result
crpt_delete_rawADestructive
Delete data at ANY path, including paths not in the catalog.
Target API: ГИС МТ и СУЗ «Честный знак» (markirovka.crpt.ru, suzgrid.crpt.ru).
DELETE only. Both confirm_write=true and i_understand_this_modifies_data=true are required.
Args: path: full path beginning with '/'. method: DELETE. host: host override; defaults to the service's default host. query: query-string parameters. body: JSON request body. confirm_write: must be true. i_understand_this_modifies_data: must be true. Returns JSON: {"ok": true, "status", "data"} or the error envelope.
Inputs: path (required), body, host, query, +3 more. Returns: result
crpt_describe_methodBRead-only
Return the full catalog record for one endpoint: method, host, path, scope, safety level, pagination style, rate limit, params and doc URL.
Inputs: operation_id (required). Returns: result
crpt_fetch_allARead-only
Auto-paginate a read endpoint and return every row in one response.
Handles offset, last_id, cursor (Ozon v4/v5), page and WB lastChangeDate styles. The array path is taken from the catalog automatically.
Args: operation_id: a read endpoint from the catalog. query / body / path_values: base parameters (cursor fields are managed). items_path: override the array path (default: the endpoint's own). limit: page size to request. max_items: hard cap to protect context (default 10000). Returns JSON: {"ok", "items", "total_fetched", "pages_fetched", "truncated"}.
Inputs: operation_id (required), body, limit, query, +3 more. Returns: result
crpt_get_rawARead-only
Read ANY endpoint by path, including ones missing from the catalog.
Target API: ГИС МТ и СУЗ «Честный знак» (markirovka.crpt.ru, suzgrid.crpt.ru).
Safe verbs only (GET, HEAD, OPTIONS). To change data use crpt_write_raw, to delete use crpt_delete_raw.
Args: path: full path beginning with '/', e.g. "/api/v3/ping". method: safe verb, GET by default. host: host override; defaults to the service's default host. query: query-string parameters. body: JSON request body (rare on reads; some APIs want one). Returns JSON: {"ok": true, "status", "data"} or the error envelope.
Inputs: path (required), body, host, query, +1 more. Returns: result
crpt_get_sectionARead-only
List all endpoints in one section.
Args: section: section name (see crpt_list_sections), e.g. "statistics". Returns JSON list of {operation_id, method, path, safety, summary}.
Inputs: section (required). Returns: result
crpt_list_cabinetsARead-only
List configured cabinets for this marketplace and which one is active.
Returns JSON: {"active": str|null, "cabinets": [names], "fields_needed": [...]}. Secret values are never returned.
Inputs: no named parameters. Returns: result
crpt_list_sectionsARead-only
List API sections and how many catalog endpoints each contains.
Inputs: no named parameters. Returns: result
crpt_mapARead-only
The big picture: business entities this API covers and the go-to methods for each. Call with no args to see the whole map ("you are here"); pass entity="reviews" (or stocks/prices/orders/…) to list every method of one entity. Use this before guessing — it orients you fast.
Inputs: entity. Returns: result
crpt_remove_cabinetADestructive
Delete a stored cabinet. If it was active, another becomes active.
Args: name: the cabinet to remove.
Inputs: name (required). Returns: result
crpt_search_methodsARead-only
Search the endpoint catalog by keyword (works in Russian and English).
Args: query: free text, e.g. "остатки", "stocks", "update price". limit: max results (1-50). Returns JSON list of matching endpoints (best first).
Inputs: query (required), limit. Returns: result
crpt_set_keyAIdempotent
Change / rotate the API key from chat (e.g. the old one expired or leaked).
⚠️ The key goes into the chat transcript — requires i_understand_key_goes_to_chat=true. The safe, terminal-free alternative is the installer, where the key never enters chat. Use a scoped key and rotate it in the seller cabinet if it was exposed.
Args: credentials: dict with the required fields ({fields}). cabinet: which cabinet to update. Default: the active one (so "my key expired" just works). If there is none, the cabinet is named from the marketplace's shop name, else "main". i_understand_key_goes_to_chat: must be true to proceed. On success the key is validated against the marketplace and the shop name is reported. Saved locally (chmod 600), never echoed back.
Inputs: credentials (required), cabinet, i_understand_key_goes_to_chat. Returns: result
crpt_use_cabinetAIdempotent
Switch the active cabinet. Subsequent API calls use its credentials.
Args: name: the cabinet to activate (see crpt_list_cabinets).
Inputs: name (required). Returns: result
crpt_write_methodA
Execute one WRITE endpoint from the catalog: create or update data.
Target API: ГИС МТ и СУЗ «Честный знак» (markirovka.crpt.ru, suzgrid.crpt.ru).
Requires confirm_write=true; nothing is sent without it. Irreversible operations live in crpt_delete_method, reads in crpt_call_method.
Args: operation_id: id from the catalog (see crpt_search_methods). path_values: values for {placeholders} in the path. query: query-string parameters. body: JSON request body. confirm_write: must be true. Returns JSON: {"ok": true, "status", "data"} or the error envelope.
Inputs: operation_id (required), body, query, path_values, +1 more. Returns: result
crpt_write_rawA
Create or update data at ANY path, including paths not in the catalog.
Target API: ГИС МТ и СУЗ «Честный знак» (markirovka.crpt.ru, suzgrid.crpt.ru).
POST, PUT and PATCH only; requires confirm_write=true.
Args: method: POST, PUT or PATCH. path: full path beginning with '/'. host: host override; defaults to the service's default host. query: query-string parameters. body: JSON request body. confirm_write: must be true. Returns JSON: {"ok": true, "status", "data"} or the error envelope.
Inputs: path (required), method (required), body, host, +2 more. Returns: result
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 18 tools
Each tool has a clearly distinct role: catalog discovery (describe, list sections, get section, search, map), execution (read, write, delete via catalog or raw path, fetch all), and credential/cabinet management (check, list, add, set key, use, remove). Though several tools browse the catalog, their inputs and outputs are differentiated well enough that an agent should not confuse them.
All tool names share the consistent crpt_ prefix and a snake_case verb_noun pattern (list_sections, get_section, search_methods, call_method, add_cabinet, remove_cabinet). The only slightly off-pattern name is crpt_map, but it still fits the discoverability theme and does not break overall consistency.
At 18 tools the server is on the heavier side, but each tool serves a distinct purpose across catalog introspection, generic API execution, raw-path fallback, pagination, and credential management. This is slightly above the ideal 3-15 range but remains justified for the server's broad scope.
The tool surface covers the full workflow: discovering endpoints, invoking reads/writes/deletes safely, bypassing catalog gaps via raw calls, fetching large result sets, and managing multiple credential cabinets. There are no obvious dead ends for the stated purpose of working with the Честный знак API.
Maintenance
Related MCP Connectors
Russian docs for AI agents: invoices/acts PDF, document parsing, INN checks, medical ad checks
Russian APIs for AI agents: YooKassa, CDEK, Bitrix24 and more. Ready scenarios with code. No key.
Russian company lookup (EGRUL/INN), Cyrillic search, RU page to Markdown. Pay per call in USDC.
RU INN/OGRN, banks, geo, WHOIS. Agent self-registers via register_agent. 20 free/day.
Related MCP Servers
- FlicenseAqualityDmaintenanceMCP server for Russia's Chestnyi Znak product labelling system, allowing AI assistants to query marking codes, documents, warehouse balances, and participant data via natural language.1044 npm4-
- AlicenseAqualityBmaintenanceEnables Russian product marking verification via Chestny ZNAK/CRPT APIs, including authenticity checks, product details, batch checks, and authorized GTIN/CIS lookups.564 npm5MIT
- AlicenseAqualityBmaintenanceSBIS (Saby) API for AI assistants: documents and their workflow stages, electronic signature, certificates, employees and organizations. 45 methods, each with a read/write/destructive safety class.186MIT
- AlicenseAqualityBmaintenanceKontur Diadoc API for AI assistants: legally significant document exchange, signing, counteragents, machine-readable powers of attorney and docflow status. 114 methods, each with a read/write/destructive safety class.184MIT