Voeg astrologie toe aan uw AI-agent via MCP

Als je de afgelopen jaar met MCP (Model Context Protocol) in Claude Desktop hebt gewerkt, dan heb je vast wel eens gezien hoe krachtig dit is. MCP is een open standaard van Anthropic om externe tools aan AI-modellen te koppelen. Met een paar regels configuratie kan Claude bijvoorbeeld bestanden uitlezen, verbinding maken met een database of – zoals in deze gids – een REST API voor astrologische berekeningen aanspreken.

In deze post laat ik zien hoe je binnen vijf minuten astrologische berekeningen aan je AI-agent toevoegt via MCP.

MCP is een protocol waarmee AI-modellen tools kunnen aanroepen. Je kunt het zien als een soort REST API voor AI-agenten:

• Een server stelt tools beschikbaar (berekeningen, queries, acties).
• Een client (zoals Claude Desktop, Cursor of een zelfgebouwde agent) ontdekt en gebruikt deze tools.
• De AI-model beslist zelf wanneer welke tool moet worden aangeroepen, op basis van de vraag van de gebruiker.

MCP-servers kunnen lokaal (als subprocess) of remote (via HTTP) draaien. De meeste zijn lokaal en worden gepubliceerd op npm, waar je ze kunt starten met npx.

De MCP-server van AstroWay biedt 25 tools voor de belangrijkste astrologische berekeningen:

• natal_chart – volledige geboortekaart
• synastry – compatibiliteit tussen twee mensen
• transits – actuele transits op een geboortekaart
• daily_horoscope, weekly_horoscope, monthly_horoscope, yearly_horoscope
• interpret_natal, interpret_synastry, interpret_transits – AI-interpretaties
• human_design – volledige HD-kaart
• hd_incarnation_cross, hd_compatibility – HD-specifieke functies
• Plus nog 12 tools voor progressies, solar returns, astrocartografie en rectificatie

Maak een gratis account aan op astroway.info en genereer een API-sleutel (10.000 credits per maand, zonder creditcard).

Het configuratiebestand claude_desktop_config.json vind je op:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

Voeg de AstroWay-server toe:

{
  "mcpServers": {
    "astroway": {
      "command": "npx",
      "args": ["@astroway/mcp"],
      "env": {
        "ASTROWAY_API_KEY": "aw_live_jouw_sleutel_hier"
      }
    }
  }
}

Na de herstart zie je een hamersymbool met 25 beschikbare tools.

Praat nu gewoon natuurlijk met Claude:

Jij: Bouw een geboortekaart voor iemand die geboren is op 14 juli 1990 om 14:30 in Kiev. Wat betekent zijn Zon in Kreeft in het 10e huis?

Claude: Roept natal_chart aan met de geparste coördinaten, gevolgd door interpret_placement. Hier is de geboortekaart. De Zon in Kreeft in het 10e huis wijst op…

Claude doet dit allemaal zelf:

• Parseert natuurlijke taal (stad → coördinaten)
• Kies de juiste tool
• Formateert het antwoord

Wil je een eigen AI-agent bouwen (niet Claude Desktop)? Ook dan kun je de MCP-server gebruiken. Het protocol is gedocumenteerd:

import { spawn } from 'child_process';

const mcp = spawn('npx', ['@astroway/mcp'], {
  env: {
    ...process.env,
    ASTROWAY_API_KEY: process.env.ASTROWAY_API_KEY,
  },
  stdio: ['pipe', 'pipe', 'pipe'],
});

// MCP initialiseren
mcp.stdin.write(JSON.stringify({
  jsonrpc: '2.0',
  id: 1,
  method: 'initialize',
  params: { protocolVersion: '2024-11-05', capabilities: {} },
}) + '\n');

// Tools ophalen
mcp.stdin.write(JSON.stringify({
  jsonrpc: '2.0',
  id: 2,
  method: 'tools/list',
}) + '\n');

// Een tool aanroepen
mcp.stdin.write(JSON.stringify({
  jsonrpc: '2.0',
  id: 3,
  method: 'tools/call',
  params: {
    name: 'natal_chart',
    arguments: {
      date: '1990-07-14',
      time: '14:30:00',
      timezoneOffset: 3,
      latitude: 50.4501,
      longitude: 30.5234,
    },
  },
}) + '\n');

De meeste frameworks voor agents (zoals LangChain of LlamaIndex) hebben ingebouwde MCP-ondersteuning.

Wil je de overhead van MCP vermijden? Roep dan direct het HTTP-API aan vanuit je agent:

async function callAstrowayTool(tool: string, input: object) {
  const res = await fetch(`https://api.astroway.info/v1/${tool}`, {
    method: 'POST',
    headers: {
      'X-Api-Key': process.env.ASTROWAY_API_KEY!,
      'Content-Type': 'application/json',
    },
    body: JSON.stringify(input),
  });
  return res.json();
}

// Gebruik in de agent
const chart = await callAstrowayTool('chart', birthData);

Voordelen van MCP:

• Gestructureerde toolbeschrijvingen, automatische detectie, gestandaardiseerde foutafhandeling.

Voordelen van HTTP:

• Eenvoudiger, werkt overal, geen subprocessen nodig.

Zodra MCP is ingesteld, probeer dan in Claude:

1. “Wat is mijn daghoroscoop? Ik ben geboren op 3 oktober 1993 om 6 uur ‘s ochtends in New York.”
2. “Bereken mijn Human Design-type. Geboren op 22 april 1987 om 16:45 in Londen.”
3. “Vergelijk de compatibiliteit tussen twee mensen: ik (14 juli 1990, Kiev) en mijn vriendin (22 maart 1992, Parijs).”
4. “Wat zijn de belangrijkste transits voor mij vandaag? Geef een interpretatie.”
5. “Ik weet mijn exacte geboortetijd niet. Wat laat een gevoeligheidsanalyse zien voor een tijdsbereik van ±30 minuten?”

Claude kiest zelf de juiste tools, roept ze na elkaar aan en formatteert het antwoord in natuurlijke taal.

De AI-interpretatietools van AstroWay (interpret_*, *_horoscope) hebben ingebouwde beveiligingsmaatregelen:

• Geen medische, juridische of financiële adviezen
• Automatisch toegevoegde disclaimers
• Contentfiltering

Als de agent een interpretatie aan de gebruiker toont, moet je de disclaimer opnemen. Deze staat in het veld disclaimer van elke AI-antwoord.

MCP-aanroepen verbruiken dezelfde creditten als HTTP-aanroepen. Enkele voorbeelden:

• Eenvoudige queries (10 credits)
• Geboortekaart (chart, 20 credits)
• Synastry (50 credits)
• AI-interpretatie (50 credits)

Voor persoonlijk gebruik (één gebruiker die Claude vragen stelt) kom je uit op ongeveer 200–500 credits per maand. De gratis tier is ruim voldoende.

Voor een productieagent met honderden gebruikers hangt het af van de mix van endpoints. Een daghoroscoop-bot voor 1.000 gebruikers = 1.000 × 20 × 30 = 600.000 credits per maand → kies dan voor het Pro-plan.

• AstroWay MCP op npm
• AI-agents en MCP – use case – complete integratiegids
• Horoscoop- & AI-interpretatie-API – productpagina
• Snelle start – haal een API-sleutel op (gratis, 10.000 credits per maand)