MCP - verbinding met Claude / Cursor

De Model Context Protocol server van AstroWay exposeert alle 771 endpoints als tools voor een AI-agent. Twee modi - beide worden native ondersteund door alle MCP-compatibele clients.

Modus	URL / commando	Wanneer te kiezen
Hosted HTTP	`https://mcp.astroway.info/mcp`	Claude Web (claude.ai in de browser), Claude Desktop / Cursor / Code newcomers zonder npm, of wanneer je zero-install wilt
Stdio (npm)	`npx @astroway/mcp`	Cursor power users, lokale ontwikkeling, privacy-bewust (sleutel verlaat je machine nooit), offline-ready

De hosted endpoint en het npm-pakket gebruiken dezelfde toolcatalogus (gegenereerd vanuit één /v1/openapi.json). Auth: dezelfde aw_test_* / aw_live_* API-sleutel - in hosted wordt deze verzonden via de Authorization: Bearer … header, in stdio via de ASTROWAY_API_KEY env var.

Bron: github.com/astroway/astroway-mcp · npm: npmjs.com/package/@astroway/mcp · hosted: mcp.astroway.info/health

Hosted (`mcp.astroway.info`) - zero install

Snelle start zonder npm - kies je client. Voordat je installeert, haal je de sleutel op via api.astroway.info/dashboard/sign-up (10.000 credits/maand gratis).

Klik op de knop - Cursor opent, vraagt om bevestiging, voegt de vermelding automatisch toe:

Installeren in Cursor →

Settings → Developer → Edit Config opent claude_desktop_config.json. Dit bestand start alleen lokale commando’s: een vermelding met alleen url wordt overgeslagen met de melding “Some MCP servers couldn’t be loaded”. De hosted-server wordt verbonden via de mcp-remote bridge, hiervoor is Node.js nodig:

{
  "mcpServers": {
    "astroway-hosted": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.astroway.info/mcp", "--header", "Authorization:${AUTH_HEADER}"],
      "env": { "AUTH_HEADER": "Bearer aw_live_..." }
    }
  }
}

Sluit Claude Desktop volledig af (Cmd+Q) en open opnieuw. De sleutel bevindt zich in env, omdat Claude Desktop op Windows het argument bij de spatie na Bearer verbreekt.

Het dialoogvenster Add custom connector in Settings → Connectors accepteert alleen een naam en URL; velden voor de Authorization header zijn er niet, dus de AstroWay-sleutel kan er momenteel niet via worden doorgegeven.

Voor Cursor, Cline, Continue en Windsurf, die een externe url direct accepteren:

{
  "mcpServers": {
    "astroway-hosted": {
      "url": "https://mcp.astroway.info/mcp",
      "headers": {
        "Authorization": "Bearer aw_live_..."
      }
    }
  }
}

Paden naar configuraties:

Cursor: ~/.cursor/mcp.json (globaal) of .cursor/mcp.json (in de workspace)
Cline (VS Code): .cline/mcp.json in de workspace
Continue: ~/.continue/config.json (blok mcpServers)
Windsurf: ~/.codeium/windsurf/mcp_config.json

Na bewerking de client volledig herstarten (Cmd+Q → opnieuw openen).

Verificatie

curl https://mcp.astroway.info/health
# {"status":"ok","version":"…","uptime_sec":…,"mcp_protocol_version":"…"}

Vraag in de client: “Lijst 5 AstroWay toolnamen van astroway-hosted”. Moet namen retourneren zoals astroway_western_chart, astroway_horoscope_daily, astroway_vedic_panchang_full, …

Rate limits

