Diadoc MCP: 114 document-flow methods

diadoc-mcp-ru

An MCP server for the Diadoc (Kontur) API: documents, counterparties, signing and power of attorney, with confirmation before writes

MCP serverRussian stack

ilyautov/diadoc-mcp-ruAuthor:Ilya Utov

Install

In your terminal, with SkillFoxx CLI

npx skillfoxx add mcp/diadoc-mcp-ru

Detects the agents on your machine, checks the risk and pins the version.

Other ways to install

This entry is high risk, so there is no one-click install. Review the code and add the config by hand.

Run in a terminal

claude mcp add --transport stdio diadoc-mcp-ru -- uvx diadoc-mcp-ru==0.3.0

Or add to the file .mcp.json, in the project

{
  "mcpServers": {
    "diadoc-mcp-ru": {
      "command": "uvx",
      "args": [
        "diadoc-mcp-ru==0.3.0"
      ]
    }
  }
}

If the file already exists, add the server inside the mcpServers key.

Keys and settings

DIADOC_CLIENT_IDoptional: Идентификатор приложения Диадок, выдаёт Контур.
DIADOC_TOKENsecret, optional: Токен пользователя Диадок, выдаёт метод Authenticate.

Replace the values in angle brackets with your own. Keys never go into install links and are not stored by us.

Add to the file ~/.cursor/mcp.json, for all projects

{
  "mcpServers": {
    "diadoc-mcp-ru": {
      "command": "uvx",
      "args": [
        "diadoc-mcp-ru==0.3.0"
      ]
    }
  }
}

If the file already exists, add the server inside the mcpServers key. For a single project, put the same block into .cursor/mcp.json.

Keys and settings

DIADOC_CLIENT_IDoptional: Идентификатор приложения Диадок, выдаёт Контур.
DIADOC_TOKENsecret, optional: Токен пользователя Диадок, выдаёт метод Authenticate.

Replace the values in angle brackets with your own. Keys never go into install links and are not stored by us.

Run in a terminal

code --add-mcp '{"name":"diadoc-mcp-ru","type":"stdio","command":"uvx","args":["diadoc-mcp-ru==0.3.0"]}'

Or add to the file .vscode/mcp.json, in the project

{
  "servers": {
    "diadoc-mcp-ru": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "diadoc-mcp-ru==0.3.0"
      ]
    }
  }
}

If the file already exists, add the server inside the servers key.

Keys and settings

DIADOC_CLIENT_IDoptional: Идентификатор приложения Диадок, выдаёт Контур.
DIADOC_TOKENsecret, optional: Токен пользователя Диадок, выдаёт метод Authenticate.

Replace the values in angle brackets with your own. Keys never go into install links and are not stored by us.

Run in a terminal

codex mcp add diadoc-mcp-ru -- uvx diadoc-mcp-ru==0.3.0

Or add to the file ~/.codex/config.toml, for all projects

[mcp_servers.diadoc-mcp-ru]
command = "uvx"
args = ["diadoc-mcp-ru==0.3.0"]

If the file already exists, append the block to the end.

Keys and settings

DIADOC_CLIENT_IDoptional: Идентификатор приложения Диадок, выдаёт Контур.
DIADOC_TOKENsecret, optional: Токен пользователя Диадок, выдаёт метод Authenticate.

Replace the values in angle brackets with your own. Keys never go into install links and are not stored by us.

Run in a terminal

gemini mcp add -s user diadoc-mcp-ru uvx diadoc-mcp-ru==0.3.0

Or add to the file ~/.gemini/settings.json, for all projects

{
  "mcpServers": {
    "diadoc-mcp-ru": {
      "command": "uvx",
      "args": [
        "diadoc-mcp-ru==0.3.0"
      ]
    }
  }
}

If the file already exists, add the server inside the mcpServers key.

Keys and settings

