MCP SERVER

Give your AI agent astrology knowledge.

Connect AstrologyAPI to Claude, ChatGPT, Cursor, or any MCP-compatible tool. Your agent can now run real birth chart calculations, generate Kundlis, and answer planetary questions mid-conversation — with live data, not static text.

SEE IT LIVE

Working in 60 seconds.

MCP lets any AI agent call external tools during a conversation. This clip shows Claude using our server to look up a birth chart and answer a planetary question — no pre-written responses.

Claude + AstrologyAPI MCP — answering "What is my moon sign?" by calling our live calculation API.

📌

What is MCP?

Model Context Protocol is an open standard from Anthropic that lets AI assistants call external tools mid-conversation. Connecting our MCP server gives any compatible AI agent the ability to run real astrology calculations — not just recall training data.

What happens when
a user asks a question

🔄 MCP Request Flow
Live architecture
💬

User

"What planets are in my 7th house?"

message

🤖

AI Agent

Claude, GPT-4, or your custom agent

tool call

AstrologyAPI MCP

Runs the live calculation

calculation

🪐

Structured Result

Venus in Libra, House 7 — exact degree

reply

💬

User Gets

A natural language answer grounded in real data

Works with the AI tools
you already use

🧠

Claude (Anthropic)

Add one block to claude_desktop_config.json and Claude can answer chart questions in any conversation. Works with Claude Desktop and the Claude API.

💡

ChatGPT / OpenAI

Compatible with GPT-4o and any model that supports tool use. Calculations run on our server, not in the model's weights.

⌨️

Cursor / Windsurf / Cline

MCP-enabled editor agents can query the astrology server during a coding session. Useful for teams building astrology apps who want live data in their development context.

🔧

Custom AI Agents

LangChain, CrewAI, AutoGen, or your own framework. Register our MCP server as a tool and your agent gets the full calculation surface — charts, transits, compatibility.

📱

Your App's AI Assistant

Real calculation power for your product's chatbot. Users get chart-specific answers, not generic horoscope text.

📡

Any MCP-Compliant Tool

MCP is an open standard. Any client that speaks the protocol connects without modification. We handle the astrology calculation layer on our end.

GET STARTED

Connected in under 5 minutes.

Add one config block to your MCP client. Your AI agent immediately gains access to the full AstrologyAPI calculation engine.

claude_desktop_config.json

1{
2  "mcpServers": {
3    "astrologyapi": {
4      "url": "https://mcp.astrologyapi.com/mcp",
5    }
6  }
7}

Your AI agent. With real astrology knowledge.

Connect in minutes. 100 free calculation calls to test every endpoint — no credit card required.

Support

Frequently Asked Questions

Everything you need to know about the Astrology MCP Server and integration.

An MCP-compatible server that lets AI assistants perform professional astrology calculations mid-conversation. It covers both Vedic (Jyotish) and Western traditions — birth charts, dashas, compatibility, yogas, and transits — with live calculation data, not pre-written text.

Any MCP-compliant client: Claude Desktop (macOS & Windows), Cursor, VS Code extensions (Claude Dev, Roo Cline), ChatGPT via proxy, and any agent built on LangChain, CrewAI, or similar frameworks.

Vedic: birth charts, D1–D60 divisional charts, Vimshottari Dasha, yogas, Ashtakvarga, Lal Kitab, KP sub-lords. Western: natal charts, synastry, progressions, transits, solar returns across 6 house systems.

Vedic interpretations: English, Hindi, Marathi, Bengali, Tamil, Telugu, Malayalam, Kannada. Western: English, Spanish, Portuguese, French, Italian, German, Russian.

Your AstrologyAPI User ID and API Key go in the MCP client config headers. Manage sessions from your developer dashboard — no separate credential system required.

Yes. New accounts include a free trial covering the full server — test every calculation type across Vedic and Western traditions before choosing a plan.