Voeg astrologie toe aan uw AI-agent via MCP

Als je het afgelopen jaar met Claude Desktop hebt gewerkt, heb je waarschijnlijk MCP (Model Context Protocol) gezien. Het is een open standaard van Anthropic voor het aansluiten van externe tools op AI-modellen. Een paar regels configuratie – en Claude kan het bestandssysteem, databases of elke API aanspreken.

In deze post – hoe je astrologische berekeningen toevoegt aan een AI-agent via MCP. Minder dan 5 minuten.

MCP - een protocol waarmee AI-modellen tools aanroepen. Stel je het voor als een “REST API voor AI-agenten”:

• Server stelt tools beschikbaar (berekeningen, queries, acties)
• Client (Claude Desktop, Cursor, aangepaste agent) ontdekt ze en roept ze aan
• Het model beslist zelf wanneer welke tool te gebruiken: op basis van de gebruikersvraag

MCP-servers kunnen lokaal zijn (opgestart als subproces) of remote (HTTP). De meeste lokale servers worden gepubliceerd op npm en gestart via npx.

MCP-сервер AstroWay biedt één tool per API‑operatie, 735 in het npm-pakket en 843 op de gehoste server, met namen als astroway_<groep>_<operatie>:

• astroway_western_chart en verwante tools voor kaarten, transits, progressies en returns
• astroway_relational_* voor synastrie, composiet en groepskaarten
• astroway_ai_interpret_natal, astroway_ai_interpret_synastry: AI‑interpretaties
• groepen Human Design, Vedische, Chinese, Hellenistische astrologie, tarot en numerologie

Om de lijst te verkorten, sluit je één domein‑server aan in plaats van de volledige catalogus, zie MCP‑instellingen

Registreer je op astroway.info en maak een gratis API‑sleutel aan (10 000 credits/maand, zonder kaart).

Bestand claude_desktop_config.json:

• 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_your_key_here"
      }
    }
  }
}

Na het herstarten verschijnen de AstroWay‑tools in het toolmenu van het chat‑invoerveld.

Nu kun je gewoon in natuurlijke taal met Claude praten:

Jij: Maak een geboortehoroscoop voor een persoon geboren op 14 juli 1990 om 14:30 in Kiev. Wat betekent haar Zon in Kreeft in het 10e huis?

Claude: Roept natal_chart aan met de ontlede coördinaten, daarna interpret_placement. Hier is de geboortehoroscoop. Zon in Kreeft in het 10e huis wijst op…

Claude zelf:

• parseert natuurlijke taal (stad → coördinaten)
• kiest de juiste tool
• formatteert het antwoord

Als je een aangepaste AI‑agent bouwt (niet Claude Desktop), kun je ook 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 initialize
mcp.stdin.write(JSON.stringify({
  jsonrpc: '2.0',
  id: 1,
  method: 'initialize',
  params: { protocolVersion: '2024-11-05', capabilities: {} },
}) + '\n');

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

// Call a tool
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 agent‑frameworks (LangChain, LlamaIndex, enz.) hebben ingebouwde ondersteuning voor MCP.

Als je geen MCP‑overhead wilt – roep de HTTP‑API direct aan vanuit de 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();
}

// Use in your agent loop
const chart = await callAstrowayTool('chart', birthData);

Voordelen van MCP: gestructureerde tool‑beschrijvingen, autodetectie, gestandaardiseerde foutafhandeling. Voordelen van HTTP: eenvoudiger, werkt overal, zonder subprocessen.

Wanneer MCP is ingesteld, probeer het in Claude:

1. Wat is mijn dagelijkse horoscoop? 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 van twee personen: 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 de exacte geboortetijd niet. Wat toont de sensitivity‑analyse voor een bereik van ±30 min?

Claude kiest zelf de benodigde tools, roept ze in een keten aan en formatteert het antwoord in menselijk taal.

AI‑interpretatietools van AstroWay (interpret_*, *_horoscope) hebben ingebouwde safety‑guardrails:

• Geen medische, juridische of financiële adviezen
• Automatisch toegevoegde disclaimer‑s
• Contentfiltering

Wanneer de agent de interpretatietekst aan de gebruiker toont – bewaar de disclaimer. Deze staat in het veld disclaimer van elk AI‑antwoord.

MCP‑calls gaan via hetzelfde credit‑systeem als HTTP. Eenvoudige queries (10 credits) → chart (20) → synastrie (50) → AI‑interpretatie (50).

Voor persoonlijk gebruik (één gebruiker die Claude vragen stelt) – ongeveer 200–500 credits per maand. Gratis tarief ruimschoots beschikbaar.

Voor een productie‑agent met honderden gebruikers – reken op basis van de mix van endpoints. Daily‑horoscope‑bot voor 1 000 gebruikers = 1 000 × 20 × 30 = 600 000 credits/maand → Pro‑plan.

• AstroWay MCP op npm
• AI‑agenten en MCP: use case: volledige integratie‑gids
• Horoscope & AI Interpretations API: productpagina
• Snelle start: haal een API‑sleutel (gratis, 10 000 credits/maand)