Xonta Документы › API

API и MCP

Все инструменты доступны двумя способами: как MCP-сервер для ИИ-агентов и как обычный HTTP API с JSON. Ключ не нужен.

Подключить по MCP

Адрес: https://mcp.xonta.ru/mcp (Streamable HTTP). Пример настройки клиента:

{
  "mcpServers": {
    "xonta-docs": {
      "url": "https://mcp.xonta.ru/mcp"
    }
  }
}

Вызвать по HTTP

Каждый инструмент — это POST-запрос с JSON. Ответ — JSON; при ошибке во входных данных — код 400 и поле error, при превышении лимита — 429.

Проверка реквизитов (ИНН, КПП, ОГРН, БИК, счёт, СНИЛС)

POST /v1/requisites/validate · MCP: validate_requisites · подробнее

curl -X POST https://mcp.xonta.ru/v1/requisites/validate \
  -H "Content-Type: application/json" \
  -d '{"inn":"7707083893","kpp":"773601001","ogrn":"1027700132195","bik":"044525225","account":"40702810938000000001","corr_account":"30101810400000000225"}'

Сумма прописью (с НДС)

POST /v1/text/amount-in-words · MCP: amount_in_words · подробнее

curl -X POST https://mcp.xonta.ru/v1/text/amount-in-words \
  -H "Content-Type: application/json" \
  -d '{"amount":"1234.56","vat_rate":"22"}'

Склонение ФИО и должности по падежам

POST /v1/text/decline · MCP: decline_name · подробнее

curl -X POST https://mcp.xonta.ru/v1/text/decline \
  -H "Content-Type: application/json" \
  -d '{"full_name":"Иванов Иван Петрович","position":"генеральный директор","case":"genitive"}'

Рабочие дни по производственному календарю РФ

POST /v1/calendar/working-days · MCP: working_days · подробнее

curl -X POST https://mcp.xonta.ru/v1/calendar/working-days \
  -H "Content-Type: application/json" \
  -d '{"date":"2026-12-25","add_working_days":5}'

Счёт на оплату (PDF, DOCX)

POST /v1/documents/invoice · MCP: make_invoice · подробнее

curl -X POST https://mcp.xonta.ru/v1/documents/invoice \
  -H "Content-Type: application/json" \
  -d '{"number":"15","date":"2026-10-07","seller":{"name":"ООО «Ромашка»","inn":"7707083893","kpp":"773601001","address":"г. Москва, ул. Примерная, д. 1","bank_name":"ПАО Сбербанк, г. Москва","bik":"044525225","account":"40702810938000000001","corr_account":"30101810400000000225","signer_name":"Иванов Иван Петрович","signer_position":"генеральный директор"},"buyer":{"name":"ИП Петров Пётр Петрович","inn":"500100732259","signer_name":"Петров Пётр Петрович"},"items":[{"name":"Разработка ИИ-агента для обработки заявок","quantity":1,"unit":"усл.","price":"120000"},{"name":"Сопровождение, месяц","quantity":3,"unit":"мес.","price":"15000"}],"vat_rate":"без НДС","payment_due_working_days":5}'

Акт оказанных услуг (PDF, DOCX)

POST /v1/documents/act · MCP: make_act · подробнее

curl -X POST https://mcp.xonta.ru/v1/documents/act \
  -H "Content-Type: application/json" \
  -d '{"number":"15","date":"2026-10-31","basis":"Договор № 12 от 01.10.2026","seller":{"name":"ООО «Ромашка»","inn":"7707083893","kpp":"773601001","signer_name":"Иванов Иван Петрович","signer_position":"генеральный директор"},"buyer":{"name":"ИП Петров Пётр Петрович","inn":"500100732259","signer_name":"Петров Пётр Петрович"},"items":[{"name":"Разработка ИИ-агента для обработки заявок","quantity":1,"unit":"усл.","price":"120000"}],"vat_rate":"без НДС"}'

Иностранные слова в тексте (подсказки к закону о русском языке)

POST /v1/text/foreign-words · MCP: check_foreign_words · подробнее

curl -X POST https://mcp.xonta.ru/v1/text/foreign-words \
  -H "Content-Type: application/json" \
  -d '{"text":"Big SALE в нашем барбершопе! Кэшбэк 10% и бесплатная доставка. Дедлайн акции — 31 октября.","allow":""}'

Типограф для русского текста

POST /v1/text/typograph · MCP: typograph · подробнее

curl -X POST https://mcp.xonta.ru/v1/text/typograph \
  -H "Content-Type: application/json" \
  -d '{"text":"Акция \"Осень - время скидок\" действует 1-15 октября: скидка 20 % на 500 товаров...","format":"text"}'

Транслитерация: загранпаспорт, ГОСТ, адрес страницы

POST /v1/text/transliterate · MCP: transliterate · подробнее

curl -X POST https://mcp.xonta.ru/v1/text/transliterate \
  -H "Content-Type: application/json" \
  -d '{"text":"Щукина Юлия Сергеевна","system":"passport"}'

Распознавание документа: счёт, акт, УПД, счёт-фактура, договор

POST /v1/documents/parse · MCP: parse_document · подробнее

curl -X POST https://mcp.xonta.ru/v1/documents/parse \
  -H "Content-Type: application/json" \
  -d '{"url":"https://example.com/schet-248.pdf"}'

Проверка карточки и рекламы: лекарства, медизделия, БАД, медуслуги

POST /v1/text/medical-check · MCP: check_medical_text · подробнее

curl -X POST https://mcp.xonta.ru/v1/text/medical-check \
  -H "Content-Type: application/json" \
  -d '{"text":"БАД «Хондро-Плюс» лечит суставы! 100% результат, без побочных эффектов. СГР RU.77.99.32.003.R.001234.10.24","channel":"card"}'

Описание для программ