woyaxnini avatar

Chestnyi Znak MCP Server

woyaxnini/mcp-chestnyi-znak

Connects Claude to Russia's Chestnyi Znak product marking system via the True API. You get 10 tools covering document retrieval, marking code search and validation, warehouse balance queries, participant verification by INN, and product card lookup by GTIN. Requires a JWT token from your Chestnyi Znak account, which involves GOST cryptography and is handled separately. Token lives in a file that the server watches, so you can refresh it without restarting. Supports both sandbox and production environments. If you're building ERP integrations or need to automate compliance workflows around Russian product labeling, this gives your AI assistant direct access to the official registry.

GitHub stars
1
tools
10
auth
Secret needed
transport
STDIO
env var
1
last updated
Apr 17, 2026

Tools

10 tools

Public tool metadata for what this MCP can expose to an agent.

chz_doc_listList documents for a product group

List documents for a product group

No parameter schema in public metadata yet.

chz_doc_infoGet details of a specific document by ID

Get details of a specific document by ID

No parameter schema in public metadata yet.

chz_doc_cis_listList marking codes included in a document

List marking codes included in a document

No parameter schema in public metadata yet.

chz_cis_searchSearch marking codes by filter criteria

Search marking codes by filter criteria

No parameter schema in public metadata yet.

chz_cis_infoGet public info for a list of CIS codes

Get public info for a list of CIS codes

No parameter schema in public metadata yet.

chz_product_infoGet product card by GTIN

Get product card by GTIN

No parameter schema in public metadata yet.

chz_balance_allBalance of marking codes across all product groups

Balance of marking codes across all product groups

No parameter schema in public metadata yet.

chz_warehouse_balanceVirtual warehouse balance for a product group

Virtual warehouse balance for a product group

No parameter schema in public metadata yet.

chz_participant_checkCheck company registration status by INN

Check company registration status by INN

No parameter schema in public metadata yet.

chz_receipt_listList withdrawal receipts for a product group

List withdrawal receipts for a product group

No parameter schema in public metadata yet.

Sponsors

Configuration

CHZ_TOKEN*secret

Chestnyi Znak API token. Obtain in your personal cabinet at markirovka.crpt.ru. IMPORTANT: token expires every 8–10 hours and must be refreshed.

Readme

@woyax/mcp-chestnyi-znak

License: MIT + Commons Clause

MCP server for Chestnyi Znak (Честный Знак) — Russia's national product labelling system (True API).

Enables AI assistants (Claude, Cursor, etc.) to query marking codes, documents, warehouse balances, and participant data directly via natural language.

First MCP server for Chestnyi Znak True API.


Tools (10 total)

Documents & Marking Codes

ToolDescription
chz_doc_listList documents for a product group
chz_doc_infoGet details of a specific document by ID
chz_doc_cis_listList marking codes included in a document
chz_cis_searchSearch marking codes by filter criteria
chz_cis_infoGet public info for a list of CIS codes
chz_product_infoGet product card by GTIN

Balance & Reference


View the full README on GitHub

Details

Repository
github.com/woyaxnini/mcp-chestnyi-znak
Package
@woyax/mcp-chestnyi-znak
Transport
STDIO
Auth
Required
Registry
MCP registry, active

More from woyaxnini