Chestnyznak Mcp

io.github.theYahiaPublished by GitHub account theYahiav1.0.0Updated Nov 3, 2026

MCP server for Chestniy ZNAK (Честный ЗНАК) API — product marking verification. No auth needed for

VerifiedSTDIODesktop onlyWeb Search & ScrapingBusiness & Commerce

Overview

AI-generated overview

MCP server for Russia's Chestny ZNAK (Честный ЗНАК) marking system that lets an assistant look up DataMatrix, QR or EAN-13 codes and product data.

What you can do
  • Check a marking code for validity and status, and get product details such as name, category, producer and owner
  • Run batch checks of up to 50 codes at once with limited parallelism
  • Look up product information by GTIN and identification-code (CIS) details through the authorized True API when a token is supplied
  • Return typed structured content alongside the text JSON for each tool
When to use it
Useful when you want to verify Russian product marking codes or inspect a product's marking status and owner from a chat instead of the Chestny ZNAK web cabinet. The public checks work without registration; the True API lookups need a token you obtained yourself.
Requirements
Runs locally via npx (Node.js). Public tools need no credentials. The search_products and get_cis_info tools need a True API token in CHESTNYZNAK_TOKEN, obtained outside the server by signing with a UKEP certificate. Optional CHESTNYZNAK_BASE_URL and CHESTNYZNAK_PUBLIC_BASE_URL overrides. Network access to crpt.ru; the public API may not respond from non-Russian IPs.
Before you install
The token in CHESTNYZNAK_TOKEN is a bearer credential valid for roughly 10 hours and must be obtained by signing with a UKEP certificate outside this server. The authorized endpoints are documented but reportedly untested against a live token. The public check uses an undocumented mobile-app endpoint. An optional HTTP mode has no authentication on /mcp, and exposing it beyond localhost is at your own risk.

Installation

In SourceWeft

  1. Open Chestnyznak Mcp in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

MCP-сервер для Честного Знака — проверка маркировки товаров через ИИ

Если вы искали, как проверить код маркировки Честного Знака не заходя в личный кабинет, подключить True API ЦРПТ к нейросети или узнать статус товара прямо в чате — это оно. 5 инструментов: публичные проверки кодов работают сразу, без регистрации и токена; данные True API — по токену. Присылаете код DataMatrix — получаете статус, владельца и историю вместо вкладки с формой.

[npm] [License: MIT]

Часть серии WWmcp (46 серверов) by @theYahia.

Установка

Claude Desktop

json
{  "mcpServers": {    "chestnyznak": {      "command": "npx",      "args": ["-y", "@theyahia/chestnyznak-mcp"]    }  }}

Claude Desktop (с авторизацией)

json
{  "mcpServers": {    "chestnyznak": {      "command": "npx",      "args": ["-y", "@theyahia/chestnyznak-mcp"],      "env": {        "CHESTNYZNAK_TOKEN": "ваш-токен"      }    }  }}

Claude Code

bash
claude mcp add chestnyznak -- npx -y @theyahia/chestnyznak-mcp
# С авторизациейCHESTNYZNAK_TOKEN=ваш-токен claude mcp add chestnyznak -- npx -y @theyahia/chestnyznak-mcp

Streamable HTTP

bash
npx @theyahia/chestnyznak-mcp --http --port=3000# Endpoint: POST http://127.0.0.1:3000/mcp# Health:   GET  http://127.0.0.1:3000/health

По умолчанию HTTP-сервер слушает только 127.0.0.1 и проверяет заголовок Host (защита от DNS-rebinding). Чтобы открыть наружу — --host=0.0.0.0 (на свой риск, аутентификации на /mcp нет).

Переменные окружения

