mcp-fssp

Tra cứu nợ của FSSP Nga (Dịch vụ Thừa phát lại Liên bang) qua MCP — kiểm tra các thủ tục cưỡng chế (исполнительные производства) cho cá nhân và pháp nhân trực tiếp từ Cursor, Claude Desktop, Cl...

GitHubDùng thử MCP nàyĐược tài trợ

Tài liệu

mcp-fssp

MCP-сервер ФССП: проверка исполнительных производств по людям, компаниям и ИП — суммы, статусы, данные пристава и основание взыскания. Подключается к Cursor, Claude и любому клиенту MCP.

Russian bailiff debt lookup for AI agents.

PyPI License: MIT MCP Python 3.11+

Покрывает:

  • Физических лиц (по ФИО + дате рождения).
  • Юридических лиц (по ИНН-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. Установить

# Через pipx (рекомендуется для CLI):
pipx install atomno-mcp-fssp

# Или через uv (быстрее):
uvx atomno-mcp-fssp

# Или классически через pip:
pip install atomno-mcp-fssp

2. Получить ключ провайдера

Минимум один из:

3. Конфиг

Создай .env в рабочей директории (или передай переменные через MCP-конфиг):

MCP_FSSP_PROVIDER=damia
MCP_FSSP_DAMIA_KEY=ваш_ключ_от_Damia

Полный список переменных — см. .env.example.

4. Подключить к Cursor

Открой ~/.cursor/mcp.json (или Settings → MCP) и добавь:

{
  "mcpServers": {
    "fssp": {
      "command": "uvx",
      "args": ["atomno-mcp-fssp"],
      "env": {
        "MCP_FSSP_PROVIDER": "damia",
        "MCP_FSSP_DAMIA_KEY": "ваш_ключ"
      }
    }
  }
}

Перезапусти Cursor. Теперь AI-агент может вызывать fssp.check_individual_debts(...), fssp.check_legal_entity_debts(...) и fssp.get_proceeding_details(...).

5. Подключить к Claude Desktop

Открой claude_desktop_config.json и добавь:

{
  "mcpServers": {
    "fssp": {
      "command": "uvx",
      "args": ["atomno-mcp-fssp"],
      "env": {
        "MCP_FSSP_PROVIDER": "damia",
        "MCP_FSSP_DAMIA_KEY": "ваш_ключ"
      }
    }
  }
}

Доступные инструменты

ИнструментНазначение
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_prodamia
MCP_FSSP_DAMIA_KEYКлюч Damia API-ФССП—
MCP_FSSP_CHECKO_KEYКлюч Checko v2—
MCP_FSSP_NEWDB_KEYКлюч NewDB—
MCP_FSSP_API_CLOUD_KEYКлюч api-cloud.ru—
ATOMNO_API_KEYКлюч Pro-режима (api.atomno-mcp.ru/fssp/)—
ATOMNO_API_BASEURL Pro-backendhttps://api.atomno-mcp.ru/mcp-fssp/v1
MCP_FSSP_HTTP_TIMEOUTТаймаут одного запроса в секундах15
MCP_FSSP_RPSЛимит запросов в минуту со стороны клиента30
MCP_FSSP_USER_AGENTUser-Agent для запросовmcp-fssp/0.1 (...)
MCP_FSSP_AUDIT_DBПуть к SQLite-аудит-логу./audit.sqlite
MCP_FSSP_LOG_LEVELУровень логов: DEBUG/INFO/WARNING/ERRORINFO

Безопасность и ПДн

  • ПДн (ФИО, дата рождения) не сохраняются в plain-text. Audit-лог хранит только sha256(fio_lower + birth_date).
  • Согласно 229-ФЗ ст. 6.1, сведения из банка данных исполнительных производств являются открытыми и доступны без согласия должника.
  • Тем не менее, при использовании в коммерческих целях оператор обязан соблюдать 152-ФЗ. Использование в законных целях (например, due-diligence перед сделкой, скоринг по согласию заёмщика) — на стороне пользователя.

Disclaimer

Сервис — агрегатор и удобный интерфейс над публичными данными ФССП (229-ФЗ ст. 6.1). Не аффилирован с ФССП России, Damia, Checko, NewDB, api-cloud и другими провайдерами. Используется на ваш риск.

Информация, возвращаемая инструментами, носит справочный характер и не заменяет официальные документы, выдаваемые ФССП. Авторы не отвечают за актуальность, полноту и точность данных провайдеров. Ответственность за законность использования сведений (в т.ч. соблюдение 152-ФЗ при обработке ПДн) — на пользователе.

При принятии юридически значимых решений (например, об отказе в кредите) необходимо запрашивать первичные документы у самого должника или через официальные каналы (запрос в подразделение приставов).

Roadmap

  • v0.1 (текущая) — Phase 0 scaffold + Damia-провайдер + check_individual_debts.
  • v0.2 — multi-provider (+Checko, NewDB, api-cloud), check_legal_entity_debts, get_proceeding_details, локальный кэш L1.
  • v0.3+ — self_parser через CAPTCHA-solver.
  • v0.5 — интеграция с Pro-backend (api.atomno-mcp.ru/fssp/): summarize_debts, monitor_debts_changes, кэш L2 на 30 дней, fallback по 3 провайдерам.

Документация по инструментам и переменным окружения — в этом README и в CHANGELOG.md. После публикации — также на GitHub: atomno-mcp/mcp-fssp.

Лицензия

MIT © 2026 atomno.

Pro-backend (atomno-mcp/mcp-fssp-server) — запланирован на Phase 2 (приватный hosted-сервис с проприетарной лицензией). Open-клиент полностью функционален без него — пользователь подставляет свой ключ любого из 4 коммерческих провайдеров.

Ссылки