Документация API

MCP-сервер

Подключите AI-агентов к Statsnet по Model Context Protocol.

Statsnet предоставляет remote MCP-сервер (Streamable HTTP, без сессий), через который AI-агенты — Claude, Cursor и любые MCP-совместимые — запрашивают данные о компаниях напрямую:

POST https://statsnet.co/mcp

Аутентификация — тем же ключом sk_live_..., что и REST API, из личного кабинета. Биллинг идентичен REST: API-тарифы метерятся за вызов, тарифы с отчётами списывают один отчёт за карточку компании с бесплатным повтором в течение 2 недель.

Инструменты

Без ключа (анонимно):

ИнструментОписание
search_companiesПоиск компаний по названию, БИН/ИИН или руководителю. Лимит: 30 поисков в час с одного IP.
get_companyПубличная карточка компании в Markdown: статус, регистрация, руководство, счётчики, финансы.

С заголовком Authorization: Bearer sk_live_...:

ИнструментОписание
search_companiesТот же поиск без IP-лимитов, до 50 результатов за вызов.
get_companyПубличная карточка компании.
get_company_paidПолная карточка: учредители, капитал, вся финансовая история, риски. Списывает квоту тарифа.
get_gov_contractsГосконтракты: предмет, заказчик, сумма, даты.
get_court_casesСудебные дела: номер, тип, суд, стороны, результат.
get_relationsГраф связей: учредители, руководители и их другие компании.
check_individualПроверка физлица по ИИН: где руководитель/учредитель, риски. Требует тариф Premium и выше.

Подключение

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" }
    }
  }
}

Без заголовка Authorization сервер работает в анонимном режиме с двумя публичными инструментами.

Ошибки

Неверный или отозванный ключ получает HTTP 401 (никогда — тихий даунгрейд до анонимного режима). Проблемы квоты и тарифа возвращаются как ошибки инструмента с понятным объяснением: например, что исчерпан месячный лимит или недостаточен тариф.