mcp-fns-calc

<!-- 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.