Вкратце
MCP-сервер для KYC и due-diligence: проверка ИНН/ОГРН, статус юрлица, реквизиты из ЕГРЮЛ/ЕГРИП, признаки массового адреса/директора, дисквалификация. Open-core: бесплатный клиент + hosted backend на Pro tier.
Источник данных: ФНС России (egrul.nalog.ru) . Atomno Labs не аффилирован с провайдером.
Установка
Один сниппет — поддержка Cursor, Claude Desktop, Claude Code, Cline, Continue.
Добавьте в ~/.cursor/mcp.json (или .cursor/mcp.json в проекте):
{
"mcpServers": {
"atomno-fns-check": {
"command": "uvx",
"args": ["atomno-mcp-fns-check"]
}
}
}
Добавьте в ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) или %APPDATA%\Claude\claude_desktop_config.json (Windows):
{
"mcpServers": {
"atomno-fns-check": {
"command": "uvx",
"args": ["atomno-mcp-fns-check"]
}
}
}В терминале (Claude Code CLI):
claude mcp add atomno-fns-check -- uvx atomno-mcp-fns-check
Для Cline (VS Code) — в cline_mcp_settings.json.
Для Continue — в ~/.continue/config.yaml:
{
"mcpServers": {
"atomno-fns-check": {
"command": "uvx",
"args": ["atomno-mcp-fns-check"]
}
}
}Конфигурация (env vars)
| Переменная | Описание | Где взять | Required | Default |
|---|---|---|---|---|
| MCP_FNS_CHECK_TOKEN | API token Atomno Labs hosted backend (для Pro tier) | ссылка ↗ | no | — |
| MCP_FNS_CHECK_LOG_LEVEL | Уровень логирования | — | no | INFO |
Тулзы MCP-сервера
Сервер регистрирует 4 тула для AI-агента. Все валидируются через Pydantic v2.
check_inn async tool Проверка ИНН: статус, реквизиты, риски.
inn: str CompanyData { inn, ogrn, name, status, risks[], address } check_ogrn async tool Проверка по ОГРН.
ogrn: str CompanyData mass_address_check async tool Признак массового адреса регистрации.
address: str MassAddressInfo { is_mass, count, risk_level } director_disqualification async tool Проверка дисквалификации директора.
inn: str | full_name: str DisqualificationInfo Open-core: Free vs Pro
Клиент-MCP — open-source MIT, бесплатный. Pro-tier — hosted backend с дополнительными возможностями: без лимитов rate-limiting'а, bulk-операции, аудит, webhooks.
| Возможность | Free (open-source) | Pro (hosted) |
|---|---|---|
| Лимит запросов | 10/мин (rate-limit ФНС) | Без лимитов (hosted backend, кэш) |
| История проверок | — | Audit log + экспорт |
| Bulk-проверка | — | До 10 000 ИНН за раз |
| Интеграция | Stdio MCP | Stdio + HTTP API + webhooks |
Pro-tier — hosted backend без лимитов и с дополнительными возможностями.
Запросить Pro-доступПримеры использования
Реальные prompt'ы для AI-агента в Cursor / Claude Code:
- check_inn: «Используй mcp-fns-check тул
check_innи проверка инн: статус, реквизиты, риски.» - check_ogrn: «Используй mcp-fns-check тул
check_ogrnи проверка по огрн.» - mass_address_check: «Используй mcp-fns-check тул
mass_address_checkи признак массового адреса регистрации.»
Troubleshooting
1. uvx не найден
Установите uv: pipx install uv (или pip install uv).
После этого uvx доступен в PATH.
2. MCP не подцепился в Cursor
Проверьте: ~/.cursor/mcp.json — валидный JSON. Перезапустите Cursor полностью
(Quit, не просто закрытие окна). В Settings → MCP должна появиться зелёная точка.
Полный troubleshooting-гайд → /docs/troubleshooting
FAQ
Как установить mcp-fns-check? +
Какой Python нужен? +
Это open-source? +
Где сообщить о баге? +
Чем Pro отличается от free? +
Changelog
Текущая версия: v0.1.1. Полная история — GitHub Releases.
Source code & issues
- GitHub: atomno-labs/mcp-fns-check
- PyPI: atomno-mcp-fns-check
- Issues: atomno-labs/mcp-fns-check/issues
- Discussions: atomno-labs/mcp-fns-check/discussions
Disclaimer
Atomno Labs не аффилирован с ФНС России (egrul.nalog.ru). mcp-fns-check использует публичные / коммерческие интерфейсы провайдера. Ответственность за соблюдение лимитов и ToS провайдера — на пользователе. Лицензия: MIT.