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.

D'autres outils (transits, synastrie, compatibilité, phases lunaires, 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_place avec « Barcelona », puis astro_natal_chart avec 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