MCP server for Chestnyi Znak β Russian product marking system. 10 tools: codes, documents, stocks.
Quick Install
Automated & IDE SetupCopy the AI prompt to install this server into Claude Code, Cursor, or another agent β or use 1-click editor setup below.
Manual Client & Custom JSON ConfigExpand JSON βΎ
Client Config & Setup
Choose your client or environment
Target File:
π‘ Paste the JSON block into your client's configuration file under mcpServers, then restart the application.
Documentation Overview
@woyax/mcp-chestnyi-znak
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
| Tool | Description |
|---|---|
chz_doc_list | List documents for a product group |
chz_doc_info | Get details of a specific document by ID |
chz_doc_cis_list | List marking codes included in a document |
chz_cis_search | Search marking codes by filter criteria |
chz_cis_info | Get public info for a list of CIS codes |
chz_product_info | Get product card by GTIN |
Balance & Reference
| Tool | Description |
|---|---|
chz_balance_all | Balance of marking codes across all product groups |
chz_warehouse_balance | Virtual warehouse balance for a product group |
chz_participant_check | Check company registration status by INN |
chz_receipt_list | List withdrawal receipts for a product group |
Development of new tools is ongoing.
Getting a Token
This server requires a JWT token from your Chestnyi Znak personal account. Token acquisition involves GOST cryptography (ΠΡΠΈΠΏΡΠΎΠΡΠΎ + Π£ΠΠΠ) and is outside the scope of this package.
Token retrieval can be automated β using a local ΠΡΠΈΠΏΡΠΎΠΡΠΎ script, a signing microservice, USB-over-IP with a hardware token, or a cloud HSM. It can also be done manually via the Chestnyi Znak web interface. The right approach depends on your infrastructure, OS, certificate type, and security requirements. Because the options and constraints vary significantly from case to case, this is treated as a separate integration task. We handle this kind of setup as well β feel free to reach out.
Token lifetime: ~8β12 hours. Update the file when it expires β the server picks it up automatically without restart.
Installation & Configuration
Claude Desktop
Add to your claude_desktop_config.json:
Sandbox:
Production:
CHZ_ENV defaults to "prod" if not set.
Important: the token file and the
CHZ_ENVvalue must match β a sandbox token won't work on the production endpoint and vice versa.
Environment Variables
| Variable | Required | Default | Description |
|---|---|---|---|
CHZ_TOKEN_FILE | Yes | β | Absolute path to file containing the JWT token |
CHZ_ENV | No | prod | Contour: sandbox or prod |
Author & Support
Built by Oleg Alekseev β ERP/AI integration architect.
- π§ woyaxnini@gmail.com Β· woyax@yandex.com
- π¬ Telegram: @ale_oleg Β· Channel: @woyax_ai
- π¬ MAX: max.ru/id503610654564_biz
Need help integrating AI agents with your ERP, CRM, or Chestnyi Znak? Custom MCP servers, n8n workflows, AI automation β contact me.
License
MIT + Commons Clause Β© Oleg Alekseev
Free to use for personal and corporate purposes. Selling as a hosted service requires author's permission. See LICENSE for details.
Related MCP Servers
Reviews
No reviews yet β be the first to share how this listing worked for you.
Frequently Asked Questions about Chestnyi Znak MCP Server
AllMCPs Directory Badge
Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.
Badge Style:
Live Dynamic SVG Preview
Markdown (GitHub README)
[](https://allmcps.com/mcp/chestnyi-znak-mcp-server)HTML Embed
<a href="https://allmcps.com/mcp/chestnyi-znak-mcp-server"><img src="https://allmcps.com/api/badge/chestnyi-znak-mcp-server?style=directory" alt="Chestnyi Znak MCP Server on AllMCPs" /></a>Technical Specs & Signals
CategoryDeveloper Tools
27Quality signal: Emerging Β· 27/100How this signal is calculated βΎ
Server availabilityNot measured
Not scored for repo-hosted servers β we can't reach the running server, only its GitHub page. Hosted MCP endpoints are health-checked live.
Verified ownership8/20
Documentation & tools11/30
Adoption & activity1/15
Community engagement0/10
A guidance signal from public completeness & health data β not a user rating. New listings start lower and rise as they add docs, get verified, and grow adoption. Signals we can't observe for a listing are skipped, not counted against it.
Own this project?
This directory is pre-filled from public sources. Claim via GitHub README, site badge, or DNS TXT to unlock edit access and the Official badge and attach your website β proof is checked automatically, then reviewed by our team.
Free dofollow backlink: add your website and place the AllMCPs badge on it β no claim needed. We detect it automatically and keep it verified as long as the badge stays live.
Claim & get free dofollowShare & Embed
Add our SVG badge (dark/light directory styles) or embeddable widget to your site.