Agent einrichten
Verbinde die AstroWay API über MCP (Model Context Protocol) mit AI-Agenten. Der Katalog ist auf zwei Wegen erreichbar, beide mit deinen Schlüsseln aw_test_* / aw_live_*:
- Hosted (HTTP):
https://mcp.astroway.info/mcp, ohne Installation, Authentifizierung per Bearer-Token. - Stdio (npx):
npx @astroway/mcp, lokaler Unterprozess, Authentifizierung über eine Umgebungsvariable, funktioniert offline.
Hol dir einen kostenlosen Schlüssel im Dashboard und wähle dann deinen Client.
Eine Domäne statt des ganzen Katalogs
Abschnitt betitelt „Eine Domäne statt des ganzen Katalogs“843 Tools in einer Antwort sind 3,4 MB, die der Agent lesen muss, bevor er eines davon auswählt. Die meisten Clients geben lange vorher auf.
https://mcp.astroway.info/mcp/<domäne> liefert ein Fachgebiet statt des ganzen Katalogs. Die Konfiguration bleibt gleich, nur die URL ändert sich.
| Domäne | URL | Tools | Größe von tools/list |
|---|---|---|---|
| Astrologie-Kern | /mcp/core | 104 | 389 KB |
| Vedisch | /mcp/vedic | 192 | 970 KB |
| Chinesische Metaphysik | /mcp/chinese | 60 | 202 KB |
| Hellenistik und Tradition | /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 |
| Prognostik | /mcp/forecast | 43 | 209 KB |
| Beziehungen | /mcp/relationships | 42 | 247 KB |
| Psychologisch | /mcp/psychological | 28 | 107 KB |
| Wahrsagung und Esoterik | /mcp/divination | 79 | 185 KB |
| Angewandte Deutungen | /mcp/applied | 45 | 148 KB |
| Berichte | /mcp/reports | 42 | 209 KB |
| Plattform | /mcp/platform | 42 | 119 KB |
Gemessen in Produktion am 2026-09-21. /mcp liefert weiterhin den ganzen Katalog, also ist nichts kaputtgegangen, was früher eingerichtet wurde. Kontostandprüfung und Kostenschätzung eines Aufrufs gibt es in jeder Domäne, denn auch ein Agent, der auf vedische Astrologie beschränkt ist, muss wissen, was ein Aufruf kostet.
GET /domains gibt dieselbe Liste als JSON zurück, ohne Schlüssel. Eine unbekannte Domäne ist ein 404 mit der Liste der echten, keine stillschweigende Rückgabe aller 843.
Dokumentation ohne Schlüssel: /mcp/docs
Abschnitt betitelt „Dokumentation ohne Schlüssel: /mcp/docs“Die erste Frage eines Agenten ist nie “berechne ein Horoskop”. Sie lautet “was kann diese API, wie sieht ein Aufruf aus und was wird mich das kosten”. Alle drei lassen sich ohne Schlüssel beantworten: https://mcp.astroway.info/mcp/docs verbraucht keinen einzigen Credit und verlangt daher auch keine Autorisierung.
| Tool | Was es tut |
|---|---|
find_endpoint | Durchsucht alle 770 Operationen. Liefert für jede die Methode, die URL, den Preis in Credits, den Tarif, die Pflichtfelder des Bodys und einen Link zur Referenz |
search_docs | Durchsucht 281 Seiten mit Anleitungen, ukrainisch und englisch, mit der Liste der Abschnitte jeder Seite |
read_doc | Gibt eine Seite als Markdown zurück |
list_docs | Das ganze Verzeichnis, nach Abschnitten gruppiert |
700 von 770 Operationen haben einen Preis, weitere 37 sind als ohne Schlüssel erreichbar markiert. Die Kosten eines Szenarios lassen sich also berechnen, bevor es ein Konto gibt.
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 liest nur Seiten, die im Verzeichnis stehen. Jeder andere Pfad wird abgelehnt, und dabei geht keine Anfrage nach außen.
Fordere weniger als die ganze Antwort an
Abschnitt betitelt „Fordere weniger als die ganze Antwort an“Jedes Tool akzeptiert zusätzlich zu seinen eigenen zwei Parameter: fields (eine kommagetrennte Liste von Pfaden, relativ zu data) und precision (wie viele Nachkommastellen bleiben). Sie gehen an dieselbe API wie über REST, und der Unterschied bei den Tokens ist nicht rhetorisch.
| Aufruf eines Geburtshoroskops über MCP | Bytes |
|---|---|
| ohne Parameter, wie vor dem 21.09.2026 | 91 737 |
| ohne Parameter, heute | 72 484 |
precision: 2 | 61 356 |
fields: "planets.name,planets.longitude,houses.cusp" plus precision: 2 | 1 182 |
Gemessen in Produktion am 2026-09-21. Die Credits sind in allen vier Zeilen gleich: Den Unterschied bezahlt, wer die Antwort liest.
Ein Pfad, der auf kein Feld passt, kommt in _fields_unmatched zurück. Eine Liste, in der nichts passt, ist ein 400 FIELDS_UNKNOWN mit Aufzählung, keine leere Antwort. Vollständige Beschreibung beider Parameter: API-Konventionen.
Wähle deinen Client
Abschnitt betitelt „Wähle deinen Client“CI / raw HTTP
Abschnitt betitelt „CI / raw HTTP“Ganz ohne Client - der Hosted-Endpunkt spricht JSON-RPC über HTTP. Liste der Tools mit einem 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 ohne MCP
Abschnitt betitelt „Function calling ohne MCP“Wenn dein Agent die Function-calling-Sprache von OpenAI oder Anthropic spricht und nicht MCP, fordere bei der API fertige Tool-Definitionen an und gib sie direkt an das Modell weiter. Sie werden aus dem OpenAPI-Dokument erzeugt, das Schema, das das Modell ausfüllt, ist also genau das Schema, das der Endpunkt prüft.
curl "https://api.astroway.info/v1/agent/tools?format=openai" \-H "X-Api-Key: aw_live_YOUR_KEY"Die Antwort hat zwei Hälften. tools entspricht exakt dem Vertrag des Anbieters und enthält nichts von uns, du kannst es also unverändert in den Modellaufruf legen: Ein überzähliger Schlüssel im Tool-Objekt ist auf deren Seite ein 400. executors sagt, wie jedes Tool ausgeführt wird, und hat dieselben Schlüssel, die das Modell zurückgibt:
{"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}Dein Executor ist danach fünf Zeilen lang: den Namen in executors finden, die Argumente des Modells als JSON-Body mit deinem X-Api-Key an diesen Pfad senden, die Antwort an das Modell zurückgeben. Kein Tool enthält Zugangsdaten, daher kann diese Liste gefahrlos gecacht werden.
Du wählst, was das Modell sieht. Standardmäßig ist das ein kuratiertes Startset aus 26 Tools, nicht der ganze Katalog: OpenAI begrenzt eine Anfrage auf 128 Funktionen, und Modelle wählen schon lange vor dieser Grenze schlechter aus. Eingrenzen oder erweitern mit select=all, select=group:Vedic, select=paths:/chart,/synastry, innerhalb filtern mit q=, begrenzen mit limit= (maximal 128). Nichts verschwindet stillschweigend: totalMatched und notes sagen, was außen vor geblieben ist. Füge format=anthropic hinzu, um { name, description, input_schema } zu erhalten.
Der Aufruf ist kostenlos und verbraucht keine Credits.
Eigener Schlüssel für das Modell
Abschnitt betitelt „Eigener Schlüssel für das Modell“Auf den Endpunkten, an denen wir Text erzeugen, kannst du die Tokens selbst bezahlen. Zwei Header, entweder beide oder keiner:
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 ist einer von openai, anthropic, google, groq, mistral, openrouter, deepseek, together; die Adresse für jeden ist auf unserer Seite festgelegt und wird nie aus der Anfrage übernommen. X-Provider-Model ist optional und überschreibt das Standardmodell.
Einen Rückfall auf unsere Kette gibt es nicht. Wenn dein Schlüssel nicht funktioniert, erhältst du Status und Meldung des Anbieters, keine Antwort, die wir bezahlt haben: Ein stiller Rückfall würde unsere Tokens für eine Anfrage verbrauchen, die du für deine eigene hieltest, und das ließe sich nicht bemerken.
Ein solcher Aufruf kostet 5 Credits statt des Endpunktpreises. Wir berechnen trotzdem das Horoskop, bauen den Prompt und lassen die Schutzmechanismen laufen; die Completion hast du gekauft.
Dein Schlüssel wird nirgends geloggt, gespeichert oder gecacht. Er geht als Header, weil der Body der Anfrage in zwei Cache-Schlüssel gehasht wird und unser Anfrageprotokoll überhaupt keine Header schreibt. Ein Anbieterfehler, der deinen Schlüssel zitiert, wird geschwärzt, bevor er in unsere Logs oder deine Antwort gelangt. Ein Aufruf mit deinem Schlüssel umgeht beide Caches in beide Richtungen: Er erhält nie eine Antwort, die wir erzeugt haben, und seine Antwort gelangt nie an jemand anderen.
Die Header stehen in der Spezifikation. Jeder Pfad, der sie akzeptiert, deklariert X-Provider, X-Provider-Key und X-Provider-Model in /v1/openapi.json, ein generierter Client bindet sie also wie jeden anderen Parameter ein und braucht diese Seite nicht. Deklariert sind sie nur dort, wo wir tatsächlich ein Modell aufrufen: An /chart kannst du sie senden, aber es passiert nichts, und du zahlst den normalen Endpunktpreis.
Maschinenlesbare Spezifikationen
Abschnitt betitelt „Maschinenlesbare Spezifikationen“Möchtest du die REST API direkt anbinden oder die Spezifikation deinem eigenen Agenten geben?
- AGENTS.md:
/AGENTS.md, Anweisungen für den Agenten (was ohne Schlüssel aufrufbar ist, Anfragevertrag, Antwort-Envelope, Limit-Header) - OpenAPI:
/v1/openapi.json - llms.txt:
/llms.txt· Volltext/llms-full.txt - Postman:
/postman/astroway-api.json - SDK: TypeScript, Python, PHP