# chestnyznak-mcp

Inspects Chestny ZNAK product identification codes and queries True API directly inside your AI workflow. Basic verification runs without registration or tokens.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 5
- Author: theYahia
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/theYahia/chestnyznak-mcp
- Updated: 2026-09-02
- HTML: https://affpapa.org/en/nevibecode/mcp/chestnyznak-mcp

## What it does

The server introduces five tools designed for Russia's digital track-and-trace registry. Three functions run publicly without credentials: single-item verification for DataMatrix, QR, or EAN-13, detailed ownership lookups, and batch validation for up to 50 items. These operations rely on the mobile client endpoint.

Querying GTIN records or CIS status calls True API directly and mandates a valid `CHESTNYZNAK_TOKEN`. The server lacks built-in GOST signature generation: UKEP digital signing must happen externally beforehand, and issued bearer tokens expire in roughly 10 hours.

Public endpoint requests frequently time out when sent from non-Russian IP addresses. Beside default stdio operation, the package runs as a local HTTP service via `--http`, though exposing `/mcp` leaves the endpoint without native authentication.

## Requirements
- Needs: Node.js (commands run via npx)
- Environment variables: `API_KEY` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add chestnyznak-mcp -e API_KEY=<API_KEY> -- npx -y @theyahia/chestnyznak-mcp
```
Replace <…> with your own values

### Codex

**Platform CLI**
```bash
codex mcp add chestnyznak-mcp --env API_KEY=<API_KEY> -- npx -y @theyahia/chestnyznak-mcp
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "chestnyznak-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "@theyahia/chestnyznak-mcp"
            ],
            "env": {
                "API_KEY": "<API_KEY>"
            }
        }
    }
}
```
Replace <…> with your own values

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "chestnyznak-mcp": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@theyahia/chestnyznak-mcp"
            ],
            "env": {
                "API_KEY": "<API_KEY>"
            }
        }
    }
}
```
Replace <…> with your own values

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add -e API_KEY=<API_KEY> chestnyznak-mcp npx -y @theyahia/chestnyznak-mcp
```
Replace <…> with your own values

## When to use it
- verify legitimacy and lifecycle status of DataMatrix markings
- look up product category, manufacturer, and current owner by code
- run batch validation on up to 50 product identifiers at once
- retrieve product catalog records by GTIN via True API

## Example prompts
- Check the status of marking code 0104600702028445
- Retrieve manufacturer and ownership info for code 010460070202844521
- Verify this batch of codes: 0104600702028445, 0104600702028446

## Similar
- [MCP Toolbox for Databases](https://affpapa.org/en/nevibecode/mcp/googleapis-mcp-toolbox-for-databases.md) — MCP server · ★ 16730
- [PostHog MCP Server](https://affpapa.org/en/nevibecode/mcp/posthog-mcp-server.md) — MCP server · ★ 40459
- [OpenWork MCP Gateway](https://affpapa.org/en/nevibecode/mcp/openwork-mcp-gateway.md) — MCP server · ★ 24271
- [Keploy](https://affpapa.org/en/nevibecode/mcp/keploy.md) — MCP server · ★ 18779
- [Nhost](https://affpapa.org/en/nevibecode/mcp/nhost.md) — MCP server · ★ 9369
- [basebalance.cloud — x402 RPC & MCP gateway](https://affpapa.org/en/nevibecode/mcp/basebalancecloud-x402-rpc-mcp-gateway.md) — MCP server · ★ 7548

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md