AI-agenten en MCP

Bouw je een AI-agent die echte astrologische berekeningen moet doen in plaats van te hallucineren? AstroWay verbindt met Claude (Anthropic), ChatGPT-4 (OpenAI), Llama 3.3 (Groq), DeepSeek, Google Gemini, Mistral - via MCP, llms.txt of directe HTTP-calls. Drie integratiemethoden - kies op basis van het type agent:

• llms.txt: discovery-bestanden voor agents die documentatie lezen (Cursor IDE, Windsurf, Claude in de browser, custom RAG-pipelines op LangChain/LlamaIndex).
• MCP server: zero-code voor Claude Desktop, Cursor IDE, Windsurf, VS Code (llm CLI) en elke MCP-compatibele client (inclusief GPT met MCP via OpenAI Realtime API).
• HTTP API: directe aanroep vanuit je eigen agent of framework (LangChain, LlamaIndex, AutoGen, CrewAI).

llms.txt: discovery voor AI-agents

De site exposeert twee machineleesbare bestanden in het llms.txt-formaat:

• /llms.txt: index van alle documentatiepagina’s gegroepeerd per sectie (API Reference, Use Cases, Examples, Products). Klein, past in elke context window.
• /llms-full.txt: de volledige documentatie-inhoud als één plain-text bestand. Geschikt voor offline indexering in een vector database of een eenmalige dump in de context.

Wanneer gebruiken

Scenario	Bestand
Cursor/Windsurf “lees de astroway docs en help me met de integratie”	/llms.txt (de agent haalt zelf de benodigde secties op)
Eigen RAG-pipeline / vector database voor een FAQ-bot	/llms-full.txt (één fetch - het hele corpus)
Claude/ChatGPT in de browser: “hier is onze API, bouw een client”	/llms-full.txt in de prompt plakken
Production-agent die calls uitvoert	MCP server of HTTP API (zie hieronder)

Voorbeeld: pull in je eigen agent

const docs = await fetch('https://api.astroway.info/llms-full.txt').then(r => r.text());

const systemPrompt = `You are an integration assistant for AstroWay API.
Documentation:
${docs}

When the user asks how to do X, return a working code snippet using their API key.`;

Opmerking

De bestanden worden automatisch opnieuw gegenereerd bij elke release van de site. Versheid gegarandeerd: de API-versie onderaan /llms.txt komt overeen met de huidige production deploy.

MCP server (aanbevolen voor Claude Desktop)

Model Context Protocol (MCP) is een open standaard voor het verbinden van tools met AI-modellen. De MCP-server van AstroWay biedt 783 tools, één per API-operatie, plus 12 prompts en 14 resources.

Configuratie voor Claude Desktop

Voeg toe aan claude_desktop_config.json:

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

Na een herstart ziet Claude Desktop alle 783 tools. Om de lijst in te korten, stel je ASTROWAY_TOOL_GROUPS in of verbind je een domeinserver, zie MCP-configuratie.

Wat de MCP server kan

Tool	Wat het doet
astroway_western_chart	Berekening van een natale chart
astroway_relational_synastry	Synastrie van twee personen
astroway_horoscope_daily	Dagelijkse horoscoop
astroway_ai_interpret_natal	AI-interpretatie van een natale chart
astroway_hd_human_design	Volledige HD-chart
astroway_prognostics_transits	Huidige transits

Volledige lijst: 783 tools, de hele API, elk met een getypeerd response-schema.

Voorbeelddialoog met Claude

Gebruiker: Bouw een natale chart voor iemand geboren op 14 juli 1990 om 14:30 in Kyiv. Wat betekent Zon in Kreeft in het 10e huis?

Claude: Gebruikt astroway_western_chart voor de berekening, daarna astroway_ai_interpret_placement voor de interpretatie. Geeft planeetposities met echte data en een zinvolle interpretatie terug.

HTTP API

Voor AI-agents zonder MCP-ondersteuning - gebruik de HTTP API direct.

Voor contentgeneratie

TypeScript

// The AI agent calls /interpret/natal for an interpretation
const r = await fetch('https://api.astroway.info/v1/interpret/natal', {
  method: 'POST',
  headers: {
    'X-Api-Key': process.env.ASTROWAY_API_KEY!,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    date: '1990-07-14',
    time: '14:30:00',
    timezoneOffset: 3,
    latitude: 50.4501,
    longitude: 30.5234,
  }),
});

const { data: result } = await r.json();
// result.interpretation - ready AI interpretation
// result.disclaimer - disclaimer to display

Python

import os, requests

r = requests.post(
    'https://api.astroway.info/v1/interpret/natal',
    headers={'X-Api-Key': os.environ['ASTROWAY_API_KEY']},
    json={
        'date': '1990-07-14',
        'time': '14:30:00',
        'timezoneOffset': 3,
        'latitude': 50.4501,
        'longitude': 30.5234,
    },
)
result = r.json()['data']
# result['interpretation'] - ready AI interpretation
# result['disclaimer']     - disclaimer to display

cURL

curl -X POST https://api.astroway.info/v1/interpret/natal \
  -H "X-Api-Key: $ASTROWAY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "date": "1990-07-14",
    "time": "14:30:00",
    "timezoneOffset": 3,
    "latitude": 50.4501,
    "longitude": 30.5234
  }'

PHP

<?php
use GuzzleHttp\Client;

$aw = new Client(['base_uri' => 'https://api.astroway.info/v1/']);
$r = $aw->post('interpret/natal', [
    'headers' => ['X-Api-Key' => getenv('ASTROWAY_API_KEY')],
    'json' => [
        'date' => '1990-07-14',
        'time' => '14:30:00',
        'timezoneOffset' => 3,
        'latitude' => 50.4501,
        'longitude' => 30.5234,
    ],
]);

$result = json_decode($r->getBody(), true)['data'];
// $result['interpretation'] - ready AI interpretation
// $result['disclaimer']     - disclaimer to display

Voor berekeningen + je eigen LLM

// 1. Get raw data from /chart (cheaper - 20 credits)
const chart = await fetch('https://api.astroway.info/v1/chart', { ... });
const { data } = await chart.json();

// 2. Pass the data to your own LLM
const prompt = `Interpret this natal chart: ${JSON.stringify(data.planets)}`;
const llmResponse = await myLLM.generate(prompt);

Tip

Heb je alleen een interpretatie nodig - gebruik dan /interpret/* (50 credits, tekst is klaar). Wil je controle over de prompt - neem dan /chart (20 credits) en geef de data door aan je eigen LLM.

Scenario’s

Persoonlijke astrologische assistent

MCP server + Claude/ChatGPT. De gebruiker stelt een vraag - de agent berekent en interpreteert. Budget: Free-tarief voor persoonlijk gebruik.

Content-bot voor social media

Dagelijkse generatie van horoscopen voor 12 tekens via /horoscope/daily. 12 requests per dag = 240 credits. Free-tarief met ruime marge.

AI-coachingplatform

/interpret/natal + /interpret/transits voor elke klant. 100 klanten/dag = 10 000 credits/dag. Pro-tarief.

Snelstart → Eerste request in 5 minuten

Horoscope API AI-interpretaties en horoscopen

Tarieven Van gratis tot Enterprise