MCP server

AstroVibe ships a remote Model Context Protocol server — Claude, Cursor, Codex and any MCP client can compute real charts, dashas and readings, no SDK needed.

1 · Endpoints

Streamable HTTP transport. Authenticate with your API key in the x-api-key header.

…/mcp — all tools · …/mcp/docs — keyless search_docs (endpoint lookup for coding agents)
…/mcp/astrology
Western astrology — natal charts, houses, aspects, horoscopes
…/mcp/vedic-astrology
Vedic / Jyotish — kundli, dashas, panchang, KP, yogas
…/mcp/chinese
BaZi Four Pillars + Zi Wei Dou Shu
…/mcp/numerology
Life Path, Expression, Soul Urge
…/mcp/synastry
Ashta Kuta compatibility
…/mcp/universal
Cross-tradition synthesis report

2 · Connect from Claude Desktop

claude_desktop_config.json

{
  "mcpServers": {
    "astrovibe": {
      "url": "https://astro-vibe-engine.gauravapproved.workers.dev/mcp",
      "headers": { "x-api-key": "av_YOUR_KEY" }
    }
  }
}

3 · Or call it directly

cURL

curl -X POST https://astro-vibe-engine.gauravapproved.workers.dev/mcp/message \
  -H 'Content-Type: application/json' \
  -H 'x-api-key: av_YOUR_KEY' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}}'

What agents can do

· Compute natal charts, kundlis, dashas and transits from birth data.
· Pull tarot spreads, I-Ching casts, dream symbols and angel numbers.
· Every tool returns deterministic JSON — the agent never invents positions.
· Same API key, same quotas — MCP usage counts against your plan.
· compact: true on any tool trims response tokens (lossless columnar arrays, no pretty-printing) — decode by transposing rows against columns.
· …/mcp/docs is keyless — coding agents can search_docs before writing code.

API reference Quickstart