Chestnyi Znak MCP server
@woyax/mcp-chestnyi-znak
MCP server for the Chestnyi Znak True API: documents, marking codes, balances and participant checks by INN
- 3 ★ on the repository
- Last commit
Extended access
Why this level
- Requires a JWT token for the company's labelling system account
- Network calls to an API with the company's product and document data
Install
- Works in
- Services
In your terminal, with SkillFoxx CLI
npx skillfoxx add mcp/woyax-mcp-chestnyi-znakDetects the agents on your machine, shows the access level and pins the version.
Other ways to install
Access and checks
How we reviewExtended accessThe tool runs code or makes network calls and only reads external data.
- Requires a JWT token for the company's labelling system account
- Network calls to an API with the company's product and document data
This is third-party code. Review the repository files before installing.
What it does
Gives an agent 10 tools for the Chestnyi Znak national product labelling system. It can list documents and their contents, search marking codes, look up product cards by GTIN, check code and virtual warehouse balances, verify company registration by INN and list withdrawal receipts. It supports both sandbox and production.
Who it is for. Companies and integrators handling labelled goods and ERP systems such as 1C.
Good fit when
- Quickly check a marking code status or document contents
- Reconcile code balances by product group
- Check a counterparty in the labelling system by INN
Not a fit when
- You have no way to obtain the JWT token with CryptoPro and a qualified signature
- You need to create and sign documents: current tools only read data
Example request
Show recent documents for the footwear product group and check whether the company with INN 7700000000 is registeredMCP
- Transport
- stdio
- Authentication
- API key
Environment variables
CHZ_TOKEN_FILErequired- Absolute path to the file with the JWT token
CHZ_ENV- Environment: sandbox or prod, default prod
Limitations
Obtaining the JWT token requires GOST cryptography and is out of scope. The token lasts about 8 to 12 hours and must be refreshed in the file; the server picks it up without restart. Sandbox tokens do not work in production and vice versa. Version 0.1.0, with more tools in progress. License is MIT + Commons Clause.
How to disable. Remove the chestnyi-znak block from mcpServers in the client config and delete the token file.
FAQ
How do I get the token?
Via a GOST signature (CryptoPro and a qualified signature), manually in the web UI or through automation. This is outside the package.
Do I restart after refreshing the token?
No, update the file and the server picks up the new token automatically.
How is the Chestny Znak MCP server different from the Chestny Znak personal account?
The server gives the agent 10 True API tools for the labeling system: a document list and contents, labeling code search, a product card by GTIN, code balances and participant checks by INN.
How do I get a token and do I need to restart the server after an update?
The token is issued for your True API access in the Chestny Znak system. After changing the token restart the client so the server picks up the new value. The npx config is in the install block, it works in Claude Desktop and Cursor.
Discussion
No questions or reviews yet.
Related
All Chestny Znak toolsChestny Znak MCP server
chestnyznak-mcp
An MCP server for Chestny Znak product marking: public code checks with no token and True API data with one
Chestny Znak MCP: marking codes and emission
chestny-znak-mcp-ru
An MCP server for the Chestny Znak GIS MT and SUZ systems with 33 methods: marking code checks, emission, application reports and product routes by GTIN
Local MCP server for product search, cart and delivery with Pyaterochka
MCP server for the CDEK API: tariff quotes, pickup point search, tracking, order creation, courier pickup and waybill printing
A monorepo of MCP servers for Russian and CIS APIs: payments, CRM, marketplaces, delivery, HR and reference data
htmlweb.ru MCP: lookups, checks and payments
htmlweb.ru MCP Server
A remote MCP server for htmlweb.ru with dozens of methods: INN checks, geodata, calendar, validators, plus card binding and charges
README in short
The server connects AI assistants to the Chestnyi Znak True API. Tools are split into documents and marking codes and into balances and reference data. The README states clearly that obtaining the token via CryptoPro is a separate integration task. It includes sandbox and production configs and environment variables.