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.

Seamlessly Connect to ChatGPT

Our OAuth Bridge allows you to securely map your AstrologyAPI engine to ChatGPT in seconds. No complex setup, just a secure token that puts high-accuracy astrology at your AI's fingertips.

Access Dashboard

Log in to your AstrologyAPI developer dashboard and navigate to the MCP Server section.

Generate Bridge

Click on "Create MCP Token" and select your preferred subscription or wallet as the source.

Connect to AI

Copy your secure Token and paste it into ChatGPT or other MCP-compatible clients.

astrologyapi_bridge_jwt_...

Copy to ChatGPT

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.