MCP Server: Gebruik AstroAPI vanuit AI-assistenten

AstroAPI biedt een gehoste Model Context Protocol (MCP)-server. Verbind deze met een AI-assistent zoals Claude Code, Claude Desktop of Cursor, en de assistent kan AstroAPI rechtstreeks aanroepen — geboorteplaatsen opzoeken, horoscopen berekenen en de resultaten in begrijpelijke taal uitleggen.

Dit is ook de snelste manier om een integratie te bouwen: verbind de MCP-server met uw AI-codeerassistent en vraag deze om de integratiecode voor u te schrijven. De assistent kan tijdens het werken echte API-aanroepen doen, zodat hij daadwerkelijke responses ziet in plaats van te gissen.

Geen code nodig

Zodra de verbinding is gemaakt, kunt u uw assistent eenvoudig vragen stellen zoals "Bereken de geboortehoroscoop voor iemand die geboren is op 15 juni 1990 om 14:30 in Amsterdam" — de assistent zoekt de locatie op, roept de API aan en vat het resultaat samen.

---

Endpoint

https://mcp.astroapi.cloud/mcp

• Transport: Streamable HTTP
• Authenticatie: uw gewone AstroAPI-sleutel, verzonden als de X-Api-Key-header
• De modules, rate limits en quota's van uw abonnement gelden precies zoals bij directe API-aanroepen.

U kunt een API-sleutel aanmaken in het dashboard onder API Keys. Zie Authenticatie voor details.

---

Claude Code verbinden

Voer dit eenmalig uit in uw terminal:

claude mcp add --transport http astroapi https://mcp.astroapi.cloud/mcp \
  --header "X-Api-Key: YOUR_API_KEY"

Vraag Claude Code vervolgens gewoon om AstroAPI te gebruiken — bijvoorbeeld: "Gebruik de astroapi-tools om een geboortehoroscoop te berekenen voor 1990-06-15 14:30 in Amsterdam en bouw een React-component die deze weergeeft."

Cursor verbinden

Voeg dit toe aan .cursor/mcp.json in uw project (of ~/.cursor/mcp.json voor globaal gebruik):

{
  "mcpServers": {
    "astroapi": {
      "url": "https://mcp.astroapi.cloud/mcp",
      "headers": {
        "X-Api-Key": "YOUR_API_KEY"
      }
    }
  }
}

Andere MCP-clients verbinden

Elke client die MCP via Streamable HTTP met aangepaste headers ondersteunt, werkt. Configureer:

Instelling	Waarde
URL	https://mcp.astroapi.cloud/mcp
Transport	Streamable HTTP
Header	X-Api-Key: YOUR_API_KEY

Gehoste clients zonder aangepaste headers

Sommige gehoste clients (zoals claude.ai-webconnectors) kunnen geen aangepaste headers verzenden en vereisen OAuth. OAuth-ondersteuning staat op de roadmap; gebruik voorlopig een client die aangepaste headers ondersteunt, zoals Claude Code, Claude Desktop of Cursor.

---

Beschikbare tools

Tool	Wat deze doet
astro_resolve_place	Zoekt een plaatsnaam op en retourneert coördinaten en de IANA-tijdzone. Assistenten krijgen de instructie om deze tool eerst aan te roepen, zodat ze nooit coördinaten gissen.
astro_natal_chart	Berekent een geboortehoroscoop (punten, huizen, aspecten), optioneel met interpretatieteksten, en retourneert een compacte, leesbare samenvatting.

Meer tools (transits, synastrie, compatibiliteit, maanfasen, horoscoopafbeeldingen en andere) zijn onderweg. De beschikbaarheid van tools volgt de modules van uw abonnement: een tool die niet in uw plan zit, retourneert een duidelijke melding in plaats van data.

---

Voorbeeldsessie

Een gesprek met een verbonden assistent kan er zo uitzien:

U: Wat is het zonneteken en de ascendant van iemand die geboren is op 3 maart 1985 om 6:45 in Barcelona?

Assistent: roept astro_resolve_place aan met "Barcelona", daarna astro_natal_chart met de gevonden coördinaten en tijdzone — De Zon staat in Vissen op 12°41′ in het 1e huis, en de Ascendant is Waterman 28°10′ …

De assistent handelt geocoding, tijdzoneconversie en de API-aanroep af — precies de dingen die meestal misgaan bij het handmatig invoeren van geboortegegevens.

---

Volgende stappen

• Authenticatie — API-sleutels aanmaken en beheren
• Aan de slag — de API-basis achter deze tools
• Geboortehoroscopen — wat de geboorteberekening retourneert