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
- 0 ★ on the repository
- Last commit
Extended access
Why this level
- MCP tools are read-only but expose full money and client data if authorization is weak
- The dashboard shows cost and profit per product and client, requiring mandatory Basic auth in production
Install
- Works in
- Services
In your terminal, with SkillFoxx CLI
npx skillfoxx add mcp/moysklad-analyticsDetects the agents on your machine, shows the access level and pins the version.
Other ways to install
Access and checks
How we reviewExtended accessThe tool runs code or makes network calls and only reads external data.
- MCP tools are read-only but expose full money and client data if authorization is weak
- The dashboard shows cost and profit per product and client, requiring mandatory Basic auth in production
This is third-party code. Review the repository files before installing.
What it does
This project is a full dashboard built on NestJS and React over the MoySklad JSON API 1.2: sales and profit by products, stock and purchase needs, clients and channels, trends by periods. A separate pnpm probe command verifies the token and access rights before trusting any data: it shows which reports are actually available to the account and whether cost and profit are hidden by user permissions. The built-in AI assistant on DeepSeek answers questions based on the same data through seven read-only tools. For external agents, there is a POST /api/mcp Streamable HTTP endpoint with the same seven analytical tools plus seven business tools (documents, money, purchases, settlements, contractors, turnovers) and one moysklad_api tool for reading arbitrary API paths. All monetary logic (minor units, difference between markup and margin) is handled once in the statistics service, so the dashboard, built-in assistant, and external MCP cannot disagree on the definition of “revenue.”
Who it is for. For MoySklad store owners who need more than a chat with an agent and want a full self-hosted dashboard with verified figures plus MCP access.
Good fit when
- A visual dashboard for sales, stock, and clients is needed, not just an agent chat
- It is important to verify token permissions before trusting profit and margin figures
- MCP access to the same verified data is needed for Claude, Cursor, or ChatGPT connectors
Not a fit when
- Only an MCP server is needed without deploying a full dashboard: this is a self-hosted app with NestJS backend and React frontend, no lightweight option available
- Not ready to deploy via Docker and configure Basic auth: the server will refuse to start in production without credentials
- Write access to MoySklad is needed: moysklad_api and other MCP tools are read-only by design
Example request
Which products need to be purchased in the next week and who are our largest clients for the quarterMCP
- Transport
- http
- Authentication
- OAuth
Environment variables
MOYSKLAD_TOKENrequired, secret- MoySklad JSON API token
MCP_TOKENsecret- Enables MCP endpoint, minimum 24 characters, used both as static Bearer and OAuth signature key
DASHBOARD_USERrequired- Dashboard Basic auth login, required in production
DASHBOARD_PASSWORDrequired, secret- Dashboard Basic auth password, required in production
DEEPSEEK_API_KEYsecret- Enables built-in AI assistant in the dashboard
Limitations
This is a full self-hosted application on NestJS and React, significantly heavier than a typical MCP server: deployment requires Docker or a dedicated server. The built-in AI assistant works only with a paid DeepSeek key. MoySklad limits the API to 45 requests per 3 seconds and 5 concurrent connections. If the token belongs to a restricted user, profit and margin columns return empty rather than an error.
How to disable. Stop the Docker container or server process and remove the MCP connection entry from the client (claude mcp remove moysklad or a similar command).
FAQ
Can an MCP tool modify data in MoySklad?
No, both the seven business tools and the universal moysklad_api are read-only; the API client uses only GET.
How to connect from the Claude or ChatGPT mobile app?
Via OAuth: add a custom connector at /api/mcp, the app will find authorization endpoints and prompt to log in with dashboard credentials.
Discussion
No questions or reviews yet.
Related
All MoySklad toolsMoySklad 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 MCP
moysklad-mcp
MoySklad MCP server with 60 tools: products, stock, orders, shipments, receipts, payments, profit reports
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
MCP server for the MoySklad JSON API 1.2: stock, orders, profit reports and document creation behind two safety gates
A MoySklad MCP server with two write gates: stock, profit, reports and draft documents over JSON API 1.2
MoySklad MCP by partner Kaya
MCP-сервер МойСклад (Kaya)
A paid app from the MoySklad marketplace: once installed, an agent searches products, counterparties and orders and creates documents through a chat
README in short
The README documents details of the MoySklad API confirmed on a live account (money in minor units, difference between margin and salesMargin, different href formats in reports), explains the choice of DeepSeek for the built-in assistant and why local models were unsuitable, and separately describes the MCP endpoint: a set of 15 tools, two authorization methods (static Bearer and full OAuth per MCP specification), and mandatory Basic auth in production.