moysklad-mcp-ru
A MoySklad MCP server with two write gates: stock, profit, reports and draft documents over JSON API 1.2
- 0 ★ on the repository
- Last commit
Broad access
Why this level
- Write tools create, post and delete documents in live accounting
- The account token moves stock and money once writing is enabled
Install
- Works in
- Services
Manual install
установи МойСклад MCP
The simplest method from the README: tell this to Claude or Cowork, and it runs the bundled install-skill.
Access and checks
How we reviewBroad accessThe tool can change data, run commands or handle secrets.
- Write tools create, post and delete documents in live accounting
- The account token moves stock and money once writing is enabled
This is third-party code. Review the repository files before installing.
What it does
The server gives an agent direct access to a MoySklad account's JSON API 1.2 without a browser, claiming 32 tools and 70 offline tests. Eight meta-tools (search a method, describe it, call it, raw call, fetch all pages and more) work over a catalog of 892 methods built from the official MoySklad documentation. There are also typed read tools for stock, products, orders, profit, turnover, cash, counterparties, warehouses and documents, with amounts auto-converted from kopecks to rubles. Writing documents goes through two independent safety layers: a process-level MOYSKLAD_ALLOW_WRITE flag, off by default, and mandatory confirmation on every call. Creating always produces a draft, and posting or deleting a document needs separate explicit consent. The server's core is a vendored engine from the open-source ilyautov/marketplaces-mcp-ru project, MIT-licensed and unmodified by this author, with MoySklad-specific logic built on top.
Who it is for. For MoySklad business owners and accountants who want full API access with protection against accidentally writing to live accounting.
Good fit when
- You need access to all 892 MoySklad API methods, not just standard reports
- You need maximum protection against accidentally posting a document in a live account
- You want installation without hand-editing JSON, via the built-in install-skill or a script
Not a fit when
- You are not ready for alpha status: some imported methods are not battle-tested
- You need a long-stable 1.0 release rather than 0.1.0
Example request
Create a draft receipt of 10 units from Supplier LLC at 250 rubles on the test accountMCP
- Transport
- stdio
- Authentication
- API key
Environment variables
MOYSKLAD_ALLOW_WRITE- Enables write capability, off by default
MOYSKLAD_WRITE_CABINETS- Optional list of cabinets allowed to write
Limitations
The author marks the project alpha: the curated core and write path are battle-tested on a test account, while methods imported from documentation are an exploration map, and write bodies should be checked against docs or called via ms_call_raw. 0 stars, version 0.1.0. The core/ folder is a vendored, unmodified engine from another open-source project (ilyautov/marketplaces-mcp-ru), not this repository author's own original code.
How to disable. Remove the ms server from your agent config and delete ~/.moysklad-mcp/cabinets.json with the stored tokens.
FAQ
Can the server accidentally post a document?
No, posting and deleting is a separate destructive step requiring MOYSKLAD_ALLOW_WRITE=1 plus explicit confirmation on that specific call.
What is the core folder?
It is an unmodified vendored engine from the open-source ilyautov/marketplaces-mcp-ru project under MIT, with the rest of the MoySklad logic built on top.
Discussion
No questions or reviews yet.
Related
All MoySklad toolsMCP server for the MoySklad JSON API 1.2: stock, orders, profit reports and document creation behind two safety gates
MoySklad MCP
moysklad-mcp
MoySklad MCP server with 60 tools: products, stock, orders, shipments, receipts, payments, profit reports
MoySklad MCP: products, stock, orders
mcp-moysklad
An MCP server for MoySklad: product and stock search, counterparties by INN, creating and reading orders, a sales summary via a single npx package
MoySklad production MCP server
moysklad-production-mcp
A read-only MCP server for the MoySklad production module: process cards, production tasks and per-product profit
MoySklad analytics with MCP endpoint
MoySklad Analytics
Self-hosted MoySklad analytics dashboard (sales, stock, clients) with an MCP endpoint that provides the agent with the same verified figures visible on screen
MoySklad for Claude Code: read and write on API 1.2
claude-moysklad-mcp
A local Python and FastMCP connector for MoySklad products, stock, counterparties and customer orders plus a raw request to any API method
Comparison with similar tools
Cards that share the main search query, and how they differ.
| Tool | Official | Authentication | Repository stars | Main difference |
|---|---|---|---|---|
| moysklad-mcp-ru (this card) | no | API key | 0 | |
| MoySklad MCP | no | not required | 10 | products, stock and orders |
| moysklad-mcp-ru | no | API key | 3 | stock, profit |
README in short
The Russian README with an English version alongside describes a scheme of 8 meta-tools over a method catalog, typed read tools, a safety model with two independent write-protection layers, three install paths (via an AI, a release archive with install.command, or install.py per client), kopeck-to-ruble conversion, MoySklad API limits (a 45-requests-per-3-seconds bucket), and an honest caveats section about the reliability of imported methods. MIT licensed.