Налаштування агента

यह कंटेंट अभी तक आपकी भाषा में उपलब्ध नहीं है।

Підключіть API AstroWay до AI-агентів через MCP (Model Context Protocol). Один і той самий каталог із 782 інструментів доступний двома способами, обидва - з вашими ключами aw_test_* / aw_live_*:

Hosted (HTTP): https://mcp.astroway.info/mcp, без встановлення, автентифікація через Bearer-токен.
Stdio (npx): npx @astroway/mcp, локальний підпроцес, автентифікація через env-змінну, працює офлайн.

Отримайте безкоштовний ключ у дашборді, далі оберіть свій клієнт.

Один домен замість усього каталогу

782 інструменти в одній відповіді це 2.9 МБ, які агент зобов’язаний прочитати, перш ніж вибрати один. Більшість клієнтів здається задовго до цього.

https://mcp.astroway.info/mcp/<домен> віддає один предмет замість усього. Конфіг той самий, змінюється тільки URL.

Домен	URL	Інструментів	Розмір `tools/list`
Ядро астрології	`/mcp/core`	104	389 КБ
Ведична	`/mcp/vedic`	192	970 КБ
Китайська метафізика	`/mcp/chinese`	60	202 КБ
Еллінізм і традиція	`/mcp/hellenistic`	59	240 КБ
Таро	`/mcp/tarot`	79	209 КБ
Нумерологія	`/mcp/numerology`	64	158 КБ
Human Design	`/mcp/human-design`	27	125 КБ
Прогностика	`/mcp/forecast`	43	209 КБ
Стосунки	`/mcp/relationships`	42	247 КБ
Психологічна	`/mcp/psychological`	28	107 КБ
Ворожіння й езотерика	`/mcp/divination`	79	185 КБ
Прикладні читання	`/mcp/applied`	45	148 КБ
Звіти	`/mcp/reports`	42	209 КБ
Платформа	`/mcp/platform`	42	119 КБ

Виміряно на проді 2026-09-21. /mcp і далі віддає весь каталог, тож нічого налаштованого раніше не зламалося. Перевірка балансу й оцінка вартості виклику є в кожному домені, бо агент, обмежений ведичною астрологією, все одно має знати, скільки коштує виклик.

GET /domains повертає цей самий список як JSON, без ключа. Невідомий домен це 404 з переліком справжніх, а не мовчазне повернення всіх 782.

Документація без ключа: `/mcp/docs`

Перше питання агента ніколи не “порахуй карту”. Воно звучить як “що вміє цей API, як виглядає виклик і скільки це мені коштуватиме”. Відповідати на всі три можна без ключа: https://mcp.astroway.info/mcp/docs не витрачає жодного кредиту, тож і авторизації не просить.

Інструмент	Що робить
`find_endpoint`	Шукає серед усіх 770 операцій. Для кожної віддає метод, URL, ціну в кредитах, тариф, обов’язкові поля тіла й посилання на довідку
`search_docs`	Шукає по 281 сторінці посібників, українських і англійських, з переліком розділів кожної
`read_doc`	Віддає одну сторінку як markdown
`list_docs`	Увесь покажчик, згрупований за розділами

Ціну мають 700 із 770 операцій, ще 37 позначені як такі, що відповідають без ключа. Тобто вартість сценарію можна порахувати до того, як з’явився акаунт.

curl https://mcp.astroway.info/mcp/docs \
-H "Content-Type: application/json" \
-H "Accept: application/json, text/event-stream" \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"find_endpoint","arguments":{"query":"solar return","limit":2}}}'

read_doc читає тільки ті сторінки, що є в покажчику. Будь-який інший шлях отримує відмову, і запит назовні при цьому не йде.

Просіть менше, ніж уся відповідь

Кожен інструмент приймає два параметри поверх своїх: fields (список шляхів через кому, відносно data) і precision (скільки знаків після коми лишити). Вони йдуть у той самий API, що й через REST, і різниця в токенах не риторична.

Виклик натальної карти через MCP	Байтів
без параметрів, як було до 21.09.2026	91 737
без параметрів, сьогодні	72 484
`precision: 2`	61 356
`fields: "planets.name,planets.longitude,houses.cusp"` плюс `precision: 2`	1 182

Виміряно на проді 2026-09-21. Кредити однакові в усіх чотирьох рядках: платить за різницю той, хто читає відповідь.

Шлях, який не збігся з жодним полем, приходить назад у _fields_unmatched. Список, де не збіглося нічого, це 400 FIELDS_UNKNOWN з переліком, а не порожня відповідь. Повний опис обох параметрів: угоди API.

Оберіть свій клієнт

Claude Desktop Hosted MCP через конфіг

Claude Code Одна CLI-команда

