Nastavení agenta
Připoj AstroWay API k AI agentům přes MCP (Model Context Protocol). Katalog je dostupný dvěma způsoby, oba s tvými klíči aw_test_* / aw_live_*:
- Hosted (HTTP):
https://mcp.astroway.info/mcp, bez instalace, autentizace přes Bearer token. - Stdio (npx):
npx @astroway/mcp, lokální podproces, autentizace přes proměnnou prostředí, funguje offline.
Získej bezplatný klíč v dashboardu a pak si vyber svého klienta.
Jedna doména místo celého katalogu
Sekce “Jedna doména místo celého katalogu”843 nástrojů v jedné odpovědi znamená 3,4 MB, které agent musí přečíst, než si jeden vybere. Většina klientů to vzdá dávno předtím.
https://mcp.astroway.info/mcp/<doména> vrací jeden obor místo všeho. Konfigurace je stejná, mění se jen URL.
| Doména | URL | Nástrojů | Velikost tools/list |
|---|---|---|---|
| Jádro astrologie | /mcp/core | 104 | 389 KB |
| Védská | /mcp/vedic | 192 | 970 KB |
| Čínská metafyzika | /mcp/chinese | 60 | 202 KB |
| Helénismus a tradice | /mcp/hellenistic | 59 | 240 KB |
| Tarot | /mcp/tarot | 79 | 209 KB |
| Numerologie | /mcp/numerology | 64 | 158 KB |
| Human Design | /mcp/human-design | 27 | 125 KB |
| Prognostika | /mcp/forecast | 43 | 209 KB |
| Vztahy | /mcp/relationships | 42 | 247 KB |
| Psychologická | /mcp/psychological | 28 | 107 KB |
| Věštění a esoterika | /mcp/divination | 79 | 185 KB |
| Aplikované výklady | /mcp/applied | 45 | 148 KB |
| Reporty | /mcp/reports | 42 | 209 KB |
| Platforma | /mcp/platform | 42 | 119 KB |
Změřeno na produkci 2026-09-21. /mcp dál vrací celý katalog, takže nic dříve nastaveného se nerozbilo. Kontrola zůstatku a odhad ceny volání jsou v každé doméně, protože i agent omezený na védskou astrologii musí vědět, kolik volání stojí.
GET /domains vrací tentýž seznam jako JSON, bez klíče. Neznámá doména znamená 404 s výčtem skutečných, ne tiché vrácení všech 843.
Dokumentace bez klíče: /mcp/docs
Sekce “Dokumentace bez klíče: /mcp/docs”První otázka agenta nikdy nezní “spočítej horoskop”. Zní “co tohle API umí, jak vypadá volání a kolik mě to bude stát”. Na všechny tři se dá odpovědět bez klíče: https://mcp.astroway.info/mcp/docs nespotřebuje ani jeden kredit, a tak ani nežádá autorizaci.
| Nástroj | Co dělá |
|---|---|
find_endpoint | Hledá mezi všemi 770 operacemi. Pro každou vrací metodu, URL, cenu v kreditech, tarif, povinná pole těla a odkaz na referenci |
search_docs | Hledá ve 281 stránkách příruček, ukrajinských i anglických, s výčtem sekcí každé z nich |
read_doc | Vrací jednu stránku jako markdown |
list_docs | Celý rejstřík, seskupený podle sekcí |
Cenu má 700 ze 770 operací, dalších 37 je označeno jako ty, které odpovídají bez klíče. Cenu scénáře tedy spočítáš dřív, než vůbec máš účet.
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 čte jen stránky, které jsou v rejstříku. Jakákoli jiná cesta dostane odmítnutí a žádný požadavek přitom neodchází ven.
Žádej méně než celou odpověď
Sekce “Žádej méně než celou odpověď”Každý nástroj přijímá kromě svých vlastních dva další parametry: fields (seznam cest oddělených čárkou, relativně k data) a precision (kolik desetinných míst ponechat). Jdou do stejného API jako přes REST a rozdíl v tokenech není řečnický.
| Volání natálního horoskopu přes MCP | Bajtů |
|---|---|
| bez parametrů, jak to bylo před 21.09.2026 | 91 737 |
| bez parametrů, dnes | 72 484 |
precision: 2 | 61 356 |
fields: "planets.name,planets.longitude,houses.cusp" plus precision: 2 | 1 182 |
Změřeno na produkci 2026-09-21. Kredity jsou ve všech čtyřech řádcích stejné: rozdíl platí ten, kdo odpověď čte.
Cesta, která nesouhlasila s žádným polem, se vrátí v _fields_unmatched. Seznam, kde nesouhlasilo nic, znamená 400 FIELDS_UNKNOWN s výčtem, ne prázdnou odpověď. Úplný popis obou parametrů: konvence API.
Vyber svého klienta
Sekce “Vyber svého klienta”CI / raw HTTP
Sekce “CI / raw HTTP”Úplně bez klienta: hosted endpoint mluví JSON-RPC přes HTTP. Seznam nástrojů s Bearer tokenem:
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 bez MCP
Sekce “Function calling bez MCP”Pokud tvůj agent mluví jazykem function calling od OpenAI nebo Anthropic, a ne MCP, požádej API o hotové definice nástrojů a předej je modelu přímo. Generují se z OpenAPI dokumentu, takže schéma, které model vyplňuje, je totéž schéma, které kontroluje endpoint.
curl "https://api.astroway.info/v1/agent/tools?format=openai" \-H "X-Api-Key: aw_live_YOUR_KEY"Odpověď má dvě poloviny. tools přesně odpovídá kontraktu dodavatele a nenese nic našeho, takže ho můžeš vložit do volání modelu tak, jak je: klíč navíc uvnitř objektu nástroje znamená 400 na jejich straně. executors říká, jak každý nástroj vykonat, a má tytéž klíče, které vrátí model:
{"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}Tvůj vykonavatel je pak pět řádků: najít jméno v executors, poslat argumenty modelu jako JSON tělo na tuto cestu se svým X-Api-Key, vrátit odpověď modelu. Žádný nástroj neobsahuje přihlašovací údaje, takže tento seznam je bezpečné cachovat.
Ty vybíráš, co model vidí. Ve výchozím stavu je to kurátorovaná startovní sada 26 nástrojů, ne celý katalog: OpenAI omezuje požadavek na 128 funkcí a modely začínají vybírat hůř dávno před touto hranicí. Zužuj nebo rozšiřuj přes select=all, select=group:Vedic, select=paths:/chart,/synastry, filtruj uvnitř přes q=, omezuj přes limit= (maximum 128). Nic nemizí potichu: totalMatched a notes říkají, co zůstalo mimo. Přidej format=anthropic a dostaneš { name, description, input_schema }.
Volání je zdarma a nespotřebovává kredity.
Vlastní klíč k modelu
Sekce “Vlastní klíč k modelu”Na endpointech, kde generujeme text, můžeš za tokeny platit sám. Dvě hlavičky, buď obě, nebo žádná:
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 je jeden z openai, anthropic, google, groq, mistral, openrouter, deepseek, together; adresa každého je pevně daná na naší straně a nikdy se nebere z požadavku. X-Provider-Model je nepovinný a přepisuje výchozí model.
Návrat na náš řetězec neexistuje. Pokud tvůj klíč nezafungoval, dostaneš status a zprávu poskytovatele, ne odpověď, kterou jsme zaplatili my: tichý návrat by pálil naše tokeny na požadavek, který jsi považoval za svůj, a nedalo by se to nijak poznat.
Takové volání stojí 5 kreditů místo ceny endpointu. Horoskop i tak spočítáme, sestavíme prompt a proženeme ochranné pojistky; dokončení sis koupil ty.
Tvůj klíč se nikde neloguje, neukládá ani necachuje. Jde v hlavičce, protože tělo požadavku se hashuje do dvou klíčů cache, a náš log požadavků hlavičky vůbec nezapisuje. Chyba poskytovatele, která citovala tvůj klíč, se začerní dřív, než se dostane do našich logů nebo do tvé odpovědi. Volání s tvým klíčem obchází obě cache oběma směry: nikdy nedostane odpověď vytvořenou námi a jeho odpověď se nikdy nedostane k nikomu jinému.
Hlavičky jsou ve specifikaci. Každá cesta, která je přijímá, deklaruje X-Provider, X-Provider-Key a X-Provider-Model v /v1/openapi.json, takže vygenerovaný klient je připojí jako kterýkoli jiný parametr a tuhle stránku nepotřebuje. Deklarované jsou jen tam, kde model opravdu voláme: poslat je na /chart můžeš, ale nic se nestane a zaplatíš běžnou cenu endpointu.
Strojově čitelné specifikace
Sekce “Strojově čitelné specifikace”Chceš připojit REST API přímo nebo předat specifikaci vlastnímu agentovi?
- AGENTS.md:
/AGENTS.md, instrukce pro agenta (co lze volat bez klíče, kontrakt požadavku, obálka odpovědi, hlavičky limitů) - OpenAPI:
/v1/openapi.json - llms.txt:
/llms.txt· plný text/llms-full.txt - Postman:
/postman/astroway-api.json - SDK: TypeScript, Python, PHP