Agent instellen
Koppel de AstroWay API aan AI-agents via MCP (Model Context Protocol). De catalogus is op twee manieren beschikbaar, allebei met je eigen sleutels aw_test_* / aw_live_*:
- Hosted (HTTP):
https://mcp.astroway.info/mcp, zonder installatie, authenticatie via een Bearer-token. - Stdio (npx):
npx @astroway/mcp, een lokaal subproces, authenticatie via een env-variabele, werkt offline.
Haal een gratis sleutel op in het dashboard en kies daarna je client.
Eén domein in plaats van de hele catalogus
Section titled “Eén domein in plaats van de hele catalogus”843 tools in één response is 3,4 MB die de agent moet lezen voordat hij er één kiest. De meeste clients geven het al lang daarvoor op.
https://mcp.astroway.info/mcp/<domein> geeft één onderwerp terug in plaats van alles. De config blijft gelijk, alleen de URL verandert.
| Domein | URL | Tools | Grootte tools/list |
|---|---|---|---|
| Astrologie-kern | /mcp/core | 104 | 389 KB |
| Vedisch | /mcp/vedic | 192 | 970 KB |
| Chinese metafysica | /mcp/chinese | 60 | 202 KB |
| Hellenistisch en traditioneel | /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 |
| Voorspelling | /mcp/forecast | 43 | 209 KB |
| Relaties | /mcp/relationships | 42 | 247 KB |
| Psychologisch | /mcp/psychological | 28 | 107 KB |
| Waarzeggerij en esoterie | /mcp/divination | 79 | 185 KB |
| Toegepaste readings | /mcp/applied | 45 | 148 KB |
| Rapporten | /mcp/reports | 42 | 209 KB |
| Platform | /mcp/platform | 42 | 119 KB |
Gemeten in productie op 2026-09-21. /mcp geeft nog steeds de volledige catalogus terug, dus niets wat je eerder hebt ingesteld is kapot gegaan. Saldo controleren en de kosten van een aanroep schatten zit in elk domein, want een agent die beperkt is tot Vedische astrologie moet nog steeds weten wat een aanroep kost.
GET /domains geeft dezelfde lijst terug als JSON, zonder sleutel. Een onbekend domein is een 404 met de lijst van echte domeinen, geen stille terugval naar alle 843.
Documentatie zonder sleutel: /mcp/docs
Section titled “Documentatie zonder sleutel: /mcp/docs”De eerste vraag van een agent is nooit “bereken een horoscoop”. Die luidt “wat kan deze API, hoe ziet een aanroep eruit en wat gaat het me kosten”. Alle drie kun je zonder sleutel beantwoorden: https://mcp.astroway.info/mcp/docs verbruikt geen enkel credit en vraagt dus ook geen autorisatie.
| Tool | Wat het doet |
|---|---|
find_endpoint | Zoekt in alle 770 operaties. Geeft per operatie de methode, URL, prijs in credits, het plan, verplichte body-velden en een link naar de referentie |
search_docs | Zoekt in 281 handleidingpagina’s, Oekraïens en Engels, met de lijst van secties van elke pagina |
read_doc | Geeft één pagina terug als markdown |
list_docs | De volledige index, gegroepeerd per sectie |
700 van de 770 operaties hebben een prijs, nog eens 37 zijn gemarkeerd als operaties die zonder sleutel antwoorden. De kosten van een scenario kun je dus uitrekenen voordat je een account hebt.
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 leest alleen pagina’s die in de index staan. Elk ander pad wordt geweigerd, en er gaat dan geen verzoek naar buiten.
Vraag minder dan de hele response
Section titled “Vraag minder dan de hele response”Elke tool accepteert twee parameters bovenop de eigen: fields (een kommagescheiden lijst van paden, relatief aan data) en precision (hoeveel decimalen er blijven). Ze gaan naar dezelfde API als via REST, en het verschil in tokens is niet retorisch.
| Geboortehoroscoop via MCP | Bytes |
|---|---|
| zonder parameters, zoals vóór 21.09.2026 | 91 737 |
| zonder parameters, vandaag | 72 484 |
precision: 2 | 61 356 |
fields: "planets.name,planets.longitude,houses.cusp" plus precision: 2 | 1 182 |
Gemeten in productie op 2026-09-21. De credits zijn gelijk in alle vier de rijen: voor het verschil betaalt degene die de response leest.
Een pad dat met geen enkel veld overeenkwam, komt terug in _fields_unmatched. Een lijst waarin niets overeenkwam is een 400 FIELDS_UNKNOWN met de opsomming, geen lege response. Volledige beschrijving van beide parameters: API-conventies.
Kies je client
Section titled “Kies je client”CI / raw HTTP
Section titled “CI / raw HTTP”Helemaal zonder client - het hosted endpoint spreekt JSON-RPC over HTTP. De lijst met tools met een Bearer-token:
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 zonder MCP
Section titled “Function calling zonder MCP”Spreekt je agent de function calling van OpenAI of Anthropic in plaats van MCP, vraag de API dan om kant-en-klare tooldefinities en geef die direct aan het model. Ze worden gegenereerd uit het OpenAPI-document, dus het schema dat het model invult is hetzelfde schema dat het endpoint valideert.
curl "https://api.astroway.info/v1/agent/tools?format=openai" \-H "X-Api-Key: aw_live_YOUR_KEY"De response heeft twee helften. tools volgt exact het contract van de vendor en bevat niets van ons, dus je kunt het ongewijzigd in de modelaanroep zetten: een extra sleutel binnen een tool-object is een 400 aan hun kant. executors zegt hoe elke tool uitgevoerd wordt en heeft dezelfde sleutels die het model teruggeeft:
{"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}Je executor is daarna vijf regels: de naam opzoeken in executors, de argumenten van het model als JSON-body naar dat pad sturen met je eigen X-Api-Key, de response aan het model teruggeven. Geen enkele tool bevat credentials, dus deze lijst kun je veilig cachen.
Jij kiest wat het model ziet. Standaard is dat een samengestelde startset van 26 tools, niet de hele catalogus: OpenAI beperkt een verzoek tot 128 functies, en modellen gaan al lang voor die grens slechter kiezen. Beperk of verbreed met select=all, select=group:Vedic, select=paths:/chart,/synastry, filter daarbinnen met q=, begrens met limit= (maximaal 128). Niets verdwijnt stilletjes: totalMatched en notes vertellen wat erbuiten viel. Voeg format=anthropic toe om { name, description, input_schema } te krijgen.
De aanroep is gratis en verbruikt geen credits.
Je eigen sleutel voor het model
Section titled “Je eigen sleutel voor het model”Op endpoints waar wij tekst genereren kun je zelf voor de tokens betalen. Twee headers, allebei of geen van beide:
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 is een van openai, anthropic, google, groq, mistral, openrouter, deepseek, together; het adres voor elk ervan staat vast aan onze kant en wordt nooit uit het verzoek gehaald. X-Provider-Model is optioneel en overschrijft het standaardmodel.
Er is geen terugval op onze keten. Werkt je sleutel niet, dan krijg je de status en de melding van de provider, geen antwoord waarvoor wij betaald hebben: een stille terugval zou onze tokens verbruiken voor een verzoek dat jij als het jouwe beschouwde, en dat zou onmogelijk op te merken zijn.
Zo’n aanroep kost 5 credits in plaats van de prijs van het endpoint. We berekenen nog steeds de horoscoop, stellen de prompt samen en draaien de veiligheidsfilters; de completion heb jij gekocht.
Je sleutel wordt nergens gelogd, opgeslagen of gecachet. Hij gaat mee als header, omdat de request-body gehasht wordt in twee cachesleutels, en ons verzoeklog schrijft helemaal geen headers weg. Een foutmelding van de provider die je sleutel citeerde, wordt geredigeerd voordat die in onze logs of in je response terechtkomt. Een aanroep met je sleutel omzeilt beide caches in beide richtingen: hij krijgt nooit een antwoord dat wij gemaakt hebben, en zijn antwoord komt nooit bij iemand anders terecht.
De headers staan in de specificatie. Elk pad dat ze accepteert, declareert X-Provider, X-Provider-Key en X-Provider-Model in /v1/openapi.json, dus een gegenereerde client koppelt ze aan zoals elke andere parameter en heeft deze pagina niet nodig. Ze zijn alleen gedeclareerd waar we echt een model aanroepen: je kunt ze naar /chart sturen, maar er gebeurt niets en je betaalt de gewone prijs van het endpoint.
Machineleesbare specificaties
Section titled “Machineleesbare specificaties”Wil je de REST API direct aansluiten of de specificatie aan je eigen agent voeren?
- AGENTS.md:
/AGENTS.md, instructies voor de agent (wat je zonder sleutel kunt aanroepen, het request-contract, de response-envelop, de limietheaders) - OpenAPI:
/v1/openapi.json - llms.txt:
/llms.txt· volledige tekst/llms-full.txt - Postman:
/postman/astroway-api.json - SDK: TypeScript, Python, PHP