Вкратце
MCP-сервер: офлайн-калькуляторы (НДС, УСН, взносы ИП, НДФЛ 2025+, патент, пени) и live-проверки через hosted API (самозанятый/НПД, ИП/ОКВЭД, дисквалификация, блокировки, недоимки). Open-core: клиент MIT + приватный backend.
Источник данных: ФНС России . Atomno MCP не аффилирован с провайдером.
Установка
Один сниппет — поддержка Cursor, Claude Desktop, Claude Code, Cline, Continue.
Добавьте в ~/.cursor/mcp.json (или .cursor/mcp.json в проекте):
{
"mcpServers": {
"atomno-fns-calc": {
"command": "uvx",
"args": ["atomno-mcp-fns-calc"]
}
}
}
Добавьте в ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) или %APPDATA%\Claude\claude_desktop_config.json (Windows):
{
"mcpServers": {
"atomno-fns-calc": {
"command": "uvx",
"args": ["atomno-mcp-fns-calc"]
}
}
}В терминале (Claude Code CLI):
claude mcp add atomno-fns-calc -- uvx atomno-mcp-fns-calc
Для Cline (VS Code) — в cline_mcp_settings.json.
Для Continue — в ~/.continue/config.yaml:
{
"mcpServers": {
"atomno-fns-calc": {
"command": "uvx",
"args": ["atomno-mcp-fns-calc"]
}
}
}Конфигурация (переменные окружения)
| Переменная | Описание | Где взять | Required | Default |
|---|---|---|---|---|
| MCP_FNS_CALC_API_KEY | Ключ Pro для live-проверок статусов | ссылка ↗ | no | — |
| MCP_FNS_CALC_LOG_LEVEL | Уровень логирования | — | no | INFO |
Инструменты MCP-сервера
Сервер регистрирует 3 инструмента для AI-агента. Все входные данные строго проверяются.
calc_vat async tool Расчёт НДС (offline).
amount: float, rate: float VatResult check_selfemployed async tool Статус плательщика НПД (hosted Pro).
inn: str SelfemployedStatus check_disqualified async tool Реестр дисквалифицированных лиц (hosted Pro).
inn?: str, fio?: str DisqualifiedMatch Бесплатно и Pro
Клиент — с открытым кодом под MIT, бесплатный. Тариф Pro — размещение на нашей стороне с дополнительными возможностями: без лимитов, массовые операции, аудит, уведомления о событиях.
| Возможность | Бесплатно (открытый код) | Pro (на нашей стороне) |
|---|---|---|
| Калькуляторы | ✓ offline | ✓ |
| Live-проверки ФНС | — | ✓ |
Тариф Pro — размещение на нашей стороне без лимитов и с дополнительными возможностями.
Запросить Pro-доступПримеры использования
Реальные запросы для AI-агента в Cursor / Claude Code:
- calc_vat: «Используй mcp-fns-calc инструмент
calc_vatи расчёт ндс (offline).» - check_selfemployed: «Используй mcp-fns-calc инструмент
check_selfemployedи статус плательщика нпд (hosted pro).» - check_disqualified: «Используй mcp-fns-calc инструмент
check_disqualifiedи реестр дисквалифицированных лиц (hosted pro).»
Решение проблем
1. uvx не найден
Установите uv: pipx install uv (или pip install uv).
После этого uvx доступен в PATH.
2. MCP не подцепился в Cursor
Проверьте: ~/.cursor/mcp.json — валидный JSON. Перезапустите Cursor полностью
(Quit, не просто закрытие окна). В Settings → MCP должна появиться зелёная точка.
Полное руководство по решению проблем → /docs/troubleshooting
FAQ
Как установить mcp-fns-calc? +
Какой Python нужен? +
Это открытый код? +
Где сообщить об ошибке? +
Чем Pro отличается от бесплатной версии? +
Changelog
Версия пока не опубликована — проект в активной разработке. Полная история — GitHub Releases.
Исходный код и задачи
- GitHub: atomno-mcp/mcp-fns-calc
- Issues: atomno-mcp/mcp-fns-calc/issues
- Discussions: atomno-mcp/mcp-fns-calc/discussions
Правовая оговорка
Atomno MCP не аффилирован с ФНС России. mcp-fns-calc использует публичные / коммерческие интерфейсы источника. Ответственность за соблюдение лимитов и условий использования источника — на пользователе. Лицензия: MIT.