mcpField
M
mcp-fns-calc

mcp-fns-calc

Local
github.com/atomno-mcpFinance1Updated 8w ago
Repository

About mcp-fns-calc

mcp-fns-calc provides Russian tax calculations and Federal Tax Service status checks for accountants, sole proprietors, and small businesses. Six calculators run offline and include formulas and tax-code references; live checks and current rates require an API key.

Key features

  1. 01Calculate VAT, simplified tax, and sole proprietor contributions
  2. 02Calculate progressive personal income tax
  3. 03Calculate patent tax and late-payment penalties
  4. 04Check Federal Tax Service statuses
  5. 05Retrieve tax rates and limits

Use cases

  1. 01Calculate business taxes and sole proprietor contributions
  2. 02Verify self-employed status before making a payment
  3. 03Check sole proprietor and tax-arrears status

MCP support

As an MCP server, it provides AI clients with tax calculation, rate lookup, and fiscal-status checking tools. Calculators work offline; live checks and current rates use a hosted API and require an API key.

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
  "mcpServers": {
    "atomno-mcp-mcp-fns-calc": {
      "command": "uvx",
      "args": [
        "atomno-mcp-fns-calc"
      ],
      "env": {
        "MCP_FNS_CALC_TOKEN": "<MCP_FNS_CALC_TOKEN>"
      }
    }
  }
}
Run commanduvx atomno-mcp-fns-calc
Environment variables to set
MCP_FNS_CALC_TOKENSecretAPI key (Pro tier) for live fiscal-status checks and fresh rates. Calculators work without it.

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
pypiatomno-mcp-fns-calc0.1.7

Tools

12

Saved tool list · updated 2w ago

ParameterTypeRequiredDescription
modestringNoadd — add on top; extract — extract from the amount.
ratenumberNoVAT rate: 20/10/0 or special 5/7 (USN from 2025).
amountnumberYesСумма (без НДС для add, с НДС для extract).

Details

From the project 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.

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

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

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.

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.