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
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
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
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
7de3ba2a12b7513e8bd4c1fe0082c37b8ff60487d609f52888fbc138b4acb58c
|
|
| MD5 |
59d8462dbdd70b8b8b7812d4ff24daf6
|
|
| BLAKE2b-256 |
e9f28609a41aa82104863c8380ba7a1c93217dcc968d2acee4acbd2a8728b291
|
File details
Details for the file atomno_mcp_fns_calc-0.1.0-py3-none-any.whl.
File metadata
- Download URL: atomno_mcp_fns_calc-0.1.0-py3-none-any.whl
- Upload date:
- Size: 20.2 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.11.4
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
0a7b439cc75b541da397697387d7b88d5492c2fe6e7712934361b018eef11c56
|
|
| MD5 |
be0402d3ed29b2829e6a5bcc51f90518
|
|
| BLAKE2b-256 |
24b90ea4594ce95fedec566736f39fc6e67f5369ebde7ab3883c8127f4b2f9cf
|