ПеременнаяОбязательнаОписание
CHESTNYZNAK_TOKENНетТокен True API для инструментов search_products, get_cis_info. См. «Авторизация».
CHESTNYZNAK_BASE_URLНетOrigin авторизованного API (по умолчанию https://markirovka.crpt.ru). Допускаются только https хосты *.crpt.ru / *.crptech.ru.
CHESTNYZNAK_PUBLIC_BASE_URLНетБазовый URL публичного API (по умолчанию https://mobile.api.crpt.ru/mobile). Удобно для моков в тестах.

Инструменты (5)

Публичные (без авторизации)

ИнструментАргументыОписание
check_marking_codecode, codeType?Проверка подлинности по коду маркировки
get_product_infocode, codeType?Подробная информация: название, группа, производитель, владелец
check_batchcodes[], codeType?Пакетная проверка до 50 кодов (параллелизм ограничен)

codeType — datamatrix (по умолчанию), qr или ean13.

Авторизованные (CHESTNYZNAK_TOKEN)

ИнструментАргументыОписание
search_productsquery (GTIN)Информация о товаре по GTIN из True API
get_cis_infocisИнформация о CIS (коде идентификации) из True API

Поиск по названию/бренду — это Национальный каталог (nk.crpt.ru), отдельный API; здесь не поддерживается. search_products работает по GTIN.

Формат ответа

check_marking_code:

json
{ "code": "0104600702028445", "found": true, "valid": true, "status": "INTRODUCED" }

get_product_info (поля producer/owner/status берутся из вложенного объекта группы товара, при отсутствии — null):

json
{  "code": "0104600702028445",  "found": true,  "valid": true,  "status": "INTRODUCED",  "productName": "Молоко 3.2%",  "category": "milk",  "producerName": "АО \"Данон Россия\"",  "ownerName": "ООО Магнит",  "ownerInn": "2309085638"}

status — строковый enum: EMITTED / APPLIED / INTRODUCED / RETIRED / WRITTEN_OFF / DISAGGREGATION и др.

Каждый инструмент дополнительно возвращает structuredContent (типизированный объект по outputSchema), помимо текстового JSON.

Примеры

Проверь код маркировки 0104600702028445Расскажи подробнее о товаре с кодом 010460070202844521Проверь пачку кодов: 0104600702028445, 0104600702028446Информация о товаре с GTIN 04600702028445Информация о CIS 0104600702028445

Авторизация (True API)

⚠️ Важно: у True API (ГИС МТ) нет статичного «вечного» токена. Токен получают по схеме «запрос-подпись» сертификатом УКЭП (ГОСТ):

  1. GET /api/v3/true-api/auth/key → { uuid, data }
  2. Подписать data сертификатом УКЭП (CAdES-BES, base64).
  3. POST /api/v3/true-api/auth/simpleSignIn { uuid, data: <подпись> } → токен.
  4. Срок жизни токена — не более ~10 часов, далее повторная авторизация.

Этот сервер использует CHESTNYZNAK_TOKEN как уже полученный таким образом токен (он отправляется как Authorization: Bearer). Подпись УКЭП выполняется вне сервера (например, через КриптоПро) — встроенного ГОСТ-подписания здесь нет. Регистрация доступна юрлицам/ИП на markirovka.crpt.ru.

Эндпоинты/методы авторизованной части (пути, тело запроса) выверены по официальной документации и открытым клиентам, но не проверены против живого токена из-за требования УКЭП. Если ЦРПТ изменит контракт — поправьте через CHESTNYZNAK_BASE_URL.

Skills

SkillТриггер
skill-check-product«Проверь маркировку товара по коду»
skill-search«Найди товар по GTIN»

Troubleshooting

СимптомПричина / решение
CHESTNYZNAK_TOKEN не заданИнструменты search_products/get_cis_info требуют токен (см. «Авторизация»).
таймаут запроса / все попытки исчерпаныСеть/недоступность API; сервер делает до 3 попыток с backoff. Публичный API может не отвечать с не-РФ IP.
HTTP 401 / HTTP 403Токен невалиден или истёк (~10ч) — получите заново.
HTTP 429Рейт-лимит; сервер повторяет автоматически. Для batch уменьшите размер пачки.
CHESTNYZNAK_BASE_URL отклонёнOverride должен быть https и хостом *.crpt.ru/*.crptech.ru.

API

  • Публичный (без авторизации): GET https://mobile.api.crpt.ru/mobile/check?code=<код>&codeType=<тип> — недокументированный эндпоинт мобильного приложения.
  • Авторизованный (Bearer): https://markirovka.crpt.ru/api/v3/true-api/... — True API (ГИС МТ).

Разработка

bash
npm cinpm run typecheck   # tsc --noEmit (src + tests)npm test            # vitestnpm run build       # tsc -> dist/npm run dev         # tsx watch (stdio)npm run dev:http    # tsx watch (HTTP)

Лицензия

MIT

Часть WWmcp · Telegram: @vhodvai

Source: README.md at commit cb7b731

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v1.0.0LatestSep 16, 2026

Score

50% 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 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • 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