Skip to main content
Glama

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 — снимает паранойю об утечке ПДн.

Related MCP server: opensanctions-mcp

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_pro

damia

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_BASE

URL Pro-backend

https://api.atomno-mcp.ru/mcp-fssp/v1

MCP_FSSP_HTTP_TIMEOUT

Таймаут одного запроса в секундах

15

MCP_FSSP_RPS

Лимит запросов в минуту со стороны клиента

30

MCP_FSSP_USER_AGENT

User-Agent для запросов

mcp-fssp/0.1 (...)

MCP_FSSP_AUDIT_DB

Путь к SQLite-аудит-логу

./audit.sqlite

MCP_FSSP_LOG_LEVEL

Уровень логов: DEBUG/INFO/WARNING/ERROR

INFO

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

  • ПДн (ФИО, дата рождения) не сохраняются в 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 коммерческих провайдеров.

Ссылки

Available Tools

5 tools
check_debtor_wantedA

Проверить розыск должника в банке ФССП (fssp.gov.ru/iss/wanted).

Запрос содержит ПДн — используйте только в законных целях compliance / due-diligence с согласия субъекта (152-ФЗ).

Отличается от check_individual_debts: здесь ищем именно факт постановки в розыск по исполнительным производствам, а не список открытых ИП.

Inputs: fio (required), birth_date (required). Returns: object

check_individual_debtsA

Проверить открытые исполнительные производства на физ.лицо.

Запрос содержит ПДн — используйте только в законных целях (due-diligence, скоринг по согласию субъекта) с соблюдением 152-ФЗ.

Inputs: fio (required), birth_date (required), region. Returns: object

get_proceeding_detailsA

Получить детальную карточку конкретного ИП по его номеру.

Inputs: proceeding_id (required). Returns: object

pingA

Диагностика: сервер жив, сообщает версию и текущий провайдер.

Inputs: no named parameters. Returns: object

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.9/5.0

    Scored across 5 tools

    Disambiguation5/5

    Each tool maps to a distinct resource and action: wanted status, individual debts, legal entity debts, proceeding details, and health check. The descriptions explicitly separate the wanted search from the open proceedings search, eliminating confusion.

    Naming Consistency4/5

    The naming follows a clear check_* pattern for searches and get_ for detail retrieval. The only deviation is ping, which is a standard health-check name but does not match the verb_noun convention.

    Tool Count5/5

    With 5 tools, the server is tightly scoped to the FSSP domain and every tool serves a clear purpose. The count feels appropriate for a focused read-only compliance server.

    Completeness5/5

    The core FSSP query surface is covered: individual debts, legal entity debts, wanted persons, and detailed proceeding lookup. A user can list proceedings and then fetch details by number, so the workflow has no obvious dead ends.

    Maintenance

    ActivityStale
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • F
      license
      Not graded
      quality
      D
      maintenance
      An MCP server for FixPayment creditors that simplifies account management, status updates, and reporting through plain-English AI interactions (https://fixpayment.org/)
      -
    • A
      license
      A
      quality
      D
      maintenance
      MCP server for sanctions screening and PEP checks via OpenSanctions API. Search entities, match against 320+ sanctions lists, and run compound compliance investigations with AI agents.
      6
      43 npm
      MIT
    • A
      license
      A
      quality
      B
      maintenance
      MCP server for verifying Russian counterparties (legal entities and individual entrepreneurs) via public Federal Tax Service data: EGRUL/EGRIP, bankruptcy registry (EFRSB), Transparent Business, bailiff service (FSSP), and arbitration courts (KAD).
      8
      114 PyPI
      15
      MIT
    • A
      license
      A
      quality
      C
      maintenance
      MCP server for the Russian state registries EGRUL (legal entities) and EGRIP (individual entrepreneurs), built on official Federal Tax Service open-data dumps. Self-hosted via local SQLite.
      8
      78 PyPI
      3
      MIT