Skip to main content

MCP server: Russian tax calculators (VAT, USN, ИП contributions, progressive NDFL 2025+, patent, penalty) offline + fiscal-status checks (self-employed/НПД, ИП/ОКВЭД, disqualified, account blocks, arrears) via hosted API.

Project description

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.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

atomno_mcp_fns_calc-0.1.0.tar.gz (20.3 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

atomno_mcp_fns_calc-0.1.0-py3-none-any.whl (20.2 kB view details)

Uploaded Python 3

File details

Details for the file atomno_mcp_fns_calc-0.1.0.tar.gz.

File metadata

  • Download URL: atomno_mcp_fns_calc-0.1.0.tar.gz
  • Upload date:
  • Size: 20.3 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.11.4

File hashes

Hashes for atomno_mcp_fns_calc-0.1.0.tar.gz
Algorithm Hash digest
SHA256 7de3ba2a12b7513e8bd4c1fe0082c37b8ff60487d609f52888fbc138b4acb58c
MD5 59d8462dbdd70b8b8b7812d4ff24daf6
BLAKE2b-256 e9f28609a41aa82104863c8380ba7a1c93217dcc968d2acee4acbd2a8728b291

See more details on using hashes here.

File details

Details for the file atomno_mcp_fns_calc-0.1.0-py3-none-any.whl.

File metadata

File hashes

Hashes for atomno_mcp_fns_calc-0.1.0-py3-none-any.whl
Algorithm Hash digest
SHA256 0a7b439cc75b541da397697387d7b88d5492c2fe6e7712934361b018eef11c56
MD5 be0402d3ed29b2829e6a5bcc51f90518
BLAKE2b-256 24b90ea4594ce95fedec566736f39fc6e67f5369ebde7ab3883c8127f4b2f9cf

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page