{
  "markdown": "# @woyax/mcp-chestnyi-znak\n\n[![License: MIT + Commons Clause](https://img.shields.io/badge/license-MIT%20%2B%20Commons%20Clause-blue.svg)](./LICENSE)\n\nMCP server for **Chestnyi Znak** (Честный Знак) — Russia's national product labelling system (True API).\n\nEnables AI assistants (Claude, Cursor, etc.) to query marking codes, documents, warehouse balances, and participant data directly via natural language.\n\n> **First MCP server for Chestnyi Znak True API.**\n\n---\n\n## Tools (10 total)\n\n### Documents & Marking Codes\n\n| Tool | Description |\n|------|-------------|\n| `chz_doc_list` | List documents for a product group |\n| `chz_doc_info` | Get details of a specific document by ID |\n| `chz_doc_cis_list` | List marking codes included in a document |\n| `chz_cis_search` | Search marking codes by filter criteria |\n| `chz_cis_info` | Get public info for a list of CIS codes |\n| `chz_product_info` | Get product card by GTIN |\n\n### Balance & Reference\n\n| Tool | Description |\n|------|-------------|\n| `chz_balance_all` | Balance of marking codes across all product groups |\n| `chz_warehouse_balance` | Virtual warehouse balance for a product group |\n| `chz_participant_check` | Check company registration status by INN |\n| `chz_receipt_list` | List withdrawal receipts for a product group |\n\n> Development of new tools is ongoing.\n\n---\n\n## Getting a Token\n\nThis server requires a JWT token from your Chestnyi Znak personal account. Token acquisition involves GOST cryptography (КриптоПро + УКЭП) and is **outside the scope of this package**.\n\nToken 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.\n\n**Token lifetime:** ~8–12 hours. Update the file when it expires — the server picks it up automatically without restart.\n\n---\n\n## Installation & Configuration\n\n### Claude Desktop\n\nAdd to your `claude_desktop_config.json`:\n\n**Sandbox:**\n```json\n{\n  \"mcpServers\": {\n    \"chestnyi-znak\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@woyax/mcp-chestnyi-znak\"],\n      \"env\": {\n        \"CHZ_TOKEN_FILE\": \"/path/to/your/token\",\n        \"CHZ_ENV\": \"sandbox\"\n      }\n    }\n  }\n}\n```\n\n**Production:**\n```json\n{\n  \"mcpServers\": {\n    \"chestnyi-znak\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@woyax/mcp-chestnyi-znak\"],\n      \"env\": {\n        \"CHZ_TOKEN_FILE\": \"/path/to/your/token\"\n      }\n    }\n  }\n}\n```\n\n`CHZ_ENV` defaults to `\"prod\"` if not set.\n\n> **Important:** the token file and the `CHZ_ENV` value must match — a sandbox token won't work on the production endpoint and vice versa.\n\n---\n\n## Environment Variables\n\n| Variable | Required | Default | Description |\n|----------|----------|---------|-------------|\n| `CHZ_TOKEN_FILE` | **Yes** | — | Absolute path to file containing the JWT token |\n| `CHZ_ENV` | No | `prod` | Contour: `sandbox` or `prod` |\n\n---\n\n\n## Author & Support\n\nBuilt by [Oleg Alekseev](https://github.com/woyaxnini) — ERP/AI integration architect.\n\n- 📧 [woyaxnini@gmail.com](mailto:woyaxnini@gmail.com) · [woyax@yandex.com](mailto:woyax@yandex.com)\n- 💬 Telegram: [@ale_oleg](https://t.me/ale_oleg) · Channel: [@woyax_ai](https://t.me/woyax_ai)\n- 💬 MAX: [max.ru/id503610654564_biz](https://max.ru/id503610654564_biz)\n\nNeed help integrating AI agents with your ERP, CRM, or Chestnyi Znak? Custom MCP servers, n8n workflows, AI automation — [contact me](mailto:woyaxnini@gmail.com).\n\n---\n\n## License\n\nMIT + Commons Clause © [Oleg Alekseev](https://github.com/woyaxnini)\n\nFree to use for personal and corporate purposes. Selling as a hosted service requires author's permission. See [LICENSE](./LICENSE) for details.\n",
  "bytes": 3979,
  "sha": "f8348c0a1c4dfddc35d6f0a3481063f6e1c84f2c5d33f6bcf6708ed0824e006d",
  "repo_slug": "woyaxnini/mcp-chestnyi-znak",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_woyaxnini_chestnyi_znak_80234b2b/readme"
}