SkillFoxx

Kontur.Elba MCP server

Kontur.Elba MCP

An MCP server over the official Elba Public API: counterparties, products, invoices, acts, waybills and UPD for sole proprietors and small business

  • 0 ★ on the repository
  • Last commit
  • MIT
MCP server

Broad access

Why this level

  • The elba_request tool can create and change invoices, waybills, UPD and bank accounts
  • Any POST, PUT or DELETE in the Elba schema changes real accounting data
All reasons and checks
Russian stack

apo100l/elba-kontur-mcpAuthor:apo100l

Install

Services

Manual install

git clone https://github.com/apo100l/elba-kontur-mcp.git && cd elba-kontur-mcp && npm install && npm run build

Build from source, requires Node.js 20 or newer.

Access and checks

How we review

Broad accessThe tool can change data, run commands or handle secrets.

  • The elba_request tool can create and change invoices, waybills, UPD and bank accounts
  • Any POST, PUT or DELETE in the Elba schema changes real accounting data

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

What it does

The server runs locally over stdio and calls the official Elba Public API for Kontur.Elba, sending the key only in the X-Kontur-ApiKey header. It only allows operations described in the bundled OpenAPI schema, not arbitrary requests. There are four tools: a searchable list of allowed operations, a description of one operation with its request body and responses, a quick list of organizations by key, and a generic call to any schema operation. Before creating or changing data the agent is expected to fetch the operation description first to get the exact request body shape. Through the generic call it can create bank accounts, counterparties, products, invoices, acts, waybills and UPD documents.

Who it is for. For sole proprietors and small companies who keep records in Kontur.Elba and want an agent to handle routine counterparty and document tasks.

Good fit when

  • You want to quickly find or create a counterparty right from an agent chat
  • You want to see the schema for creating an invoice or waybill before filling it out by hand
  • You need one MCP tool that can call any Elba Public API operation

Not a fit when

  • You want a ready set of named tools per operation rather than a generic schema-driven call
  • You cannot trust an agent to create accounting documents without a step-by-step check

Example request

Show me the schema for creating an invoice, but do not create anything yet

MCP

Transport
stdio
Authentication
API key

Environment variables

ELBA_API_KEY required, secret
Elba Public API key from service settings
ELBA_API_BASE_URL
API base URL, defaults to https://elba-api.kontur.ru
ELBA_API_TIMEOUT_MS
Request timeout in milliseconds, default 30000

Limitations

0 stars, a single author, a very new repository. The Kontur.Elba service itself is official, but this MCP server is not: it is an independent implementation over the official Elba Public API, not a project by SKB Kontur. It needs your own API key from Elba settings, available on a paid plan with API access enabled.

How to disable. Remove the elba-kontur-mcp block from your MCP client config and revoke the ELBA_API_KEY key in Elba service settings.

FAQ

Can the server run any request against Elba?

No, only operations listed in the bundled Elba API OpenAPI schema; arbitrary routes and URLs are rejected.

How do I know which fields a document needs?

Call elba_describe_operation for that operation first; it returns the exact parameters and request body shape.

Discussion

No questions or reviews yet.

All Kontur tools

Kontur Elba MCP server

Elba MCP Server

Russian stack

An MCP server over the Kontur Elba public API: counterparties, products, bills, delivery notes and acts for sole proprietors and small businesses

MCP serverBroad access
Russian stack

Invoices, acts and UPD in Elba from an agent chat, public document links for clients and a summary of unpaid bills

MCP serverBroad access

Kontur.Diadoc MCP

kontur-diadoc-mcp

Russian stack

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

MCP serverBroad access4
Russian stack

A monorepo of MCP servers for Russian and CIS APIs: payments, CRM, marketplaces, delivery, HR and reference data

MCP serverBroad access38
Russian stack

A skill pack for small business operations in Russia: simplified tax, cash flow, receivables, contracts, hiring and counterparty checks by INN

PluginExtended access34
Russian stack

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

MCP serverBroad access3

README in short

The Russian README explains the server runs over stdio and is limited to operations from openapi.json, gives step-by-step key retrieval instructions warning not to store it in code or .env in Git, shows connecting it in Codex and Claude Desktop, a table of four tools, environment variables, and a security section: the key is never logged, arbitrary routes are rejected, requests have a timeout.

README badge

Report a problem