DIADOC_CLIENT_IDoptional: Идентификатор приложения Диадок, выдаёт Контур.
DIADOC_TOKENsecret, optional: Токен пользователя Диадок, выдаёт метод Authenticate.

Replace the values in angle brackets with your own. Keys never go into install links and are not stored by us.

Add to the file ~/.config/devin/mcp_config.json, for all projects

{
  "mcpServers": {
    "diadoc-mcp-ru": {
      "command": "uvx",
      "args": [
        "diadoc-mcp-ru==0.3.0"
      ]
    }
  }
}

If the file already exists, add the server inside the mcpServers key. Legacy Cascade keeps the MCP config in ~/.codeium/windsurf/mcp_config.json.

Keys and settings

DIADOC_CLIENT_IDoptional: Идентификатор приложения Диадок, выдаёт Контур.
DIADOC_TOKENsecret, optional: Токен пользователя Диадок, выдаёт метод Authenticate.

Replace the values in angle brackets with your own. Keys never go into install links and are not stored by us.

Formerly Windsurf.

Add to the file cline_mcp_settings.json, for all projects

{
  "mcpServers": {
    "diadoc-mcp-ru": {
      "command": "uvx",
      "args": [
        "diadoc-mcp-ru==0.3.0"
      ]
    }
  }
}

If the file already exists, add the server inside the mcpServers key. Open the settings file in Cline: MCP Servers tab, Configure MCP Servers.

Keys and settings

DIADOC_CLIENT_IDoptional: Идентификатор приложения Диадок, выдаёт Контур.
DIADOC_TOKENsecret, optional: Токен пользователя Диадок, выдаёт метод Authenticate.

Replace the values in angle brackets with your own. Keys never go into install links and are not stored by us.

Add to the file .roo/mcp.json, in the project

{
  "mcpServers": {
    "diadoc-mcp-ru": {
      "command": "uvx",
      "args": [
        "diadoc-mcp-ru==0.3.0"
      ]
    }
  }
}

If the file already exists, add the server inside the mcpServers key.

Keys and settings

DIADOC_CLIENT_IDoptional: Идентификатор приложения Диадок, выдаёт Контур.
DIADOC_TOKENsecret, optional: Токен пользователя Диадок, выдаёт метод Authenticate.

Replace the values in angle brackets with your own. Keys never go into install links and are not stored by us.

A fork of Roo Code, same .roo folders.

Add to the file opencode.json, in the project

{
  "mcp": {
    "diadoc-mcp-ru": {
      "type": "local",
      "command": [
        "uvx",
        "diadoc-mcp-ru==0.3.0"
      ]
    }
  }
}

If the file already exists, add the server inside the mcp key.

Keys and settings

DIADOC_CLIENT_IDoptional: Идентификатор приложения Диадок, выдаёт Контур.
DIADOC_TOKENsecret, optional: Токен пользователя Диадок, выдаёт метод Authenticate.

Replace the values in angle brackets with your own. Keys never go into install links and are not stored by us.

Add to the file ~/.config/zed/settings.json, for all projects

{
  "context_servers": {
    "diadoc-mcp-ru": {
      "command": "uvx",
      "args": [
        "diadoc-mcp-ru==0.3.0"
      ]
    }
  }
}

If the file already exists, add the server inside the context_servers key.

Keys and settings

DIADOC_CLIENT_IDoptional: Идентификатор приложения Диадок, выдаёт Контур.
DIADOC_TOKENsecret, optional: Токен пользователя Диадок, выдаёт метод Authenticate.

Replace the values in angle brackets with your own. Keys never go into install links and are not stored by us.

Add to the file .codeassistant/mcp.json, in the project

{
  "mcpServers": {
    "diadoc-mcp-ru": {
      "command": "uvx",
      "args": [
        "diadoc-mcp-ru==0.3.0"
      ]
    }
  }
}

If the file already exists, add the server inside the mcpServers key.

Keys and settings