Cursor Hosted MCP через конфіг

VS Code Copilot Chat, Agent mode

Windsurf Cascade MCP

Cline npx stdio-пакет

Codex CLI npx stdio-пакет

CI / raw HTTP

Зовсім без клієнта - hosted-ендпоінт розмовляє JSON-RPC поверх HTTP. Перелік інструментів з Bearer-токеном:

curl https://mcp.astroway.info/mcp \
-H "Authorization: Bearer aw_live_YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

Function calling без MCP

Якщо ваш агент говорить мовою function calling від OpenAI чи Anthropic, а не MCP, попросіть в API готові визначення інструментів і передайте їх моделі напряму. Вони генеруються з OpenAPI-документа, тож схема, яку заповнює модель, це та сама схема, яку перевіряє ендпоінт.

curl "https://api.astroway.info/v1/agent/tools?format=openai" \
-H "X-Api-Key: aw_live_YOUR_KEY"

Відповідь має дві половини. tools точно відповідає контракту вендора і не несе нічого нашого, тож його можна класти у виклик моделі як є: зайвий ключ усередині об’єкта інструмента це 400 на їхньому боці. executors каже, як виконати кожен інструмент, і має ті самі ключі, які поверне модель:

{
"tools": [
  { "type": "function", "function": { "name": "astroway_post_chart", "description": "Natal chart...",
    "parameters": { "type": "object", "required": ["date", "time", "latitude", "longitude"], "properties": { "...": {} } } } }
],
"executors": {
  "astroway_post_chart": { "method": "POST", "path": "/v1/chart", "credits": 20, "group": "Core" }
},
"count": 26, "totalMatched": 26, "totalAvailable": 751, "truncated": false
}

Ваш виконавець після цього це п’ять рядків: знайти ім’я в executors, надіслати аргументи моделі як JSON-тіло на цей шлях зі своїм X-Api-Key, повернути відповідь моделі. Жоден інструмент не містить облікових даних, тому цей список безпечно кешувати.

Ви обираєте, що бачить модель. За замовчуванням це курований стартовий набір із 26 інструментів, а не весь каталог: OpenAI обмежує запит 128 функціями, а моделі починають гірше обирати задовго до цієї межі. Звужуйте або розширюйте через select=all, select=group:Vedic, select=paths:/chart,/synastry, фільтруйте всередині через q=, обмежуйте через limit= (максимум 128). Нічого не зникає мовчки: totalMatched і notes кажуть, що лишилося за межами. Додайте format=anthropic, щоб отримати { name, description, input_schema }.

Виклик безкоштовний і не витрачає кредити.

Свій ключ до моделі

На ендпоінтах, де ми генеруємо текст, ви можете платити за токени самі. Два заголовки, або обидва, або жодного:

curl https://api.astroway.info/v1/ai/explain-aspect \
-H "X-Api-Key: aw_live_YOUR_KEY" \
-H "X-Provider: anthropic" \
-H "X-Provider-Key: sk-ant-YOUR_PROVIDER_KEY" \
-H "Content-Type: application/json" \
-d '{"planet1":"Saturn","planet2":"Moon","aspectType":"Square"}'

X-Provider це один із openai, anthropic, google, groq, mistral, openrouter, deepseek, together; адреса для кожного зафіксована на нашому боці й ніколи не береться із запиту. X-Provider-Model необов’язковий і перекриває модель за замовчуванням.

Відкату на наш ланцюжок немає. Якщо ваш ключ не спрацював, ви отримаєте статус і повідомлення провайдера, а не відповідь, за яку заплатили ми: мовчазний відкат витрачав би наші токени на запит, який ви вважали своїм, і помітити це було б неможливо.

Такий виклик коштує 5 кредитів замість ціни ендпоінта. Ми все одно рахуємо карту, збираємо промт і проганяємо запобіжники; завершення купили ви.

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

Заголовки є у специфікації. Кожен шлях, який їх приймає, оголошує X-Provider, X-Provider-Key і X-Provider-Model у /v1/openapi.json, тож згенерований клієнт підключить їх як будь-який інший параметр, і ця сторінка йому не потрібна. Оголошені вони лише там, де ми справді викликаємо модель: надіслати їх на /chart можна, але нічого не станеться, і ви заплатите звичайну ціну ендпоінта.

Машиночитані специфікації

Бажаєте під’єднати REST API напряму або згодувати специфікацію власному агенту?

AGENTS.md: /AGENTS.md, інструкції для агента (що можна викликати без ключа, контракт запиту, конверт відповіді, заголовки лімітів)
OpenAPI: /v1/openapi.json
llms.txt: /llms.txt · повний текст /llms-full.txt
Postman: /postman/astroway-api.json
SDK: TypeScript, Python, PHP