atomno-mcp/mcp-fssp

MCP-сервер ФССП: проверка исполнительных производств по людям, компаниям и ИП — суммы, статусы, данные пристава и основание взыскания. Подключается к Cursor, Claude и любому клиенту MCP.
Russian bailiff debt lookup for AI agents.
Покрывает:
- Физических лиц (по ФИО + дате рождения).
- Юридических лиц (по ИНН-10 / ОГРН-13).
- Индивидуальных предпринимателей (по ИНН-12 / ОГРНИП-15).
Часть семейства MCP-серверов **atomno** для due-diligence по российским контрагентам:
mcp-egrul (реквизиты юр.лиц) ·
mcp-fns-check (налоговая благонадёжность) ·
mcp-cbr-rates (курсы ЦБ) ·
**mcp-fssp** (долги в ФССП).
Зачем
Официальный API ФССП (api-ip.fssp.gov.ru) **отключён с 10 марта 2022 года** и не планируется к восстановлению. Единственная официальная точка — публичный web-сервис fssp.gov.ru/iss/ip с CAPTCHA. Это создаёт нишу: MCP-обёртка с поддержкой нескольких коммерческих провайдеров (Damia / Checko / NewDB / api-cloud) и нормализованной моделью данных.
Главные кейсы:
- **AI-агент в Cursor / Claude Desktop** делает due-diligence контрагента в чате за 30 секунд вместо 10 минут на ручной обход сайта ФССП.
- **Юристы / банки / скоринг** интегрируют единый check_*_debts вызов в свои Python-скрипты или 1С, не разбирая сырые ответы 3-4 разных провайдеров.
- **Self-host энтузиасты** ставят клиент локально со своим ключом Damia/Checko и работают без зависимости от стороннего SaaS — снимает паранойю об утечке ПДн.
Quick start
1. Установить
2. Получить ключ провайдера
Минимум один из:
- **Damia** (https://api-fssp.damia.ru) — основной кандидат для prod. От 7 000 ₽/год за 1 000 запросов; 100 запросов бесплатно на тест.
- **Checko** (https://api.checko.ru) — до 50 запросов/день бесплатно. Хорош для onboarding.
- **NewDB** (https://newdb.net/fssp/api) — бюджетная альтернатива, 2 ₽/запрос, 100 free.
- **api-cloud** (https://api-cloud.ru/api/fssp.php) — per-request оплата.
3. Конфиг
Создай .env в рабочей директории (или передай переменные через MCP-конфиг):
Полный список переменных — см. .env.example.
4. Подключить к Cursor
Открой ~/.cursor/mcp.json (или Settings → MCP) и добавь:
Перезапусти Cursor. Теперь AI-агент может вызывать fssp.check_individual_debts(...), fssp.check_legal_entity_debts(...) и fssp.get_proceeding_details(...).
5. Подключить к Claude Desktop
Открой claude_desktop_config.json и добавь:
Доступные инструменты
| Инструмент | Назначение |
|---|---|
| ping | Проверка готовности сервера и текущего провайдера. |
| check_individual_debts(fio, birth_date, region?) | Список открытых ИП по физ.лицу. |
| check_legal_entity_debts(inn?, ogrn?) | Список открытых ИП по юр.лицу или ИП-предпринимателю. |
| get_proceeding_details(proceeding_id) | Детальная карточка одного ИП по номеру. |
В Pro-версии (Phase 3+, требует ATOMNO_API_KEY):
- summarize_debts(...) — AI-summary долгов с категоризацией и risk-score.
- monitor_debts_changes(...) — подписка на изменения с webhook/Telegram-алёртами.
Переменные окружения
| Переменная | Назначение | По умолчанию |
|---|---|---|
| MCP_FSSP_PROVIDER | Провайдер: damia / checko / newdb / api_cloud / self_parser / atomno_pro | damia |
| MCP_FSSP_DAMIA_KEY | Ключ Damia API-ФССП | — |
| MCP_FSSP_CHECKO_KEY | Ключ Checko v2 | — |