mcp-fns-calc

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

OtherPythonv0.1.7

atomno-mcp-fns-calc

Налоговый калькулятор РФ прямо в ассистенте: НДС, УСН, взносы ИП, НДФЛ, патент и пени. Шесть расчётов работают без интернета и без ключа — с формулой и ссылкой на статью НК РФ. Для бухгалтеров, ИП и малого бизнеса.

Russian tax calculator for AI agents.

MCP-сервер для бухгалтеров, ИП и малого бизнеса. 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_TOKENAPI-ключ (тариф 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_selfemployedhosted (Pro)Статус самозанятого (НПД) по ИНН
check_ip_statushosted (Pro)Статус ИП и ОКВЭД из ЕГРИП
check_disqualifiedhosted (Pro)Реестр дисквалифицированных лиц
check_account_blockhosted (Pro)Приостановление операций по счетам
check_tax_arrearshosted (Pro)Недоимки / задолженность

Дисклеймер

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

Лицензия

MIT.

Installation

Source-derived launch command. Check the maintainer’s required arguments and credentials before running:

bash
uvx atomno-mcp-fns-calc

Set up in your AI client

Merge this template into ~/Library/Application Support/Claude/claude_desktop_config.json. Keep existing servers. Add any arguments, credentials, and permissions required by the maintainer; this template has not been install-tested.

json
{
  "mcpServers": {
    "io-github-atomno-mcp-mcp-fns-calc": {
      "command": "uvx",
      "args": [
        "atomno-mcp-fns-calc"
      ]
    }
  }
}

Restart Claude Desktop completely for changes to take effect. Confirm the server appears connected in the client’s tool list, then try a read-only example from its documentation.

Claude Desktop setup reference

Package

atomno-mcp-fns-calcpypi

Compatible MCP Clients

mcp-fns-calc works with any MCP-compatible client. Copy the config snippet from the Configuration section above and add it to the file shown for your client, then restart the application.

  • Claude Desktop~/Library/Application Support/Claude/claude_desktop_config.jsonRestart Claude Desktop completely for changes to take effect.
  • Cursor~/.cursor/mcp.jsonRestart Cursor for changes to take effect.
  • VS Code.vscode/mcp.jsonReload VS Code window for changes to take effect.
  • Windsurf~/.codeium/windsurf/mcp_config.jsonRestart Windsurf for changes to take effect.
  • Claude Code.mcp.jsonSave at the project root, then start Claude Code in that project and review the MCP server approval prompt. Keep real credentials out of shared files.

Learn More