1. Conduid
  2. Finance
  3. Chestnyi Znak MCP Server
MCP server · Finance

Chestnyi Znak MCP Server

by · github.com/woyaxnini/mcp-chestnyi-znak

MCP server for Chestnyi Znak — Russian product marking system. 10 tools: codes, documents, stocks.

Unclaimed last commit 6 months ago finance
InstallView source
37Low

Scored 6 months ago · breakdown

About Chestnyi Znak MCP Server

Chestnyi Znak MCP Server is an MCP server published by woyaxnini in the Finance category: mCP server for Chestnyi Znak — Russian product marking system. 10 tools: codes, documents, stocks.

The repository has 3 stars and 1 forks, with the last commit 6 months ago. Six months or more without a commit doesn't mean the server is broken, but check the open issues before depending on it in production.

Install

Claude Code
claude mcp add chestnyi-znak-mcp-server -- npx -y @woyax/mcp-chestnyi-znak
npx
npx -y @woyax/mcp-chestnyi-znak

This server has no ConduID identity, so agent calls to it are not receipted. Pin the version you install and review the source before granting it credentials.

Tools (6)

chz_cis_infoGet public info for a list of CIS codes

Parameters not published.

chz_cis_searchSearch marking codes by filter criteria

Parameters not published.

chz_doc_cis_listList marking codes included in a document

Parameters not published.

chz_doc_infoGet details of a specific document by ID

Parameters not published.

chz_doc_listList documents for a product group

Parameters not published.

chz_product_infoGet product card by GTIN

Parameters not published.

Ask AI

✦

Ask AI about Chestnyi Znak MCP Server

Powered by Claude · Grounded in docs

I know everything about Chestnyi Znak MCP Server. Ask me about installation, configuration, usage, or troubleshooting.

Security checks

  • ✓README presentThe repository ships documentation.

5 checks have not been run yet.

README

@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:

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

Production:

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

CHZ_ENV defaults to "prod" if not set.

Important: the token file and the CHZ_ENV value 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.

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.

README copy captured when this server was indexed; it may lag the repository. The original is authoritative.

Questions

About Chestnyi Znak MCP Server

How do I install Chestnyi Znak MCP Server?

Run claude mcp add chestnyi-znak-mcp-server -- npx -y @woyax/mcp-chestnyi-znak, then add the server to your MCP client's configuration.

Is Chestnyi Znak MCP Server safe to use with an AI agent?

Its trust score is 37 out of 100 (low). It passes 1 of the 1 static security checks run so far. It has no ConduID identity yet, so agent calls to it are not receipted.

Is Chestnyi Znak MCP Server still maintained?

The last commit was 6 months ago. That's long enough that you should check whether the maintainer is responding to issues before depending on it.