MCP Server: AstroAPI aus KI-Assistenten nutzen
AstroAPI stellt einen gehosteten Model Context Protocol-(MCP-)Server bereit. Verbinden Sie ihn mit einem KI-Assistenten wie Claude Code, Claude Desktop oder Cursor, und der Assistent kann AstroAPI direkt aufrufen — Geburtsorte nachschlagen, Horoskope berechnen und die Ergebnisse in verständlicher Sprache erklären.
Dies ist auch der schnellste Weg, eine Integration zu bauen: Verbinden Sie den MCP-Server mit Ihrem KI-Coding-Assistenten und bitten Sie ihn, den Integrationscode für Sie zu schreiben. Der Assistent kann während der Arbeit echte API-Aufrufe ausführen und sieht so tatsächliche Antworten, statt raten zu müssen.
Kein Code erforderlich
Sobald die Verbindung steht, können Sie Ihren Assistenten einfach Dinge fragen wie "Berechne das Geburtshoroskop für eine Person, die am 15. Juni 1990 um 14:30 Uhr in Amsterdam geboren wurde" — der Assistent ermittelt den Ort, ruft die API auf und fasst das Ergebnis zusammen.
Endpoint
https://mcp.astroapi.cloud/mcp- Transport: Streamable HTTP
- Authentifizierung: Ihr regulärer AstroAPI-Schlüssel, gesendet als
X-Api-Key-Header - Die Module, Rate Limits und Kontingente Ihres Abonnements gelten genauso wie bei direkten API-Aufrufen.
Sie können einen API-Schlüssel im Dashboard unter API Keys erstellen. Details finden Sie unter Authentifizierung.
Claude Code verbinden
Führen Sie dies einmalig in Ihrem Terminal aus:
claude mcp add --transport http astroapi https://mcp.astroapi.cloud/mcp \
--header "X-Api-Key: YOUR_API_KEY"Bitten Sie Claude Code anschließend einfach, AstroAPI zu verwenden — zum Beispiel: "Verwende die astroapi-Tools, um ein Geburtshoroskop für den 15.06.1990 um 14:30 Uhr in Amsterdam zu berechnen, und baue mir eine React-Komponente, die es anzeigt."
Cursor verbinden
Fügen Sie dies zu .cursor/mcp.json in Ihrem Projekt hinzu (oder global zu ~/.cursor/mcp.json):
{
"mcpServers": {
"astroapi": {
"url": "https://mcp.astroapi.cloud/mcp",
"headers": {
"X-Api-Key": "YOUR_API_KEY"
}
}
}
}Andere MCP-Clients verbinden
Jeder Client, der MCP über Streamable HTTP mit benutzerdefinierten Headern unterstützt, funktioniert. Konfigurieren Sie:
| Einstellung | Wert |
|---|---|
| URL | https://mcp.astroapi.cloud/mcp |
| Transport | Streamable HTTP |
| Header | X-Api-Key: YOUR_API_KEY |
Gehostete Clients ohne benutzerdefinierte Header
Einige gehostete Clients (etwa claude.ai-Web-Connectoren) können keine benutzerdefinierten Header senden und erfordern OAuth. OAuth-Unterstützung steht auf der Roadmap; verwenden Sie vorerst einen Client, der benutzerdefinierte Header unterstützt, wie Claude Code, Claude Desktop oder Cursor.
Verfügbare Tools
| Tool | Funktion |
|---|---|
astro_resolve_place | Schlägt einen Ortsnamen nach und liefert Koordinaten sowie die IANA-Zeitzone zurück. Assistenten werden angewiesen, dieses Tool zuerst aufzurufen, damit sie niemals Koordinaten raten. |
astro_natal_chart | Berechnet ein Geburtshoroskop (Punkte, Häuser, Aspekte), optional mit Deutungstexten, und liefert eine kompakte, lesbare Zusammenfassung zurück. |
astro_synastry | Vergleicht zwei Geburtshoroskope und listet die Aspekte zwischen den Horoskopen in beiden Richtungen auf. |
astro_composite | Berechnet ein Komposit-Partnerhoroskop (Halbsummen-Horoskop) mit eigenen Positionen und Aspekten. |
astro_transits | Findet Transite über einem Geburtshoroskop in einem Zeitraum (bis zu 2 Jahre): Beginn-, Exakt- und Enddatum je Aspekt. |
astro_compatibility | Schneller Kompatibilitäts-Score zweier Personen anhand der Sonnenzeichen. |
astro_solar_return | Das Solarhoroskop (Sonnenrückkehr) für ein bestimmtes Jahr — das astrologische Geburtstagshoroskop. |
astro_lunar_return | Das Lunarhoroskop (Mondrückkehr) ab einem bestimmten Datum (etwa monatlich). |
astro_progressions | Sekundärprogressionen für ein Zieldatum, einschließlich Aspekten zum Geburtshoroskop. |
astro_human_design | Ein vollständiger Human-Design-Bodygraph: Typ, Strategie, Autorität, Profil, Zentren, Kanäle und Tore. |
astro_moon_sun | Mondphase sowie Auf- und Untergangszeiten, Sonnenhöchststand und Dämmerungszeiten für ein Datum und einen Ort. |
astro_moon_calendar | Tagesbericht (Zeichen, Phase, Leerlauf-Mond) oder eine Zeitraumsübersicht über Phasen, Zeichenwechsel und Leerlaufperioden. |
astro_retrograde_calendar | Rückläufigkeitsperioden mit Stationsdaten, durchlaufenen Zeichen und Schattenperioden. |
astro_chinese_horoscope | Chinesisches Tierkreiszeichen und Element oder eine Jahresprognose. |
astro_numerology | Das vollständige Numerologie-Profil aus Geburtsdatum und Name, oder nur die Lebenswegzahl. |
astro_numerology_compatibility | Kompatibilität zweier Personen anhand ihrer Lebenswegzahlen. |
astro_horoscope | Vorgefertigte Horoskop-Berichte: Tages-, Wochen-, Jahres- und Jahres-Aszendenten-Horoskope. |
astro_ai_summary | Schreibt eine kurze Zusammenfassung dessen, was ein Horoskop bedeutet, aus den stärksten Stellungen und Aspekten. Erfordert das Modul AI Summary. |
Weitere Tools (Astrokartografie, Horoskopgrafiken und andere) sind in Arbeit. Die Verfügbarkeit der Tools richtet sich nach den Modulen Ihres Abonnements: Ein Tool, das Ihr Plan nicht enthält, liefert eine klare Meldung statt Daten zurück.
Beispielsitzung
Ein Gespräch mit einem verbundenen Assistenten könnte so aussehen:
Sie: Was sind Sonnenzeichen und Aszendent einer Person, die am 3. März 1985 um 6:45 Uhr in Barcelona geboren wurde?
Assistent: ruft
astro_resolve_placemit "Barcelona" auf, dannastro_natal_chartmit den ermittelten Koordinaten und der Zeitzone — Die Sonne steht in den Fischen auf 12°41′ im 1. Haus, und der Aszendent ist Wassermann 28°10′ …
Der Assistent übernimmt Geokodierung, Zeitzonenumrechnung und den API-Aufruf — genau die Dinge, die bei der manuellen Eingabe von Geburtsdaten üblicherweise schiefgehen.
Nächste Schritte
- Authentifizierung — API-Schlüssel erstellen und verwalten
- Erste Schritte — die API-Grundlagen hinter diesen Tools
- Geburtshoroskope — was die Geburtsberechnung zurückliefert