# MCP-сервер

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

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

```text
POST https://statsnet.co/mcp
```

Аутентификация — тем же ключом `sk_live_...`, что и REST API, из [личного кабинета](https://statsnet.co/me). Биллинг идентичен 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**

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

**Claude Desktop / Cursor (mcp.json)**

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

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

## Ошибки

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