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.4.tar.gz (22.4 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.4-py3-none-any.whl (21.6 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: atomno_mcp_fns_calc-0.1.4.tar.gz
  • Upload date:
  • Size: 22.4 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.4.tar.gz
Algorithm Hash digest
SHA256 653f23c8a746bc78e9037cc1fbc05b0ec3fd1d4fe9d08f5bb23faaf86e7f552f
MD5 0589b767026f258715821bc952b71245
BLAKE2b-256 90e7fac190fce42713744ec368e3dc5534976aee8ed1c9df2774af04875d9d23

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for atomno_mcp_fns_calc-0.1.4-py3-none-any.whl
Algorithm Hash digest
SHA256 fc44044a21469e63d26786c96da035d566eb3a9c8ac7ea2b4190143d6c48eb31
MD5 bfc49cdfbdb91d35776a06f8c1b33db7
BLAKE2b-256 261957ee13e8404004c7977289f2db79875872531ca45ca5c98ef391e946a2f9

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