io.github.atomno-mcp/mcp-fns-calc icon

mcp-fns-calc

by Atomno-mcp

io.github.atomno-mcp/mcp-fns-calc

Russian tax calculators (VAT, USN, NDFL) and FNS fiscal-status checks via MCP.

Version 0.1.4 · latest
Finance
Local
View source

mcp-fns-calc · v0.1.4 (latest)

by Atomno-mcp

70

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.

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

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

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

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

{
  "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.