MCP Server : utilisez AstroAPI depuis des assistants IA
AstroAPI propose un serveur Model Context Protocol (MCP) hébergé. Connectez-le à un assistant IA comme Claude Code, Claude Desktop ou Cursor, et l'assistant peut appeler AstroAPI directement — rechercher des lieux de naissance, calculer des thèmes et expliquer les résultats en langage clair.
C'est aussi le moyen le plus rapide de construire une intégration : connectez le serveur MCP à votre assistant de codage IA et demandez-lui d'écrire le code d'intégration pour vous. L'assistant peut effectuer de vrais appels d'API pendant qu'il travaille, il voit donc des réponses réelles au lieu de deviner.
Aucun code requis
Une fois connecté, vous pouvez simplement poser à votre assistant des questions comme « Calcule le thème natal d'une personne née le 15 juin 1990 à 14 h 30 à Amsterdam » — l'assistant résout le lieu, appelle l'API et résume le résultat.
Endpoint
https://mcp.astroapi.cloud/mcp- Transport : Streamable HTTP
- Authentification : votre clé AstroAPI habituelle, envoyée dans l'en-tête
X-Api-Key - Les modules, limites de débit et quotas de votre abonnement s'appliquent exactement comme pour les appels d'API directs.
Vous pouvez créer une clé d'API dans le tableau de bord sous API Keys. Consultez Authentification pour plus de détails.
Connecter Claude Code
Exécutez ceci une seule fois dans votre terminal :
claude mcp add --transport http astroapi https://mcp.astroapi.cloud/mcp \
--header "X-Api-Key: YOUR_API_KEY"Demandez ensuite simplement à Claude Code d'utiliser AstroAPI — par exemple : « Utilise les outils astroapi pour calculer un thème natal pour le 15/06/1990 à 14 h 30 à Amsterdam et construis-moi un composant React qui l'affiche. »
Connecter Cursor
Ajoutez ceci à .cursor/mcp.json dans votre projet (ou à ~/.cursor/mcp.json pour une configuration globale) :
{
"mcpServers": {
"astroapi": {
"url": "https://mcp.astroapi.cloud/mcp",
"headers": {
"X-Api-Key": "YOUR_API_KEY"
}
}
}
}Connecter d'autres clients MCP
Tout client prenant en charge MCP via Streamable HTTP avec des en-têtes personnalisés fonctionne. Configurez :
| Paramètre | Valeur |
|---|---|
| URL | https://mcp.astroapi.cloud/mcp |
| Transport | Streamable HTTP |
| En-tête | X-Api-Key: YOUR_API_KEY |
Clients hébergés sans en-têtes personnalisés
Certains clients hébergés (comme les connecteurs web de claude.ai) ne peuvent pas envoyer d'en-têtes personnalisés et exigent OAuth. La prise en charge d'OAuth est sur la feuille de route ; pour l'instant, utilisez un client qui prend en charge les en-têtes personnalisés, comme Claude Code, Claude Desktop ou Cursor.
Outils disponibles
| Outil | Fonction |
|---|---|
astro_resolve_place | Recherche un nom de lieu et renvoie les coordonnées ainsi que le fuseau horaire IANA. Les assistants reçoivent l'instruction d'appeler cet outil en premier, afin de ne jamais deviner les coordonnées. |
astro_natal_chart | Calcule un thème natal (points, maisons, aspects), avec des textes d'interprétation en option, et renvoie un résumé compact et lisible. |
astro_synastry | Compare deux thèmes de naissance et liste les aspects inter-thèmes dans les deux sens. |
astro_composite | Calcule un thème composite (des mi-points) de la relation, avec ses propres positions et aspects. |
astro_transits | Recherche les transits sur un thème natal au cours d'une période (jusqu'à 2 ans) : dates de début, d'exactitude et de fin pour chaque aspect. |
astro_compatibility | Score de compatibilité rapide entre deux personnes selon leur signe solaire. |
astro_solar_return | Le thème de révolution solaire d'une année donnée (le thème astrologique d'anniversaire). |
astro_lunar_return | Le thème de révolution lunaire à partir d'une date donnée (environ mensuel). |
astro_progressions | Progressions secondaires pour une date cible, y compris les aspects avec le thème natal. |
astro_human_design | Un bodygraph complet de Human Design : type, stratégie, autorité, profil, centres, canaux et portes. |
astro_moon_sun | Phase lunaire, plus les heures de lever/coucher, le midi solaire et les crépuscules pour une date et un lieu. |
astro_moon_calendar | Rapport journalier (signe, phase, lune hors cours) ou aperçu d'une période avec les phases, les changements de signe et les périodes hors cours. |
astro_retrograde_calendar | Périodes de rétrogradation avec les dates de station, les signes traversés et les périodes d'ombre. |
astro_chinese_horoscope | Signe et élément du zodiaque chinois, ou prévision annuelle. |
astro_numerology | Le profil numérologique complet à partir de la date de naissance et du nom, ou seulement le nombre du chemin de vie. |
astro_numerology_compatibility | Compatibilité entre deux personnes selon leurs nombres du chemin de vie. |
astro_horoscope | Rapports d'horoscope prérédigés : quotidien, hebdomadaire, annuel et annuel par ascendant. |
astro_ai_summary | Rédige un court résumé de ce que signifie un horoscope, à partir des placements et des aspects les plus forts. Nécessite le module AI Summary. |
D'autres outils (astrocartographie, images de thèmes et bien d'autres) sont en préparation. La disponibilité des outils suit les modules de votre abonnement : un outil non inclus dans votre offre renvoie un message clair au lieu de données.
Exemple de session
Une conversation avec un assistant connecté pourrait ressembler à ceci :
Vous : Quels sont le signe solaire et l'ascendant d'une personne née le 3 mars 1985 à 6 h 45 à Barcelone ?
Assistant : appelle
astro_resolve_placeavec « Barcelona », puisastro_natal_chartavec les coordonnées et le fuseau horaire résolus — Le Soleil est en Poissons à 12°41′ dans la 1re maison, et l'Ascendant est en Verseau 28°10′ …
L'assistant gère le géocodage, la conversion de fuseau horaire et l'appel d'API — précisément ce qui pose habituellement problème lors de la saisie manuelle des données de naissance.
Prochaines étapes
- Authentification — créer et gérer des clés d'API
- Premiers pas — les bases de l'API derrière ces outils
- Thèmes natals — ce que renvoie le calcul natal