Вкратце
MCP-сервер для проверки исполнительных производств у ФССП — задолженности, аресты, ограничения на выезд. Используется для KYC, скоринга, due-diligence физлиц и юрлиц.
Источник данных: ФССП России (fssp.gov.ru) . Atomno Labs не аффилирован с провайдером.
Установка
Один сниппет — поддержка Cursor, Claude Desktop, Claude Code, Cline, Continue.
Добавьте в ~/.cursor/mcp.json (или .cursor/mcp.json в проекте):
{
"mcpServers": {
"atomno-fssp": {
"command": "uvx",
"args": ["atomno-mcp-fssp"],
"env": {
"MCP_FSSP_TOKEN": "<your-value>"
}
}
}
}
Добавьте в ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) или %APPDATA%\Claude\claude_desktop_config.json (Windows):
{
"mcpServers": {
"atomno-fssp": {
"command": "uvx",
"args": ["atomno-mcp-fssp"],
"env": {
"MCP_FSSP_TOKEN": "<your-value>"
}
}
}
}В терминале (Claude Code CLI):
claude mcp add atomno-fssp -- uvx atomno-mcp-fssp -e MCP_FSSP_TOKEN=<your-value>
Для Cline (VS Code) — в cline_mcp_settings.json.
Для Continue — в ~/.continue/config.yaml:
{
"mcpServers": {
"atomno-fssp": {
"command": "uvx",
"args": ["atomno-mcp-fssp"],
"env": {
"MCP_FSSP_TOKEN": "<your-value>"
}
}
}
}Конфигурация (env vars)
| Переменная | Описание | Где взять | Required | Default |
|---|---|---|---|---|
| MCP_FSSP_TOKEN | API token Atomno Labs hosted backend | ссылка ↗ | yes | — |
| MCP_FSSP_LOG_LEVEL | Уровень логирования | — | no | INFO |
Тулзы MCP-сервера
Сервер регистрирует 3 тула для AI-агента. Все валидируются через Pydantic v2.
check_individual async tool Проверка физлица по ФИО + дате рождения.
full_name: str, birth_date: str (YYYY-MM-DD), region?: str list[Proceeding { id, debt_amount, debtor, status, started_at }] check_legal_entity async tool Проверка юрлица по ИНН.
inn: str list[Proceeding] check_travel_restriction async tool Ограничение на выезд за рубеж (Pro).
full_name: str, birth_date: str TravelRestriction { restricted, until, reason } Open-core: Free vs Pro
Клиент-MCP — open-source MIT, бесплатный. Pro-tier — hosted backend с дополнительными возможностями: без лимитов rate-limiting'а, bulk-операции, аудит, webhooks.
| Возможность | Free (open-source) | Pro (hosted) |
|---|---|---|
| Базовые проверки | 50/день | Без лимитов |
| Travel-restriction check | — | ✓ |
| Bulk | — | До 1000 за раз |
Pro-tier — hosted backend без лимитов и с дополнительными возможностями.
Запросить Pro-доступПримеры использования
Реальные prompt'ы для AI-агента в Cursor / Claude Code:
- check_individual: «Используй mcp-fssp тул
check_individualи проверка физлица по фио + дате рождения.» - check_legal_entity: «Используй mcp-fssp тул
check_legal_entityи проверка юрлица по инн.» - check_travel_restriction: «Используй mcp-fssp тул
check_travel_restrictionи ограничение на выезд за рубеж (pro).»
Troubleshooting
1. uvx не найден
Установите uv: pipx install uv (или pip install uv).
После этого uvx доступен в PATH.
2. MCP не подцепился в Cursor
Проверьте: ~/.cursor/mcp.json — валидный JSON. Перезапустите Cursor полностью
(Quit, не просто закрытие окна). В Settings → MCP должна появиться зелёная точка.
3. Ошибка авторизации (401 / 403)
Проверьте переменные окружения MCP_FSSP_TOKEN.
Они должны быть доступны в окружении процесса Cursor (часто требует перезапуска IDE
после установки переменных).
Полный troubleshooting-гайд → /docs/troubleshooting
FAQ
Как установить mcp-fssp? +
Какой Python нужен? +
Что нужно настроить перед запуском? +
Это open-source? +
Где сообщить о баге? +
Чем Pro отличается от free? +
Changelog
Версия пока не опубликована — проект в active development. Полная история — GitHub Releases.
Source code & issues
- GitHub: atomno-labs/mcp-fssp
- Issues: atomno-labs/mcp-fssp/issues
- Discussions: atomno-labs/mcp-fssp/discussions
Disclaimer
Atomno Labs не аффилирован с ФССП России (fssp.gov.ru). mcp-fssp использует публичные / коммерческие интерфейсы провайдера. Ответственность за соблюдение лимитов и ToS провайдера — на пользователе. Лицензия: MIT.