Configurarea agentului

Conectează API-ul AstroWay la agenți AI prin MCP (Model Context Protocol). Catalogul este disponibil în două moduri, ambele cu cheile tale aw_test_* / aw_live_*:

• Hosted (HTTP): https://mcp.astroway.info/mcp, fără instalare, autentificare prin token Bearer.
• Stdio (npx): npx @astroway/mcp, subproces local, autentificare prin variabilă de mediu, funcționează offline.

Obține o cheie gratuită în dashboard, apoi alege-ți clientul.

Un singur domeniu în loc de tot catalogul

783 de instrumente într-un singur răspuns înseamnă 2.9 MB pe care agentul trebuie să-i citească înainte să aleagă unul. Majoritatea clienților renunță cu mult înainte de asta.

https://mcp.astroway.info/mcp/<domeniu> returnează un singur subiect în loc de tot. Configurația e aceeași, se schimbă doar URL-ul.

Domeniu	URL	Instrumente	Dimensiune tools/list
Nucleul astrologiei	/mcp/core	104	389 KB
Vedică	/mcp/vedic	192	970 KB
Metafizică chineză	/mcp/chinese	60	202 KB
Elenism și tradiție	/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
Prognoză	/mcp/forecast	43	209 KB
Relații	/mcp/relationships	42	247 KB
Psihologică	/mcp/psychological	28	107 KB
Divinație și ezoterism	/mcp/divination	79	185 KB
Citiri aplicate	/mcp/applied	45	148 KB
Rapoarte	/mcp/reports	42	209 KB
Platformă	/mcp/platform	42	119 KB

Măsurat în producție pe 2026-09-21. /mcp returnează în continuare întregul catalog, deci nimic din ce era configurat deja nu s-a stricat. Verificarea soldului și estimarea costului unui apel există în fiecare domeniu, pentru că un agent limitat la astrologia vedică tot trebuie să știe cât costă un apel.

GET /domains returnează aceeași listă ca JSON, fără cheie. Un domeniu necunoscut dă 404 cu lista celor reale, nu o returnare tăcută a tuturor celor 783.

Documentație fără cheie: /mcp/docs

Prima întrebare a unui agent nu este niciodată “calculează harta”. Sună ca “ce știe acest API, cum arată un apel și cât mă va costa”. La toate trei se poate răspunde fără cheie: https://mcp.astroway.info/mcp/docs nu consumă niciun credit, deci nici nu cere autorizare.

Instrument	Ce face
find_endpoint	Caută printre toate cele 770 de operații. Pentru fiecare returnează metoda, URL-ul, prețul în credite, planul, câmpurile obligatorii ale corpului și linkul spre referință
search_docs	Caută în 281 de pagini de ghiduri, în ucraineană și engleză, cu lista secțiunilor fiecăreia
read_doc	Returnează o pagină ca markdown
list_docs	Întregul index, grupat pe secțiuni

700 din cele 770 de operații au preț, iar alte 37 sunt marcate ca răspunzând fără cheie. Adică poți calcula costul unui scenariu înainte să ai un cont.

terminal

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 citește doar paginile care sunt în index. Orice altă cale primește un refuz, iar nicio cerere nu pleacă în exterior.

Cere mai puțin decât tot răspunsul

Fiecare instrument acceptă doi parametri pe lângă ai săi: fields (o listă de căi separate prin virgulă, relative la data) și precision (câte zecimale să rămână). Ei merg în același API ca prin REST, iar diferența în tokeni nu e retorică.

Apel de hartă natală prin MCP	Octeți
fără parametri, ca înainte de 21.09.2026	91 737
fără parametri, astăzi	72 484
precision: 2	61 356
fields: "planets.name,planets.longitude,houses.cusp" plus precision: 2	1 182

Măsurat în producție pe 2026-09-21. Creditele sunt aceleași în toate cele patru rânduri: diferența o plătește cel care citește răspunsul.

O cale care nu s-a potrivit cu niciun câmp revine în _fields_unmatched. O listă în care nu s-a potrivit nimic dă 400 FIELDS_UNKNOWN cu enumerarea lor, nu un răspuns gol. Descrierea completă a ambilor parametri: convențiile API.

Alege-ți clientul

Claude Desktop Hosted MCP prin configurație

Claude Code O singură comandă CLI

