MoySklad Analytics with an MCP endpoint

Install

npx skillfoxx add mcp/moysklad-analytics

claude mcp add --transport http moysklad https://your-deployment.example.com/api/mcp --header 'Authorization: Bearer <your AUTHORIZATION>'

{
  "mcpServers": {
    "moysklad": {
      "type": "http",
      "url": "https://your-deployment.example.com/api/mcp",
      "headers": {
        "Authorization": "Bearer <your AUTHORIZATION>"
      }
    }
  }
}

{
  "mcpServers": {
    "moysklad": {
      "url": "https://your-deployment.example.com/api/mcp",
      "headers": {
        "Authorization": "Bearer <your AUTHORIZATION>"
      }
    }
  }
}

code --add-mcp '{"name":"moysklad","type":"http","url":"https://your-deployment.example.com/api/mcp","headers":{"Authorization":"Bearer <your AUTHORIZATION>"}}'

{
  "servers": {
    "moysklad": {
      "type": "http",
      "url": "https://your-deployment.example.com/api/mcp",
      "headers": {
        "Authorization": "Bearer <your AUTHORIZATION>"
      }
    }
  }
}

[mcp_servers.moysklad]
url = "https://your-deployment.example.com/api/mcp"
http_headers = { Authorization = "Bearer <your AUTHORIZATION>" }

{
  "mcpServers": {
    "moysklad": {
      "httpUrl": "https://your-deployment.example.com/api/mcp",
      "headers": {
        "Authorization": "Bearer <your AUTHORIZATION>"
      }
    }
  }
}

{
  "mcpServers": {
    "moysklad": {
      "serverUrl": "https://your-deployment.example.com/api/mcp",
      "headers": {
        "Authorization": "Bearer <your AUTHORIZATION>"
      }
    }
  }
}

{
  "mcpServers": {
    "moysklad": {
      "type": "streamableHttp",
      "url": "https://your-deployment.example.com/api/mcp",
      "headers": {
        "Authorization": "Bearer <your AUTHORIZATION>"
      }
    }
  }
}

{
  "mcpServers": {
    "moysklad": {
      "type": "streamable-http",
      "url": "https://your-deployment.example.com/api/mcp",
      "headers": {
        "Authorization": "Bearer <your AUTHORIZATION>"
      }
    }
  }
}

{
  "mcp": {
    "moysklad": {
      "type": "remote",
      "url": "https://your-deployment.example.com/api/mcp",
      "headers": {
        "Authorization": "Bearer <your AUTHORIZATION>"
      }
    }
  }
}

{
  "context_servers": {
    "moysklad": {
      "url": "https://your-deployment.example.com/api/mcp",
      "headers": {
        "Authorization": "Bearer <your AUTHORIZATION>"
      }
    }
  }
}

pnpm setup && cp .env.example .env

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

What it does

The project is a full NestJS and React dashboard over the MoySklad JSON API 1.2: sales and profit by product, stock and restocking needs, customers and channels, trends over time. A separate pnpm probe command checks the token and its rights before trusting any figure, showing which reports the account can actually reach and whether cost price and profit are hidden by user permissions. A built-in DeepSeek AI assistant answers questions over the same data through seven read-only tools. For external agents there is a POST /api/mcp Streamable HTTP endpoint with the same seven analytics tools, plus seven business tools (documents, money, purchases, mutual settlements, counterparties, turnover) and a moysklad_api tool for reading any raw API path. All the money logic (minor units, the difference between markup and margin) is handled once in the stats service, so the dashboard, the built-in assistant and the external MCP cannot disagree on what "revenue" means.

Who it is for. For MoySklad store owners who want not just a chat with an agent but a full self-hosted dashboard with verified numbers and MCP as a bonus.

Example request

Which products need restocking this week, and who are our biggest customers this quarter

Limitations

This is not a lightweight MCP server but a full self-hosted app (NestJS + React), requiring Docker or your own server to deploy. The built-in AI assistant only works 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 come back empty rather than erroring.

How to disable. Stop the Docker container or server process and remove the MCP connection entry from your client (claude mcp remove moysklad or the equivalent command).

MCP

Transport

http

Authentication

OAuth

Security check

• MCP tools are structurally read-only, but they expose a full view of money and customers if authorization is weak
• The dashboard shows cost price and profit per product and customer, and requires mandatory Basic auth in production

README in short

The README documents MoySklad API quirks confirmed on a live account in detail (money in minor units, the margin vs. salesMargin difference, differing href formats across reports), explains the DeepSeek model choice for the built-in assistant and why local models did not work out, and separately describes the MCP endpoint: a 15-tool surface, two auth methods (a static bearer and full MCP-spec OAuth), and mandatory Basic auth in production.

Related