De hosted endpoint is beschermd door een 3-laags limiet: Cloudflare DDoS-laag + edge proxy 120 req/min/IP + in-memory bucket 60/60s/(IP+key). Echte MCP-clients (Claude Desktop, Cursor) komen niet in de buurt van deze limieten - ze doen geen burst-aanvragen. Als je automatisering / CI > 120 req/min vereist - gebruik de stdio modus (daar zijn geen limieten, het gaat direct via api.astroway.info/v1/* met je tarief-rate-limiet).

Wat als `mcp.astroway.info` tijdelijk niet beschikbaar is

Als de hosted endpoint 5xx retourneert, ziet de MCP-client een fout bij tools/list. Dit heeft geen invloed op stdio-clients - ze starten een lokaal npm-pakket dat direct naar api.astroway.info/v1/* gaat zonder een tussenliggende hosted-laag.

Fallback voor kritieke integraties: voeg een tweede MCP-server toe aan de configuratie met de stdio-modus - de client zal deze automatisch gebruiken als de hosted niet reageert op tools/list:

{
  "mcpServers": {
    "astroway": {
      "url": "https://mcp.astroway.info/mcp",
      "headers": { "Authorization": "Bearer aw_live_..." }
    },
    "astroway-fallback": {
      "command": "npx",
      "args": ["-y", "@astroway/mcp"],
      "env": { "ASTROWAY_API_KEY": "aw_live_..." }
    }
  }
}

De werkelijke uptime van de hosted endpoint is te zien op status.astroway.info. Incidenten > 5 minuten publiceren we als postmortem binnen 5 werkdagen (per /sla/).

Stdio (npm) - voor lokale ontwikkeling

@astroway/mcp - een npm-pakket dat lokaal als subprocess wordt uitgevoerd. Eén npm-pakket, native integratie met Claude Desktop, Cursor en elke MCP-compatibele client.

Hoe het werkt

De toollijst wordt op het moment van de build gegenereerd vanuit de live OpenAPI-spec (api.astroway.info/v1/openapi.json). Elke pakketrelease pakt automatisch alle nieuwe endpoints op - niets hoeft handmatig te worden onderhouden.

Elk endpoint wordt een tool van het type:

tools/list retourneert de beschrijving en het invoerschema (met een voorbeeld van de request body)
tools/call doet een HTTP POST naar https://api.astroway.info/v1/<path> met je ASTROWAY_API_KEY
Het antwoord wordt als gestructureerde JSON aan de agent geretourneerd

Elke release wordt ook geleverd met SLSA provenance (Sigstore-attested) - dit garandeert dat het npm-pakket is gebouwd vanuit de commit in de publieke repo.

Installatie

Claude Desktop (macOS)

Voeg toe aan ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "astroway": {
      "command": "npx",
      "args": ["-y", "@astroway/mcp"],
      "env": {
        "ASTROWAY_API_KEY": "aw_live_..."
      }
    }
  }
}

Herstart Claude Desktop. In de balk onder de chat verschijnt een 🛠️ indicator met het aantal geladen tools.

Cursor

Voeg toe aan ~/.cursor/mcp.json:

{
  "mcpServers": {
    "astroway": {
      "command": "npx",
      "args": ["-y", "@astroway/mcp"],
      "env": { "ASTROWAY_API_KEY": "aw_live_..." }
    }
  }
}

Cline / Continue / Windsurf / Copilot / VS Code MCP

Dezelfde npx @astroway/mcp commando werkt in elke MCP-compatibele client. De configuratie is identiek - alleen het pad naar het bestand verandert:

{
  "mcpServers": {
    "astroway": {
      "command": "npx",
      "args": ["-y", "@astroway/mcp"],
      "env": { "ASTROWAY_API_KEY": "aw_live_..." }
    }
  }
}

Client	Pad naar configuratie
Cline (VS Code)	`.cline/mcp.json` in de root van de workspace
Continue	`~/.continue/config.json` (onder `mcpServers`)
Windsurf	`~/.codeium/windsurf/mcp_config.json`
GitHub Copilot Chat (VS Code)	preview-flag → `mcp.json` in de workspace
VS Code MCP extension	`~/.vscode/mcp.json`

Andere MCP-clients

Start als stdio-server:

ASTROWAY_API_KEY=aw_live_... npx @astroway/mcp

Privacy - vanaf v1.0.0+

Deze MCP-server stuurt niets terug naar AstroWay behalve de API-aanroepen die je hem laat uitvoeren. Geen telemetrie, geen analytics, geen opt-in/opt-out schakelaar - stilte standaard.

Uitgaande verzoeken dragen twee identificerende headers zodat de AstroWay backend MCP-verkeer kan onderscheiden van direct HTTP in zijn eigen logs:

User-Agent: astroway-mcp/<version> (Node/<node-version>)
X-Astroway-Channel: mcp

Geen van deze bevat een sessie-ID, machine-fingerprint of iets persoonlijks. Dit is standaard User-Agent semantiek - elke CLI-tool stuurt vergelijkbare informatie.

Subset-registratie - vanaf v1.0.0+

Als je slechts een deel van de catalogus gebruikt - registreer een subset zodat het contextvenster van de LLM compact blijft:

{
  "env": {
    "ASTROWAY_API_KEY": "aw_live_...",
    "ASTROWAY_TOOL_GROUPS": "western,vedic,relational",   // only these prefixes
    "ASTROWAY_READONLY": "1"                               // skip ai/horoscope/reports (LLM-backed, costs credits)
  }
}

Veelvoorkomende groepen: western, vedic, tarot, numerology, hd (Human Design), relational (synastry/composite/davison), prognostics (transits/progressions/returns), aspects, horary, geo, chinese, bazi, mayan, iching, runes, geomancy. Voer npx @astroway/mcp --list-tools uit om de volledige set te zien.

ASTROWAY_READONLY=1 slaat drie groepen over die intern LLM aanroepen (ai, horoscope, reports) - handig wanneer je pure, deterministische kaartberekeningen wilt zonder creditkosten voor tekstgeneratie.

Stabiliteitsverbintenis - vanaf v1.0.0+

Catalogus is bevroren voor de duur van de sessie. 780+ tools, 12 prompts, 14 resources zijn ingebed in het gepubliceerde npm-pakket op het moment van de build - niets verandert tijdens de verbinding. Als je client tools/list cachet na de eerste aanroep - blijft deze correct voor de hele sessie.
Tool-identifiers zijn stabiel binnen een major-versie. De naam onder astroway_<group>_<tool> zal niet worden hernoemd of verwijderd binnen v1.x zonder een deprecation note in CHANGELOG.md en gelijktijdige beschikbaarheid in een minor-versie.
Tool-invoerformaat is stabiel binnen een minor-versie. Aanscherpingen (regex, range, enum) komen in patches; het toevoegen van een verplicht veld vereist een minor bump.
Catalogus vernieuwen: door herinstallatie. npm i -g @astroway/mcp@latest (of de npx -y @astroway/mcp vorm in je configuratie) haalt de huidige set op bij de volgende start.

Voorbeelden van prompts

Vraag de AI na het verbinden van de server:

Geboortehoroscoop

Bereken mijn geboortehoroscoop - geboren op 15 maart 1990, 14:30, Kyiv. Beschrijf de Zon, Maan, Ascendant en vind de nauwe aspecten.

Claude roept de chart tool aan met je parameters, ontvangt gestructureerde JSON en beschrijft de horoscoop in woorden.

Transits

Welke significante transits van langzame planeten zullen mijn geboortehoroscoop beïnvloeden gedurende 2027?

Claude doet twee tool-calls: eerst transits (huidige momentopname), daarna transit-calendar (bereik). Interpreteert trends.

Vedische Mahadasha

Voer Vimshottari Mahadasha uit voor een persoon geboren op 22.07.1985 06:45 in Mumbai. In welke periode bevindt deze persoon zich nu?

Via de vedic/dashas/vimshottari/maha tool - de exacte UTC-tijdstempel van de huidige periode.

Synastrie

Vergelijk twee horoscopen: A - 10.06.1988 09:15 Londen, B - 22.11.1991 22:40 Berlijn. Wat zijn de sterkste kruis-aspecten?

synastry tool met twee chart blokken + interpretatie van de compatibiliteitsscore.

Tarot

Trek 3 Rider-Waite-Smith kaarten: Verleden - Heden - Toekomst. Vraag: “moet ik de nieuwe baan aannemen?”. Seed = 42.

tarot/rider-waite/spread met een vaste seed voor reproduceerbaarheid.

Lijst van alle tools

Vraag Claude na het verbinden:

Lijst alle AstroWay-tools op.

Of vanaf de commandoregel:

ASTROWAY_API_KEY=aw_test_smoke npx @astroway/mcp 2>&1 | head -1
# (starts the stdio server; tool-list calls come from the MCP client over the protocol)

Configuratie

Variabele	Standaard	Beschrijving	Vanaf versie
`ASTROWAY_API_KEY`	(verplicht)	Live: `aw_live_...`. Sandbox: `aw_test_...`.	0.1.0
`ASTROWAY_BASE_URL`	`https://api.astroway.info/v1`	Override voor self-hosted/staging-omgevingen.	0.1.0
`ASTROWAY_TOOL_GROUPS`	(alle groepen)	Door komma’s gescheiden prefixes om de catalogus te beperken (`western,vedic,relational`).	1.0.0
`ASTROWAY_READONLY`	`0`	`1` slaat LLM-ondersteunde groepen over (`ai`, `horoscope`, `reports`).	1.0.0
`LOG_LEVEL`	`error`	`silent`/`error`/`warn`/`info`/`debug` - logniveau naar stderr.	0.8.0
`LOG_FILE`	(wordt niet geschreven)	Pad naar bestand voor het dupliceren van logs.	0.8.0
`MCP_FLAT_TOOLS`	`0`	`1` retourneert pre-v0.9 flat-namen (`chart` in plaats van `astroway_western_chart`). Legacy.	0.9.0

Waarom MCP, en geen directe integratie

Generieke LLM (zonder grounding) zal zeggen “ergens in juli zal Saturnus een driehoek vormen met je Jupiter” - zonder exacte datum, met ±15 dagen drift. Een MCP-agent doet een tool_use POST /v1/transits en retourneert een UTC-tijdstempel tot op de seconde, gebaseerd op de echte Swiss Ephemeris.

Het voordeel zit niet in de LLM, maar in de garantie dat de wiskunde echt is - niet verzonnen.

Pakketdistributie

mcp.so listing: mcp.so/server/astroway-mcp/astroway
mcpservers.org: wacht op goedkeuring (per mei 2026)
awesome-mcp-servers (punkpeye): PR #5972