{
  "markdown": "<!-- mcp-name: io.github.atomno-mcp/mcp-fssp -->\n\n# mcp-fssp\n\nMCP-сервер ФССП: проверка исполнительных производств по людям, компаниям и ИП — суммы, статусы, данные пристава и основание взыскания. Подключается к Cursor, Claude и любому клиенту MCP.\n\nRussian bailiff debt lookup for AI agents.\n\n[![PyPI](https://img.shields.io/pypi/v/atomno-mcp-fssp.svg)](https://pypi.org/project/atomno-mcp-fssp/)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n[![MCP](https://img.shields.io/badge/MCP-server-blue)](https://modelcontextprotocol.io)\n[![Python 3.11+](https://img.shields.io/badge/python-3.11+-blue.svg)](https://www.python.org/downloads/)\n\nПокрывает:\n\n- Физических лиц (по ФИО + дате рождения).\n- Юридических лиц (по ИНН-10 / ОГРН-13).\n- Индивидуальных предпринимателей (по ИНН-12 / ОГРНИП-15).\n\nЧасть семейства MCP-серверов **atomno** для due-diligence по российским контрагентам:\n[`mcp-egrul`](https://github.com/atomno-mcp/mcp-egrul) (реквизиты юр.лиц) ·\n[`mcp-fns-check`](https://github.com/atomno-mcp/mcp-fns-check) (налоговая благонадёжность) ·\n[`mcp-cbr-rates`](https://github.com/atomno-mcp/mcp-cbr-rates) (курсы ЦБ) ·\n**`mcp-fssp`** (долги в ФССП).\n\n## Зачем\n\nОфициальный API ФССП (`api-ip.fssp.gov.ru`) **отключён с 10 марта 2022 года** и не планируется к восстановлению. Единственная официальная точка — публичный web-сервис `fssp.gov.ru/iss/ip` с CAPTCHA. Это создаёт нишу: MCP-обёртка с поддержкой нескольких коммерческих провайдеров (Damia / Checko / NewDB / api-cloud) и нормализованной моделью данных.\n\nГлавные кейсы:\n\n- **AI-агент в Cursor / Claude Desktop** делает due-diligence контрагента в чате за 30 секунд вместо 10 минут на ручной обход сайта ФССП.\n- **Юристы / банки / скоринг** интегрируют единый `check_*_debts` вызов в свои Python-скрипты или 1С, не разбирая сырые ответы 3-4 разных провайдеров.\n- **Self-host энтузиасты** ставят клиент локально со своим ключом Damia/Checko и работают без зависимости от стороннего SaaS — снимает паранойю об утечке ПДн.\n\n## Quick start\n\n### 1. Установить\n\n```bash\n# Через pipx (рекомендуется для CLI):\npipx install atomno-mcp-fssp\n\n# Или через uv (быстрее):\nuvx atomno-mcp-fssp\n\n# Или классически через pip:\npip install atomno-mcp-fssp\n```\n\n### 2. Получить ключ провайдера\n\nМинимум один из:\n\n- **Damia** (https://api-fssp.damia.ru) — основной кандидат для prod. От 7 000 ₽/год за 1 000 запросов; 100 запросов бесплатно на тест.\n- **Checko** (https://api.checko.ru) — до 50 запросов/день бесплатно. Хорош для onboarding.\n- **NewDB** (https://newdb.net/fssp/api) — бюджетная альтернатива, 2 ₽/запрос, 100 free.\n- **api-cloud** (https://api-cloud.ru/api/fssp.php) — per-request оплата.\n\n### 3. Конфиг\n\nСоздай `.env` в рабочей директории (или передай переменные через MCP-конфиг):\n\n```ini\nMCP_FSSP_PROVIDER=damia\nMCP_FSSP_DAMIA_KEY=ваш_ключ_от_Damia\n```\n\nПолный список переменных — см. [`.env.example`](.env.example).\n\n### 4. Подключить к Cursor\n\nОткрой `~/.cursor/mcp.json` (или Settings → MCP) и добавь:\n\n```json\n{\n  \"mcpServers\": {\n    \"fssp\": {\n      \"command\": \"uvx\",\n      \"args\": [\"atomno-mcp-fssp\"],\n      \"env\": {\n        \"MCP_FSSP_PROVIDER\": \"damia\",\n        \"MCP_FSSP_DAMIA_KEY\": \"ваш_ключ\"\n      }\n    }\n  }\n}\n```\n\nПерезапусти Cursor. Теперь AI-агент может вызывать `fssp.check_individual_debts(...)`, `fssp.check_legal_entity_debts(...)` и `fssp.get_proceeding_details(...)`.\n\n### 5. Подключить к Claude Desktop\n\nОткрой `claude_desktop_config.json` и добавь:\n\n```json\n{\n  \"mcpServers\": {\n    \"fssp\": {\n      \"command\": \"uvx\",\n      \"args\": [\"atomno-mcp-fssp\"],\n      \"env\": {\n        \"MCP_FSSP_PROVIDER\": \"damia\",\n        \"MCP_FSSP_DAMIA_KEY\": \"ваш_ключ\"\n      }\n    }\n  }\n}\n```\n\n## Доступные инструменты\n\n| Инструмент | Назначение |\n|---|---|\n| `ping` | Проверка готовности сервера и текущего провайдера. |\n| `check_individual_debts(fio, birth_date, region?)` | Список открытых ИП по физ.лицу. |\n| `check_legal_entity_debts(inn?, ogrn?)` | Список открытых ИП по юр.лицу или ИП-предпринимателю. |\n| `get_proceeding_details(proceeding_id)` | Детальная карточка одного ИП по номеру. |\n\nВ Pro-версии (Phase 3+, требует `ATOMNO_API_KEY`):\n\n- `summarize_debts(...)` — AI-summary долгов с категоризацией и risk-score.\n- `monitor_debts_changes(...)` — подписка на изменения с webhook/Telegram-алёртами.\n\n## Переменные окружения\n\n| Переменная | Назначение | По умолчанию |\n|---|---|---|\n| `MCP_FSSP_PROVIDER` | Провайдер: `damia` / `checko` / `newdb` / `api_cloud` / `self_parser` / `atomno_pro` | `damia` |\n| `MCP_FSSP_DAMIA_KEY` | Ключ Damia API-ФССП | — |\n| `MCP_FSSP_CHECKO_KEY` | Ключ Checko v2 | — |\n| `MCP_FSSP_NEWDB_KEY` | Ключ NewDB | — |\n| `MCP_FSSP_API_CLOUD_KEY` | Ключ api-cloud.ru | — |\n| `ATOMNO_API_KEY` | Ключ Pro-режима (api.atomno-mcp.ru/fssp/) | — |\n| `ATOMNO_API_BASE` | URL Pro-backend | `https://api.atomno-mcp.ru/mcp-fssp/v1` |\n| `MCP_FSSP_HTTP_TIMEOUT` | Таймаут одного запроса в секундах | `15` |\n| `MCP_FSSP_RPS` | Лимит запросов в минуту со стороны клиента | `30` |\n| `MCP_FSSP_USER_AGENT` | User-Agent для запросов | `mcp-fssp/0.1 (...)` |\n| `MCP_FSSP_AUDIT_DB` | Путь к SQLite-аудит-логу | `./audit.sqlite` |\n| `MCP_FSSP_LOG_LEVEL` | Уровень логов: `DEBUG`/`INFO`/`WARNING`/`ERROR` | `INFO` |\n\n## Безопасность и ПДн\n\n- ПДн (ФИО, дата рождения) **не сохраняются** в plain-text. Audit-лог хранит только `sha256(fio_lower + birth_date)`.\n- Согласно [229-ФЗ ст. 6.1](https://www.consultant.ru/document/cons_doc_LAW_71450/), сведения из банка данных исполнительных производств являются **открытыми** и доступны без согласия должника.\n- Тем не менее, при использовании в коммерческих целях оператор обязан соблюдать [152-ФЗ](https://www.consultant.ru/document/cons_doc_LAW_61801/). Использование в законных целях (например, due-diligence перед сделкой, скоринг по согласию заёмщика) — на стороне пользователя.\n\n## Disclaimer\n\nСервис — **агрегатор и удобный интерфейс над публичными данными ФССП** (229-ФЗ ст. 6.1). **Не аффилирован с ФССП России**, Damia, Checko, NewDB, api-cloud и другими провайдерами. Используется на ваш риск.\n\nИнформация, возвращаемая инструментами, носит **справочный характер** и не заменяет официальные документы, выдаваемые ФССП. Авторы не отвечают за актуальность, полноту и точность данных провайдеров. Ответственность за законность использования сведений (в т.ч. соблюдение 152-ФЗ при обработке ПДн) — на пользователе.\n\nПри принятии юридически значимых решений (например, об отказе в кредите) необходимо запрашивать первичные документы у самого должника или через официальные каналы (запрос в подразделение приставов).\n\n## Roadmap\n\n- **v0.1** (текущая) — Phase 0 scaffold + Damia-провайдер + `check_individual_debts`.\n- **v0.2** — multi-provider (+Checko, NewDB, api-cloud), `check_legal_entity_debts`, `get_proceeding_details`, локальный кэш L1.\n- **v0.3+** — `self_parser` через CAPTCHA-solver.\n- **v0.5** — интеграция с Pro-backend (`api.atomno-mcp.ru/fssp/`): `summarize_debts`, `monitor_debts_changes`, кэш L2 на 30 дней, fallback по 3 провайдерам.\n\nДокументация по инструментам и переменным окружения — в этом README и в [CHANGELOG.md](CHANGELOG.md). После публикации — также на GitHub: `atomno-mcp/mcp-fssp`.\n\n## Лицензия\n\n[MIT](LICENSE) © 2026 atomno.\n\nPro-backend (`atomno-mcp/mcp-fssp-server`) — **запланирован на Phase 2** (приватный hosted-сервис с проприетарной лицензией). Open-клиент полностью функционален без него — пользователь подставляет свой ключ любого из 4 коммерческих провайдеров.\n\n## Ссылки\n\n- Спецификация ФССП API (исторически): [api-ip.fssp.gov.ru](https://api-ip.fssp.gov.ru) (отключён с 10.03.2022).\n- Web-сервис ФССП: [fssp.gov.ru/iss/ip](https://fssp.gov.ru/iss/ip).\n- Каталог MCP: [glama.ai/mcp/servers](https://glama.ai/mcp/servers).\n- MCP-спецификация: [modelcontextprotocol.io](https://modelcontextprotocol.io/spec).\n",
  "bytes": 7831,
  "sha": "0e04433d1809b021ec96da9b21a2e8f8964b5ddf0a10c7019eca4c2f5393d32d",
  "repo_slug": "atomno-mcp/mcp-fssp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_atomno_mcp_mcp_fssp_fe43ad05/readme"
}