Ügynök beállítása

Csatlakoztasd az AstroWay API-t AI-ügynökökhöz az MCP (Model Context Protocol) segítségével. A katalógus kétféleképpen érhető el, mindkettő a saját aw_test_* / aw_live_* kulcsaiddal:

Hosted (HTTP): https://mcp.astroway.info/mcp, telepítés nélkül, hitelesítés Bearer-tokennel.
Stdio (npx): npx @astroway/mcp, helyi alfolyamat, hitelesítés környezeti változóval, offline is működik.

Szerezz ingyenes kulcsot a dashboardon, majd válaszd ki a kliensedet.

Egy domain a teljes katalógus helyett

783 eszköz egyetlen válaszban 2.9 MB, amit az ügynöknek el kell olvasnia, mielőtt egyet kiválaszt. A legtöbb kliens jóval előbb feladja.

A https://mcp.astroway.info/mcp/<domain> egyetlen témakört ad vissza az egész helyett. A konfiguráció ugyanaz, csak az URL változik.

Domain	URL	Eszközök	`tools/list` mérete
Asztrológiai mag	`/mcp/core`	104	389 KB
Védikus	`/mcp/vedic`	192	970 KB
Kínai metafizika	`/mcp/chinese`	60	202 KB
Hellenisztikus és tradicionális	`/mcp/hellenistic`	59	240 KB
Tarot	`/mcp/tarot`	79	209 KB
Numerológia	`/mcp/numerology`	64	158 KB
Human Design	`/mcp/human-design`	27	125 KB
Előrejelzés	`/mcp/forecast`	43	209 KB
Kapcsolatok	`/mcp/relationships`	42	247 KB
Pszichológiai	`/mcp/psychological`	28	107 KB
Jóslás és ezotéria	`/mcp/divination`	79	185 KB
Alkalmazott olvasatok	`/mcp/applied`	45	148 KB
Jelentések	`/mcp/reports`	42	209 KB
Platform	`/mcp/platform`	42	119 KB

Élesben mérve 2026-09-21-én. A /mcp továbbra is a teljes katalógust adja, így semmi korábban beállított nem romlott el. Az egyenleg lekérdezése és a hívás költségének becslése minden domainben megvan, mert a védikus asztrológiára korlátozott ügynöknek is tudnia kell, mennyibe kerül egy hívás.

A GET /domains ugyanezt a listát adja vissza JSON-ként, kulcs nélkül. Az ismeretlen domain 404, a valódiak listájával, nem pedig mind a(z) 783 eszköz csendes visszaadása.

Dokumentáció kulcs nélkül: `/mcp/docs`

Az ügynök első kérdése sosem az, hogy “számold ki a képletet”. Hanem az, hogy “mit tud ez az API, hogy néz ki egy hívás, és mennyibe fog ez nekem kerülni”. Mindhárom kérdésre kulcs nélkül lehet válaszolni: a https://mcp.astroway.info/mcp/docs egyetlen kreditet sem használ fel, ezért hitelesítést sem kér.

Eszköz	Mit csinál
`find_endpoint`	Keres mind a 770 művelet között. Mindegyikhez visszaadja a metódust, az URL-t, a kreditben kifejezett árat, a csomagot, a törzs kötelező mezőit és a referenciára mutató linket
`search_docs`	Keres 281 útmutató oldal között, ukrán és angol nyelven, mindegyik fejezeteinek listájával
`read_doc`	Egyetlen oldalt ad vissza markdownként
`list_docs`	A teljes tartalomjegyzék, fejezetek szerint csoportosítva

A 770 műveletből 700-nak van ára, további 37 kulcs nélkül válaszolóként van megjelölve. Vagyis egy forgatókönyv költsége kiszámolható, mielőtt fiókod lenne.

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}}}'

A read_doc csak a tartalomjegyzékben szereplő oldalakat olvassa. Minden más útvonal elutasítást kap, és ilyenkor kifelé menő kérés sem történik.

Kérj kevesebbet, mint a teljes válasz

Minden eszköz a sajátjai mellett két paramétert is elfogad: fields (vesszővel elválasztott útvonalak listája, a data-hoz képest) és precision (hány tizedesjegy maradjon). Ugyanabba az API-ba mennek, mint REST-en keresztül, és a tokenkülönbség nem retorikai kérdés.

Születési képlet hívása MCP-n keresztül	Bájt
paraméterek nélkül, ahogy 2026.09.21. előtt volt	91 737
paraméterek nélkül, ma	72 484
`precision: 2`	61 356
`fields: "planets.name,planets.longitude,houses.cusp"` és `precision: 2`	1 182

Élesben mérve 2026-09-21-én. A kredit mind a négy sorban ugyanannyi: a különbséget az fizeti meg, aki a választ olvassa.

Az az útvonal, amely egyetlen mezővel sem egyezett, visszajön a _fields_unmatched mezőben. Ha a listából semmi sem egyezett, az 400 FIELDS_UNKNOWN a listával, nem pedig üres válasz. Mindkét paraméter teljes leírása: API-konvenciók.

Válaszd ki a kliensedet

Claude Desktop Hosted MCP konfiguráción keresztül

