Kontur.Diadoc MCP

kontur-diadoc-mcp

MCP server for Kontur.Diadoc EDI: organization lookup by INN, document lists and contents, sending and signing

MCP serverHigh riskRussian stack

theyahia/kontur-diadoc-mcp

Install

{
  "mcpServers": {
    "kontur-diadoc": {
      "command": "npx",
      "args": ["-y", "@theyahia/kontur-diadoc-mcp"],
      "env": {
        "DIADOC_API_CLIENT_ID": "<YOUR_DEVELOPER_KEY>",
        "DIADOC_LOGIN": "<YOUR_LOGIN>",
        "DIADOC_PASSWORD": "<YOUR_PASSWORD>"
      }
    }
  }
}

The same block works for Cline and Cursor.

This is third-party code. Review the repository files before installing.

What it does

The server connects the agent to the Diadoc API. The agent looks up organizations and counterparties by INN and KPP, lists documents in a box with type and status filters, opens a specific document, sends documents to a counterparty and signs incoming ones. The server does not create the qualified signature itself: it must be produced separately, for example with CryptoPro, and passed as base64, while the sandbox accepts a test signature. Dates are given in ISO and converted to the API format, and errors come back as text without dropping the session.

Who it is for. For accountants, lawyers and integration developers whose company exchanges documents via Diadoc.

Good fit when

  • You need unsigned incoming UPDs for the month
  • You need to check a counterparty in Diadoc by INN
  • You want to explore the Diadoc API on the sandbox before building an integration

Not a fit when

  • You need to sign with a qualified signature without a separate crypto provider
  • The Diadoc account login and password must not be stored in the agent config

Example request

Show incoming unsigned documents for this month

Limitations

Requires a Kontur developer key plus Diadoc account login and password. The client produces the real signature and the server only passes it on. For experiments request sandbox access and set its host. Pagination is cursor-based. The tool count in the README text and table differs. Community project, not a Kontur product.

How to disable. Delete the kontur-diadoc block from the MCP client config and change the Diadoc account password if it was stored there.

MCP

Transport
stdio
Authentication
API key
Environment variables
Environment variables
DIADOC_API_CLIENT_ID
required, secret
Kontur developer key
DIADOC_LOGIN
required
Diadoc account login
DIADOC_PASSWORD
required, secret
Diadoc account password
DIADOC_BASE_URL
Alternative API host, such as the sandbox

Security check

  • Sends and signs legally binding documents
  • Stores the Diadoc account login and password

README in short

The Russian and English README has a tool table with key parameters, an npx config for Claude Desktop, Cline and Cursor, and an environment variable table. It explains how to get access, including the sandbox, and core API concepts: box, category filter, cursor pagination, .NET tick timestamps. A separate section covers signing limits and error handling with retries. MIT license.

FAQ

Can the server sign a document on its own?

No. The Diadoc API does not create cryptographic signatures. The signature is made client-side and passed in signature_base64; the test signature works only in the sandbox.

Where do I get a developer key?

On the Kontur developer portal after registering an application.

Editors’ pick

Microsoft's utility and MCP server that turn PDF, Word, Excel, PowerPoint, HTML and other files into Markdown for models

MCP serverMedium risk184K
Editors’ pick

Anthropic's official skill examples: docx, pdf, pptx and xlsx documents, design, MCP builder and the Agent Skills spec

SkillMedium risk176.3K
Editors’ pick

A skill that builds editable PPTX decks from PDF, DOCX, URLs and Markdown with native shapes, charts and animations

SkillMedium risk54.4K
Editors’ pick

Anthropic's legal plugin suite: contracts, privacy, employment, IP, litigation, AI governance and legal education

PluginMedium risk9.4K