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.
astro_synastry	Vergelijkt twee geboortehoroscopen en somt de aspecten tussen beide horoscopen in beide richtingen op.
astro_composite	Berekent een composiethoroscoop (middelpunt-relatiehoroscoop) met eigen posities en aspecten.
astro_transits	Vindt transits over een geboortehoroscoop in een periode (tot 2 jaar): begin-, exacte en einddatum per aspect.
astro_compatibility	Snelle compatibiliteitsscore tussen twee personen op basis van het zonneteken.
astro_solar_return	De solaarhoroscoop (zonneterugkeer) voor een gegeven jaar — de astrologische verjaardagshoroscoop.
astro_lunar_return	De lunaarhoroscoop (maanterugkeer) vanaf een gegeven datum (ongeveer maandelijks).
astro_progressions	Secundaire progressies voor een doeldatum, inclusief aspecten met de geboortehoroscoop.
astro_human_design	Een volledige Human Design-bodygraph: type, strategie, autoriteit, profiel, centra, kanalen en poorten.
astro_moon_sun	Maanfase plus opkomst- en ondergangstijden, zonnemiddag en schemeringstijden voor een datum en plaats.
astro_moon_calendar	Dagrapport (teken, fase, void-of-course) of een periodeoverzicht van fasen, tekenwisselingen en void-periodes.
astro_retrograde_calendar	Retrogradeperiodes met stationsdata, doorlopen tekens en schaduwperiodes.
astro_chinese_horoscope	Chinees dierenriemteken en element, of een jaarvoorspelling.
astro_numerology	Het volledige numerologieprofiel op basis van geboortedatum en naam, of alleen het levenspadgetal.
astro_numerology_compatibility	Compatibiliteit tussen twee personen op basis van hun levenspadgetallen.
astro_horoscope	Vooraf geschreven horoscooprapporten: dagelijks, wekelijks, jaarlijks en jaarlijks per ascendant.
astro_ai_summary	Schrijft een korte samenvatting van wat een horoscoop betekent, op basis van de zwaarste plaatsingen en aspecten. Vereist de AI Summary-module.

Meer tools (astrocartografie, 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