aprovodka

MCP server for 1C:Enterprise databases over standard OData: catalogs, documents, registers and accounting with no configuration extension

MCP serverHigh riskRussian stack

theyahia/aprovodka

Install

{
  "mcpServers": {
    "aprovodka": {
      "command": "npx",
      "args": ["-y", "@theyahia/aprovodka"],
      "env": {
        "ONEC_BASE_URL": "https://server/base/odata/standard.odata",
        "ONEC_LOGIN": "user",
        "ONEC_PASSWORD": "pass"
      }
    }
  }
}

Add ONEC_WRITE_MODE set to preview or approval to enable the write gate.

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

What it does

The server connects the agent to a live 1C database through the OData 3.0 interface the platform publishes itself, so nothing is added to the configuration. 34 tools cover catalogs, documents, all register kinds, the accounting register with its balance and turnover virtual tables, constants, batch operations, change tracking and metadata discovery. The agent can create and edit documents, post and unpost them and set deletion marks. Writes can go through a safety gate in preview or approval mode, and reversible operations return a rollback token. Presets for Enterprise Accounting 3.0, Trade Management 11, Payroll 3.1 and ERP 2 describe key entities and common traps.

Who it is for. For 1C developers, accountants and finance analysts who need 1C database data in a conversation with an agent.

Good fit when

  • You need account balances and turnovers without writing a report
  • You need to find documents and catalog records by condition
  • You need to explore an unfamiliar configuration through metadata

Not a fit when

  • OData is not published for the database and cannot be
  • The agent must not change accounting data and there is no read-only user

Example request

Show account 41 balances at the end of last month broken down by warehouse

Limitations

Requires the standard OData interface published for the database and a 1C user with suitable rights. The write safety gate is off by default (ONEC_WRITE_MODE=off) and must be enabled explicitly. Login and password are passed in environment variables. Source code and full docs live in the WWmcp monorepo; this repo is the product page. Not affiliated with 1C Company. The author also offers paid setup for a specific database.

How to disable. Delete the aprovodka block from your MCP client config and disable the 1C user the server used.

MCP

Transport
stdio
Authentication
API key
Environment variables
Environment variables
ONEC_BASE_URL
required
Database standard OData URL ending in standard.odata
ONEC_LOGIN
required
1C user name
ONEC_PASSWORD
required, secret
1C user password
ONEC_WRITE_MODE
Write gate mode: off, preview or approval, off by default

Security check

  • Creates, edits and posts documents in a production 1C database
  • The write gate is off by default
  • The 1C user login and password sit in the config

README in short

The README explains that the server uses OData 3.0 with no extensions and lists coverage: catalogs, documents, registers, accounting, batches and change tracking. It gives an MCP config with npx and ONEC_* variables and describes write safety modes and standard configuration presets. A section covers migrating from the old 1c-rest-mcp package, plus a trademark note. A large part of the README also promotes the author's paid data reconciliation service. MIT licensed.

FAQ

Do I need a configuration extension?

No, the server works only through the standard OData interface the platform publishes.

How do I protect the database from accidental changes?

Set ONEC_WRITE_MODE=preview or approval. The safest option is a read-only 1C user for the server.

How does it relate to @theyahia/1c-rest-mcp?

It is the same project renamed in v4.0.0. Tools and ONEC_* variables are unchanged; only the command and server name changed.

Editors’ pick

Stripe's official MCP server, plugins and skills: the agent searches the API and docs, reads and changes account data

MCP serverHigh risk1.8K

The official CCXT MCP server and skills: market data, balances and opt-in trading across crypto exchanges and prediction markets

MCP serverHigh risk44K

Skill plugins for analyzing stocks, earnings, options and startups, plus readers for social feeds and market data

PluginMedium risk3.3K

Skills and an MCP server for options traders: quotes, technical analysis, Greeks, spreads, scanners and Interactive Brokers portfolio

MCP serverHigh risk365