MCP Server

Connect AI agents to Statsnet over the Model Context Protocol.

Statsnet exposes a remote MCP server (Streamable HTTP, stateless) so AI agents — Claude, Cursor, or anything MCP-compatible — can query company data directly:

POST https://statsnet.co/mcp

Authentication uses the same sk_live_... API key as the REST API, created in your account settings. Billing is identical to REST: API plans are metered per call, report plans consume one report per company card with a 2-week free-reuse window.

Tools

Without a key (anonymous):

Tool	Description
`search_companies`	Search companies by name, BIN/IIN or director. Limited to 30 searches per hour per IP.
`get_company`	Public company card in Markdown: status, registration, management, counters, financials.

With Authorization: Bearer sk_live_...:

Tool	Description
`search_companies`	Same search without IP limits, up to 50 results per call.
`get_company`	Public company card.
`get_company_paid`	Full company card: shareholders, capital, full financial history, risks. Consumes plan quota.
`get_gov_contracts`	Government contracts: subject, customer, amount, dates.
`get_court_cases`	Court cases: number, type, court, parties, outcome.
`get_relations`	Relations graph: shareholders, officers and their other companies.
`check_individual`	Check a person by IIN: directorships, shareholdings, risks. Requires the Premium plan or higher.

Connect

Claude Code

claude mcp add --transport http statsnet https://statsnet.co/mcp \
  --header "Authorization: Bearer sk_live_YOUR_KEY"

Claude Desktop / Cursor (mcp.json)

{
  "mcpServers": {
    "statsnet": {
      "url": "https://statsnet.co/mcp",
      "headers": { "Authorization": "Bearer sk_live_YOUR_KEY" }
    }
  }
}

Without the Authorization header the server still works in the anonymous mode with the two public tools.

Errors

Invalid or revoked keys get HTTP 401 (never a silent downgrade to anonymous). Quota and plan problems are returned as tool errors with a human-readable explanation, so the agent can relay them — for example, that the monthly allowance is exhausted or the plan tier is too low.