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.2.tar.gz (20.6 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.2-py3-none-any.whl (20.2 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: atomno_mcp_fns_calc-0.1.2.tar.gz
  • Upload date:
  • Size: 20.6 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.2.tar.gz
Algorithm Hash digest
SHA256 e53876b2ef60f060737de09b4cf2a2077a4b78ff3cde527b89f58f390cf643f2
MD5 331d47b9c1e221814d155da1d68928c6
BLAKE2b-256 3b5fb48f8f269b7a4e2edfe0ec7f12b02fe05156462e859b40bc34b1925a29f1

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for atomno_mcp_fns_calc-0.1.2-py3-none-any.whl
Algorithm Hash digest
SHA256 119d6ea55038bc3713cc17de153902f543217d421857481a30babf83fb058d33
MD5 ea7b8270363f26cd22dfb3db69e92715
BLAKE2b-256 212e87dc5577be39b53773c1efb7bc08ebb77ca47aeafa733664be9626fa87bb

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