DIADOC_CLIENT_IDoptional: Идентификатор приложения Диадок, выдаёт Контур.
DIADOC_TOKENsecret, optional: Токен пользователя Диадок, выдаёт метод Authenticate.

Replace the values in angle brackets with your own. Keys never go into install links and are not stored by us.

You will need: uv

Checked against the repository on Sep 25, 2026, commit d58b041.

Text for your agent

Install the server with uvx diadoc-mcp-ru, or download the diadoc-mcp-ru-vX.Y.Z.mcpb file from the releases page for Claude Desktop, get DIADOC_CLIENT_ID from Kontur and a token via the Authenticate method, set DIADOC_TOKEN, and check the install with uvx diadoc-mcp-ru doctor.

Other ways from the author

uvx diadoc-mcp-ru

Requires the DIADOC_CLIENT_ID and DIADOC_TOKEN variables.

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

What it does

The server compiles all 114 Diadoc methods from Kontur's official docs into a single endpoints.yaml file and gives the agent three tools instead of a hundred separate functions: search a method by keywords, view its parameter card and access class, and call it. It covers incoming and outgoing documents, document-flow statuses, counterparties and EDF invitations, signing, machine-readable power of attorney and printable forms. Of the 114 methods, 78 read-only ones run immediately, while 29 write and 7 irreversible ones require confirmation. Keys are stored locally in ~/.ru-mcp/cabinets.json with 600 permissions, not only in environment variables.

Who it is for. For accountants, lawyers and developers running electronic document flow through Diadoc who want to do it from a chat with an agent.

Good fit when

You need to reconcile document flow with a counterparty for a period or find documents needing action
You need to check a counterparty by INN and KPP and their EDF connection
You need to download a document's printable form for accounting

Not a fit when

You do not have a Diadoc application ID and a production license: real use needs a separate request to Kontur
You do not want the agent to be able to sign or send documents: even with confirmation, these are sensitive operations

Example request

Show incoming Diadoc documents that need action on my side

Limitations

Production use needs a Kontur license and an application ID issued by request. The user token comes from a separate Authenticate call using login and password or a certificate. All 114 methods are available, but 7 of them are irreversible (for example, final document dispatch).

How to disable. Remove the diadoc-mcp entry from claude_desktop_config.json or another MCP client's config, and delete ~/.ru-mcp/cabinets.json if needed.

MCP

Transport: stdio
Authentication: API key

Environment variables
Environment variables
DIADOC_CLIENT_ID required	Diadoc application ID, issued by Kontur
DIADOC_TOKEN required, secret	User token, issued by the Authenticate method

Security check

Can sign and send documents on behalf of the organization
7 methods are irreversible, such as the final dispatch of a document to a counterparty

README in short

The README explains that the method catalog is compiled from Kontur's official docs and lives in the repo as endpoints.yaml, so the table cannot drift from the code. It shows installation via a no-terminal .mcpb file and via uvx, an environment variable table, a method breakdown by section with read, write and irreversible counts, a sample dialogue finding a method, and a security and privacy section stating the server collects and sends no data.

FAQ

Does the agent need to know all 114 methods?

No, there are three tools: search by keywords, a method card, and a call; the agent finds the right one itself.

Can the agent send a document without confirmation?

No, write and irreversible actions require explicit confirmation, only reads run immediately.

MarkItDown

Official

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

MCP serverMedium riskNo VPN needed187.4K

Anthropic skills

Skills

Editors’ pick

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

SkillMedium risk178.8K

PPT Master

Editors’ pick

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

SkillMedium risk56.8K

Diagram Design

Editors’ pick

A skill that draws editorial diagrams as standalone HTML and SVG files: architecture, flowcharts, ER, funnels and about forty more types

SkillMedium riskNo VPN needed42.6K

Install

What it does

Good fit when

Not a fit when

Example request

Limitations

MCP

Security check

README in short

FAQ

Related

MarkItDown

Anthropic skills

PPT Master

Diagram Design