API статуса самозанятого по ИНН и справочник ставок ФНС

Что сервис отдаёт

Важно не перепутать два перечня. Таблица ниже — возможности MCP-сервера, пакета для ИИ-агентов; расчёты налогов в ней выполняются локально на машине пользователя. Адреса для обмена по HTTP — отдельным разделом дальше, и расчётов среди них нет.

• Опознание клиента — заголовок X-API-Key. Не перепутайте с проверкой контрагента: там другая схема, Authorization: Bearer.
• Ключ нужен всем адресам под /v1. Проверки живости и готовности открыты.
• Ограничение — суточная квота на ключ, по умолчанию 500 запросов. Поминутного ограничения в коде нет.
• Заголовков с остатком квоты сервис не присылает: об исчерпании клиент узнаёт только по отказу. Это в доработках.
• Ответы проверок кэшируются на час. В теле есть поле cached: false означает, что сходили к источнику.
• Справочник ставок — не живое обращение к налоговой службе, а выверенный список внутри пакета. Ставки стоит сверять с первоисточником.

Адреса запросов

Раньше на этом месте было написано, что публичного справочника путей нет. Это оказалось неверно: машинное описание интерфейса открыто без ключа по адресу /fns-calc/openapi.json, перечень выше снят оттуда и проверен запросами. Человекочитаемых страниц документации у сервиса нет — они отключены в коде. Обратите внимание, что приставку /fns-calc снимает шлюз, поэтому в машинном описании адреса начинаются сразу с /health и /v1.

Где под примером написано, что ответ настоящий, — он снят с боевого сервера и приведён как есть. Выдуманных ответов на этой странице нет.

        curl -H "X-API-Key: ВАШ_КЛЮЧ" https://api.atomno-mcp.ru/fns-calc/v1/rates

{
  "rates": {
    "ip_fixed_contrib": {"2024": 49500.0, "2025": 53658.0, "2026": 57390.0, "2027": 61154.0},
    "ip_1pct_cap": {"2024": 277571.0, "2025": 300888.0, "2026": 321818.0, "2027": 342923.0},
    "ndfl_scale": [
      {"up_to": 2400000.0, "rate": 13.0},
      {"up_to": 5000000.0, "rate": 15.0},
      {"up_to": 20000000.0, "rate": 18.0},
      {"up_to": 50000000.0, "rate": 20.0},
      {"up_to": null, "rate": 22.0}
    ],
    "usn_limits": {"2025": 450000000.0, "2026": 450000000.0},
    "cbr_key_rate": 21.0
  },
  "fetched_at": "2026-08-02T11:24:43.171252+00:00",
  "source": "ФНС/Банк России (выверенный реестр)",
  "disclaimer": "Данные ФНС на дату запроса. Не является налоговой, бухгалтерской или юридической консультацией; требуется ручная верификация. Не аффилировано с ФНС."
}
      

        curl -X POST https://api.atomno-mcp.ru/fns-calc/v1/status/selfemployed \
  -H "X-API-Key: ВАШ_КЛЮЧ" \
  -H "Content-Type: application/json" \
  -d '{"inn": "773371253640"}'

{
  "inn": "773371253640",
  "is_selfemployed": false,
  "message": "773371253640 не является плательщиком налога на профессиональный доход",
  "request_date": "2026-08-02",
  "source": "statusnpd.nalog.ru (ФНС)",
  "ready": true,
  "checked_at": "2026-08-02T11:27:06.098328+00:00",
  "disclaimer": "Данные ФНС на дату запроса. Не является налоговой, бухгалтерской или юридической консультацией; требуется ручная верификация. Не аффилировано с ФНС.",
  "cached": false
}
      

        curl -X POST https://api.atomno-mcp.ru/fns-calc/v1/status/arrears \
  -H "X-API-Key: ВАШ_КЛЮЧ" \
  -H "Content-Type: application/json" \
  -d '{"inn": "7707083893"}'

HTTP/2 502
{"error": "upstream_error", "endpoint": "arrears", "detail": "upstream 400"}
      

Расчётная часть ни к каким реестрам не обращается — это применение норм Налогового кодекса к вашим числам. Правовое основание нужно только живым проверкам, и оно своё у каждого источника.

Проверка статуса плательщика налога на профессиональный доход в нашем перечне источников и правовых оснований отдельной строкой пока не описана — это пробел, который мы закрываем. Отдельно про проверку блокировок по счетам: сервис налоговой службы требует ввода кода с картинки, а обходить такую защиту мы не будем. Пока налоговая не даст другой способ обращения, эта проверка непригодна для автоматической работы, и продавать её мы не станем. Справочник ставок носит справочный характер: он не заменяет налоговую, бухгалтерскую или юридическую консультацию, ставки меняются, и их стоит сверять с первоисточником.

По каждому реестру — норма, которая делает сведения открытыми, перечень полей и то, чего мы сознательно не берём: источники данных и правовые основания . Первоисточник этого сервиса — ФНС России . Atomno MCP не аффилирован с ним.

Чем это отличается от MCP-сервера

Данные одни и те же, отличается способ обращения. Обмен по HTTP разбирает ваш код, MCP-сервер — языковая модель внутри вашего продукта или редактора.

Тут разница принципиальная, а не в удобстве. Расчёты налогов существуют только в пакете с открытым кодом и выполняются у вас на машине. По сети их получить нельзя — это не ограничение тарифа, таких адресов просто нет.

Вопросы и ответы