Claude Code Egyetlen CLI-parancs

Cursor Hosted MCP konfiguráción keresztül

VS Code Copilot Chat, Agent mode

Windsurf Cascade MCP

Cline npx stdio-csomag

Codex CLI npx stdio-csomag

CI / raw HTTP

Kliens nélkül is megy: a hosted endpoint JSON-RPC-t beszél HTTP felett. Az eszközök listája Bearer-tokennel:

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 nélkül

Ha az ügynököd az OpenAI vagy az Anthropic function calling nyelvét beszéli, nem az MCP-t, kérd le az API-tól a kész eszközdefiníciókat, és add át őket közvetlenül a modellnek. Az OpenAPI-dokumentumból generálódnak, így a séma, amit a modell kitölt, ugyanaz a séma, amit az endpoint ellenőriz.

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

A válasznak két fele van. A tools pontosan követi a szolgáltató szerződését, és semmi sajátunkat nem tartalmaz, így változtatás nélkül beteheted a modellhívásba: egy felesleges kulcs az eszközobjektumban náluk 400-at jelent. Az executors megmondja, hogyan kell végrehajtani az egyes eszközöket, és ugyanazok a kulcsai, amelyeket a modell visszaad:

{
"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
}

A végrehajtód ezután öt sor: megkeresed a nevet az executors-ban, elküldöd a modell argumentumait JSON-törzsként erre az útvonalra a saját X-Api-Key fejléceddel, és visszaadod a választ a modellnek. Egyik eszköz sem tartalmaz hitelesítő adatot, ezért ez a lista nyugodtan gyorsítótárazható.

Te döntöd el, mit lát a modell. Alapértelmezésként ez egy válogatott, 26 eszközből álló kezdőkészlet, nem a teljes katalógus: az OpenAI egy kérést 128 függvényre korlátoz, a modellek pedig már jóval e határ előtt rosszabbul választanak. Szűkíts vagy bővíts a select=all, select=group:Vedic, select=paths:/chart,/synastry segítségével, szűrj a q= paraméterrel, korlátozz a limit= paraméterrel (legfeljebb 128). Semmi sem tűnik el csendben: a totalMatched és a notes megmondja, mi maradt ki. Add hozzá a format=anthropic paramétert, hogy { name, description, input_schema } formát kapj.

A hívás ingyenes, és nem használ fel kreditet.

Saját kulcs a modellhez

Azokon az endpointokon, ahol szöveget generálunk, a tokenekért fizethetsz te magad is. Két fejléc: vagy mindkettő, vagy egyik sem:

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"}'

Az X-Provider értéke az alábbiak egyike: openai, anthropic, google, groq, mistral, openrouter, deepseek, together; a címet mindegyikhez nálunk rögzítjük, és sosem a kérésből vesszük. Az X-Provider-Model nem kötelező, és felülírja az alapértelmezett modellt.

Nincs visszaesés a mi láncunkra. Ha a kulcsod nem működött, a szolgáltató státuszát és üzenetét kapod meg, nem egy olyan választ, amelyért mi fizettünk: egy csendes visszaesés a mi tokenjeinket költené egy olyan kérésre, amit a sajátodnak hittél, és ezt nem lehetne észrevenni.

Egy ilyen hívás 5 kreditbe kerül az endpoint ára helyett. A képletet így is mi számoljuk ki, a promptot mi állítjuk össze, és a védőkorlátokat is mi futtatjuk; a completiont te vetted meg.

A kulcsodat sehol nem naplózzuk, nem tároljuk és nem gyorsítótárazzuk. Fejlécben megy, mert a kérés törzse két gyorsítótárkulcsba is bekerül hashként, a kérésnaplónk pedig egyáltalán nem rögzíti a fejléceket. Ha a szolgáltató hibaüzenete idézi a kulcsodat, azt kitakarjuk, mielőtt a naplóinkba vagy a válaszodba kerülne. A saját kulcsos hívás mindkét gyorsítótárat mindkét irányban megkerüli: sosem kap olyan választ, amit mi készítettünk, és az ő válasza sosem jut el senki máshoz.

A fejlécek szerepelnek a specifikációban. Minden útvonal, amely elfogadja őket, deklarálja az X-Provider, X-Provider-Key és X-Provider-Model fejlécet a /v1/openapi.json fájlban, így egy generált kliens bármely más paraméterhez hasonlóan bekötheti őket, és ehhez nincs szüksége erre az oldalra. Csak ott vannak deklarálva, ahol valóban modellt hívunk: a /chart endpointra is elküldheted őket, de nem történik semmi, és az endpoint szokásos árát fizeted.

Géppel olvasható specifikációk

Közvetlenül szeretnéd bekötni a REST API-t, vagy a saját ügynöködnek adnád át a specifikációt?

AGENTS.md: /AGENTS.md, utasítások az ügynöknek (mit lehet kulcs nélkül hívni, a kérés szerződése, a válasz borítéka, a limitfejlécek)
OpenAPI: /v1/openapi.json
llms.txt: /llms.txt · teljes szöveg /llms-full.txt
Postman: /postman/astroway-api.json
SDK: TypeScript, Python, PHP