Kontur.Diadoc MCP
kontur-diadoc-mcp
MCP server for Kontur.Diadoc EDI: organization lookup by INN, document lists and contents, sending and signing
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 monthLimitations
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 | |
|---|---|
| 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.
Related
Microsoft's utility and MCP server that turn PDF, Word, Excel, PowerPoint, HTML and other files into Markdown for models
Anthropic skills
Skills
Anthropic's official skill examples: docx, pdf, pptx and xlsx documents, design, MCP builder and the Agent Skills spec
A skill that builds editable PPTX decks from PDF, DOCX, URLs and Markdown with native shapes, charts and animations
Anthropic's legal plugin suite: contracts, privacy, employment, IP, litigation, AI governance and legal education