MCP для ШІ-агентів — паспорт домену — API і MCP

MCP — спосіб дати ШІ-асистенту доступ до зовнішнього інструмента. Сервер ZRAZU відкритий: ключ і реєстрація не потрібні. Він має один інструмент — паспорт домену, і лише читає.

Що отримує агент

Паспорт домену: хто реєстратор, коли домен зареєстровано й коли спливає, статуси реєстру людською мовою, коли ім'я може звільнитися, сервери імен, стан DNS, сертифіката сайту й пошти з готовими виправленнями.

Через MCP нічого не можна змінити: ні домен, ні записи, ні рахунок.
Персональних даних власника домену ми не віддаємо ніколи.
Слова «вільно» через MCP немає. Довести, що ім'я вільне, може лише реєстр, і лише в момент покупки. Якщо джерела не підтвердили, що домен зайнятий, відповідь — «не змогли перевірити».

Підключити

Адреса сервера: https://api.zrazu.com/mcp. Автентифікація — «без автентифікації».

Claude, ChatGPT та інші клієнти з віддаленими MCP-серверами.

Відкрийте налаштування підключень (конекторів) вашого клієнта і додайте власний MCP-сервер.
Вкажіть адресу https://api.zrazu.com/mcp.
У полі автентифікації виберіть «без автентифікації».

Claude Code:

claude mcp add --transport http zrazu https://api.zrazu.com/mcp

Cursor, VS Code та інші клієнти з конфігурацією JSON:

{ "mcpServers": { "zrazu": { "type": "http", "url": "https://api.zrazu.com/mcp" } } }

Транспорт — Streamable HTTP. Кожен запит — окремий POST, відповідь — один JSON.

Інструмент `domain_passport`

Вхід — domain: ім'я домену (kava.com.ua), адреса сторінки (https://kava.com.ua/menu) або пошти (hello@kava.com.ua). Домен виділяється сам, до 300 знаків.

Приклад запиту до агента: «Перевір домен kava.com.ua: коли спливає і чи все гаразд з поштою».

Вихід — паспорт у JSON і той самий текст:

Поле	Що це
`state`	`taken` — домен зайнятий; `unknown` — не змогли перевірити
`phrase`	одне речення про домен людською мовою
`bars`	чотири смуги стану: `domain`, `dns`, `site`, `mail`
`statuses`	статуси реєстру з поясненням
`lifecycle`	етап, дати реєстрації й закінчення, коли ім'я може звільнитися
`nameservers`, `registrar`	сервери імен і реєстратор
`problems`	знайдені проблеми, чим загрожують, готове виправлення
`checked_at`	коли саме дивилися

Якщо ім'я не вдалося перевірити, відповідь коротка: state: "unknown", причина reason і retry: true — варто спитати пізніше.

Запит вручну

Сесія починається з initialize; сервер повертає номер сесії в заголовку Mcp-Session-Id. Номер діє 24 години.

curl -si https://api.zrazu.com/mcp -H 'content-type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-06-18","capabilities":{},"clientInfo":{"name":"curl","version":"1"}}}' \
  | grep -i mcp-session-id

curl -s https://api.zrazu.com/mcp -H 'content-type: application/json' -H 'Mcp-Session-Id: <номер>' \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"domain_passport","arguments":{"domain":"kava.com.ua"}}}'

Ліміти

Що	Ліміт
Паспорт через MCP	30 на хвилину і 300 на годину на сесію
Усі сесії з однієї адреси	у 10 разів більше
Нові сесії з однієї адреси	600 на годину

Паспорт кешується до 6 годин (для домену в черзі на видалення — 15 хвилин). Коли саме дивилися, видно в checked_at.

Приватність

Кожен запит записується в журнал без вашої адреси й без імені домену: лише інструмент, результат і час. Кожне перевірене ім'я на 90 днів потрапляє у стоп-лист: ми не беремо його собі, у стоп-листі лежить відбиток імені, а не саме ім'я.

Якщо не вийшло

Відповідь `404`. Номер сесії прострочено (діє 24 години). Почніть з initialize знову.
Результат з `isError: true`. Агенту надіслано ім'я без зони, IP-адресу замість домену або занадто довгий рядок. Текст помилки можна показати людині.
`state: "unknown"` і `retry: true`. Джерела не підтвердили стан або вичерпано ліміт. Спитайте за кілька хвилин.
Клієнт просить ключ. Виберіть «без автентифікації»: ключ API тут не потрібен.
Щоб працювати з вашими доменами (список, DNS, сертифікати), використовуйте API за ключем.

MCP для ШІ-агентів — паспорт домену