mcp-fns-calc
Russian tax calculators (VAT, USN, NDFL) and FNS fiscal-status checks via MCP.
Open source Open in the app JSON README (API)
About
Russian tax calculators (VAT, USN, NDFL) and FNS fiscal-status checks via MCP.
Details
- Kind
- MCP servers
- Topic
- Finance & crypto
- Publisher
- atomno-mcp
- Origin
- official
- Category
- ferramentas
- Transport
- local
- Version
- 0.1.7
- Stars
- 1
- Last push
- 2026-09-02T10:35:29Z
- Repository state
- ativo
- Language
- Python
- License
- MIT
- Added
- 2026-08-29 03:02:27
- Updated
- 2026-09-02 11:00:51
- Origin id
io.github.atomno-mcp/mcp-fns-calc
README
<!-- mcp-name: io.github.atomno-mcp/mcp-fns-calc -->
# atomno-mcp-fns-calc
Налоговый калькулятор РФ прямо в ассистенте: НДС, УСН, взносы ИП, НДФЛ, патент и пени. Шесть расчётов работают без интернета и без ключа — с формулой и ссылкой на статью НК РФ. Для бухгалтеров, ИП и малого бизнеса.
Russian tax calculator for AI agents.
MCP-сервер для бухгалтеров, ИП и малого бизнеса. **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](https://atomno-mcp.ru/pricing#fns-calc-pro).
Каждый ответ содержит **дисклеймер** и ссылку на первоисточник. Не является налоговой
консультацией.
## Быстрый старт
```bash
uvx atomno-mcp-fns-calc # запустить без установки
# или
pipx install atomno-mcp-fns-calc
```
`mcp.json` (Cursor / Claude Desktop) — калькуляторы работают сразу, без ключа:
```json
{
"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.