Metadata-Version: 2.4
Name: atomno-mcp-fns-calc
Version: 0.1.4
Summary: 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-URL: Homepage, https://github.com/atomno-mcp/mcp-fns-calc
Project-URL: Repository, https://github.com/atomno-mcp/mcp-fns-calc
Project-URL: Issues, https://github.com/atomno-mcp/mcp-fns-calc/issues
Project-URL: Changelog, https://github.com/atomno-mcp/mcp-fns-calc/blob/main/CHANGELOG.md
Project-URL: Documentation, https://atomno-mcp.ru/mcp/fns-calc
Author-email: atomno-mcp <hello@atomno.ru>
License: MIT
License-File: LICENSE
Keywords: accounting,atomno,fintech,mcp,model-context-protocol,ndfl,russia,tax,usn,vat
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Financial and Insurance Industry
Classifier: License :: OSI Approved :: MIT License
Classifier: Natural Language :: Russian
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Office/Business :: Financial :: Accounting
Classifier: Typing :: Typed
Requires-Python: >=3.11
Requires-Dist: fastmcp<4.0.0,>=2.0.0
Requires-Dist: httpx<1.0.0,>=0.27.0
Requires-Dist: pydantic<3.0.0,>=2.6.0
Provides-Extra: dev
Requires-Dist: pytest-asyncio>=0.23.0; extra == 'dev'
Requires-Dist: pytest>=8.0.0; extra == 'dev'
Requires-Dist: respx>=0.21.1; extra == 'dev'
Requires-Dist: ruff>=0.5.0; extra == 'dev'
Provides-Extra: release
Requires-Dist: build>=1.2.0; extra == 'release'
Requires-Dist: twine>=5.1.0; extra == 'release'
Description-Content-Type: text/markdown

<!-- mcp-name: io.github.atomno-mcp/mcp-fns-calc -->

# 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](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.
