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.5.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.5-py3-none-any.whl (21.6 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: atomno_mcp_fns_calc-0.1.5.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.5.tar.gz
Algorithm Hash digest
SHA256 872cc99336671c9e8e4593b02e9f5d08130a211cd983eed4e4065fc2140153f6
MD5 67e369d9455cea5c966b332ef27d165a
BLAKE2b-256 27417c8a8f3a8c4c7e6f02c52ef471c871379a5779fae5a497bb652b1d1d7f73

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for atomno_mcp_fns_calc-0.1.5-py3-none-any.whl
Algorithm Hash digest
SHA256 7fec99b948448db41623dbde60f3886e9674ae390b1b5a43e429f85117213c5e
MD5 882451c1480cc70e9c681af96d53dc6e
BLAKE2b-256 225b66bd67d98170bf42f70c922aa0d230e6d47794cf92e78dcc98efc30096d5

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