A Model Context Protocol (MCP) server that provides Russian tax calculators and fiscal-status checks for AI agents. It offers offline, local calculations for accountants, individual entrepreneurs (IP), and small businesses, using built-in formulas and references to the Russian Tax Code.

🛠️ Key Features

Local MCP server implementing tax calculators: calc_vat, calc_usn, calc_insurance_ip
Fiscal-status checks aligned with MCP for AI agents
Offline operation with no external keys required
Readme excerpts and formulas mapped to NК РФ articles

🚀 Use Cases

AI assistants performing VAT, USN, and insurance calculations
Tax planning and fiscal-status verification for small businesses
MCP client integrations in accounting workflows

⚡ Developer Benefits

Clear MCP-compliant endpoints for tax calculation
Grounded in formal tax formulas and articles
Lightweight, offline-ready for secure environments

⚠️ Limitations

Source data excerpt indicates partial formula coverage; may require updates for full tax rule coverage
Russian tax rules subject to change; verify against official sources periodically

atomno-mcp-fns-calc

Налоговый калькулятор РФ прямо в AI-ассистенте — Russian tax math & fiscal-status checks for AI agents (Cursor, Claude Desktop, Cline, and any MCP client).

MCP-сервер (Model Context Protocol) для бухгалтеров, ИП и малого бизнеса. 6 калькуляторов работают локально и офлайн, без ключа, с формулой и ссылкой на статью НК РФ: calc_vat (НДС 20/10/0 и спец-ставки 5/7), calc_usn (доходы 6% и доходы-минус-расходы 15% с минимальным налогом и вычетом взносов), calc_insurance_ip (фиксвзносы ИП + 1% с дохода свыше 300 000 ₽, неполный год), calc_ndfl (прогрессивная шкала 2025+ 13/15/18/20/22% с разбивкой по ступеням), calc_patent (ПСН), calc_penalty (пени по ключевой ставке ЦБ, 1/300 и 1/150). Плюс get_rates — актуальные ставки и лимиты.

Ещё 5 live-проверок фискальных статусов (через hosted-API, тариф Pro): check_selfemployed (самозанятый/НПД по ИНН — обязательная проверка перед выплатой физлицу), check_ip_status (ИП/ОКВЭД из ЕГРИП), check_disqualified, check_account_block, check_tax_arrears.

Калькуляторы — бесплатно и офлайн. Live-проверки и всегда-свежие ставки берём с hosted-бэкенда Atomno MCP (данные ФНС на дату запроса, ничего парсить не нужно) — для них нужен API-ключ: atomno-mcp.ru/pricing.

Каждый ответ содержит дисклеймер и ссылку на первоисточник. Не является налоговой консультацией.

Быстрый старт

bash

uvx atomno-mcp-fns-calc            # запустить без установки
# или
pipx install atomno-mcp-fns-calc

mcp.json (Cursor / Claude Desktop) — калькуляторы работают сразу, без ключа:

json

{
  "mcpServers": {
    "fns-calc": {
      "command": "uvx",
      "args": ["atomno-mcp-fns-calc"],
      "env": { "MCP_FNS_CALC_TOKEN": "<ключ для live-проверок, опционально>" }
    }
  }
}

Переменные окружения

Переменная	Описание	Обязательна
`MCP_FNS_CALC_TOKEN`	API-ключ (тариф Pro) для live-проверок статусов и свежих ставок	нет (калькуляторы работают без него)
`MCP_FNS_CALC_API_BASE`	Базовый URL hosted-бэкенда	нет
`MCP_FNS_CALC_TIMEOUT`	Таймаут HTTP, сек (default 30)	нет

Инструменты

Тул	Тип	Что делает
`calc_vat`	офлайн	НДС: начислить сверху / выделить из суммы
`calc_usn`	офлайн	УСН доходы 6% / доходы-расходы 15% + мин.налог
`calc_insurance_ip`	офлайн	Взносы ИП «за себя» + 1% сверх 300k
`calc_ndfl`	офлайн	НДФЛ по прогрессивной шкале 2025+
`calc_patent`	офлайн	Стоимость патента (ПСН)
`calc_penalty`	офлайн	Пени по ключевой ставке ЦБ РФ
`get_rates`	офлайн/hosted	Ставки и лимиты (снапшот или свежие)
`check_selfemployed`	hosted (Pro)	Статус самозанятого (НПД) по ИНН
`check_ip_status`	hosted (Pro)	Статус ИП и ОКВЭД из ЕГРИП
`check_disqualified`	hosted (Pro)	Реестр дисквалифицированных лиц
`check_account_block`	hosted (Pro)	Приостановление операций по счетам
`check_tax_arrears`	hosted (Pro)	Недоимки / задолженность

Дисклеймер

Инструмент расчётов и доступа к открытым данным ФНС. Не является налоговой, бухгалтерской или юридической консультацией. Ставки и лимиты меняются — проверяйте актуальность по НК РФ и официальным сервисам ФНС / Банка России. Не аффилирован с ФНС.

Лицензия

MIT.

mcp-fns-calc