Chestnyi Znak MCP server

Install

{
  "mcpServers": {
    "chestnyi-znak": {
      "command": "npx",
      "args": ["-y", "@woyax/mcp-chestnyi-znak"],
      "env": {
        "CHZ_TOKEN_FILE": "/path/to/your/token"
      }
    }
  }
}

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.

Example request

Show recent documents for the footwear product group and check whether the company with INN 7700000000 is registered

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.

MCP

Transport

stdio

Authentication

API key

Security check

• Requires a JWT token for the company's labelling system account
• Network calls to an API with the company's product and document data

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.

Related