mcp-fssp MCP server

<!-- mcp-name: io.github.atomno-mcp/mcp-fssp -->

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. Установить

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

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

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

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-конфиг):

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.checkindividualdebts(...), fssp.checklegalentitydebts(...) и fssp.getproceeding_details(...).

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

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

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

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

Shortened. The full README is on GitHub.