Cursor Hosted MCP prin configurație

VS Code Copilot Chat, Agent mode

Windsurf Cascade MCP

Cline Pachet stdio prin npx

Codex CLI Pachet stdio prin npx

CI / raw HTTP

Complet fără client - endpoint-ul hosted vorbește JSON-RPC peste HTTP. Lista instrumentelor cu token Bearer:

terminal

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 fără MCP

Dacă agentul tău vorbește limbajul function calling de la OpenAI sau Anthropic, nu MCP, cere API-ului definițiile de instrumente gata făcute și transmite-le direct modelului. Ele sunt generate din documentul OpenAPI, deci schema pe care o completează modelul este aceeași schemă pe care o validează endpoint-ul.

terminal

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

Răspunsul are două jumătăți. tools corespunde exact contractului furnizorului și nu conține nimic de-al nostru, deci îl poți pune în apelul modelului așa cum e: o cheie în plus în obiectul instrumentului înseamnă 400 de partea lor. executors spune cum se execută fiecare instrument și are aceleași chei pe care le va returna modelul:

răspuns, prescurtat

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

Executorul tău are apoi cinci rânduri: găsește numele în executors, trimite argumentele modelului ca corp JSON pe această cale cu propriul X-Api-Key, returnează răspunsul modelului. Niciun instrument nu conține credențiale, așa că lista poate fi pusă în cache în siguranță.

Tu alegi ce vede modelul. Implicit este un set de start selectat din 26 de instrumente, nu tot catalogul: OpenAI limitează o cerere la 128 de funcții, iar modelele încep să aleagă mai prost cu mult înainte de această limită. Restrânge sau extinde prin select=all, select=group:Vedic, select=paths:/chart,/synastry, filtrează în interior prin q=, limitează prin limit= (maximum 128). Nimic nu dispare pe tăcute: totalMatched și notes spun ce a rămas pe dinafară. Adaugă format=anthropic ca să primești { name, description, input_schema }.

Apelul este gratuit și nu consumă credite.

Cheia ta pentru model

Pe endpoint-urile unde generăm text, poți plăti singur tokenii. Două antete, fie amândouă, fie niciunul:

terminal

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 este unul dintre openai, anthropic, google, groq, mistral, openrouter, deepseek, together; adresa fiecăruia e fixată la noi și nu e niciodată luată din cerere. X-Provider-Model este opțional și suprascrie modelul implicit.

Nu există revenire la lanțul nostru. Dacă cheia ta nu a funcționat, primești statusul și mesajul furnizorului, nu un răspuns plătit de noi: o revenire tăcută ar consuma tokenii noștri pentru o cerere pe care o considerai a ta, și ar fi imposibil de observat.

Un astfel de apel costă 5 credite în locul prețului endpoint-ului. Noi tot calculăm harta, construim promptul și rulăm protecțiile; completarea ai cumpărat-o tu.

Cheia ta nu este nicăieri logată, stocată sau pusă în cache. Ea merge ca antet, pentru că corpul cererii este hash-uit în două chei de cache, iar jurnalul nostru de cereri nu scrie deloc antete. O eroare a furnizorului care ți-a citat cheia este redactată înainte să ajungă în logurile noastre sau în răspunsul tău. Un apel cu cheia ta ocolește ambele cache-uri în ambele sensuri: nu va primi niciodată un răspuns făcut de noi, iar răspunsul lui nu va ajunge niciodată la altcineva.

Antetele sunt în specificație. Fiecare cale care le acceptă declară X-Provider, X-Provider-Key și X-Provider-Model în /v1/openapi.json, deci un client generat le va conecta ca pe orice alt parametru și nu are nevoie de această pagină. Sunt declarate doar acolo unde chiar apelăm un model: le poți trimite pe /chart, dar nu se va întâmpla nimic și vei plăti prețul obișnuit al endpoint-ului.

Specificații citibile de mașini

Vrei să conectezi direct API-ul REST sau să dai specificația propriului agent?

• AGENTS.md: /AGENTS.md, instrucțiuni pentru agent (ce se poate apela fără cheie, contractul cererii, plicul răspunsului, antetele de limită)
• OpenAPI: /v1/openapi.json
• llms.txt: /llms.txt · text complet /llms-full.txt
• Postman: /postman/astroway-api.json
• SDK: TypeScript, Python, PHP