mcp-fns-calc

io.github.atomno-mcpPublished by GitHub account atomno-mcpv0.1.7Updated Oct 24, 2026

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

The publisher's own server: calc.engineer

VerifiedSTDIODesktop onlyFinanceBusiness & Commerce

Overview

AI-generated overview

Russian tax calculator MCP server: offline VAT, USN, IP contributions, NDFL, patent and penalty calculations, plus optional paid FNS status checks.

What you can do
  • Calculate VAT, USN, individual-entrepreneur contributions, progressive NDFL, patent cost and late-payment penalties offline, each with the formula and a tax-code article reference
  • Look up current rates and limits, either from a bundled snapshot or fresh from the hosted backend
  • Run live fiscal-status checks by INN: self-employed (NPD) status, sole-trader status and OKVED from the register, disqualification list, account blocking and tax arrears
  • Return a disclaimer and source reference with each answer
When to use it
Useful for accountants, sole traders and small businesses in Russia that want quick tax estimates and pre-payment checks of a counterparty's fiscal status inside an assistant, without leaving the chat.
Requirements
Runs locally as a Python package via uvx or pipx (stdio). The six calculators and the snapshot rates work offline with no key. Live status checks and fresh rates need a Pro API key in MCP_FNS_CALC_TOKEN and network access to the hosted backend; optional MCP_FNS_CALC_API_BASE and MCP_FNS_CALC_TIMEOUT variables.
Before you install
Live checks send taxpayer INNs to a third-party hosted backend and require a paid Pro subscription. Results are not tax, accounting or legal advice, and rates and limits change, so verify against official FNS and Bank of Russia sources. Not affiliated with the FNS.

Installation

In SourceWeft

  1. Open mcp-fns-calc in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

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.

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

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

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_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.

Source: README.md at commit 7a3912f

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v0.1.7LatestSep 16, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts

Other Calc integrations