◆ New · Model Context Protocol server

The Most Complete Astrology MCP Server

Connect Claude, ChatGPT, Cursor or any MCP client to 224 live astrology, horoscope, tarot and numerology tools. No plugins, no glue code — one URL.

3 specialized servers • Swiss Ephemeris precision • Works with any MCP client • From 72ms response time

Get API Key View MCP Docs
MCP https://mcp.divineapi.com/western/mcp
224 MCP Tools
3 Specialized Servers
300+ API Endpoints Behind It
99.9% Uptime SLA

Three servers, one protocol

Each server exposes a focused toolset. Connect one, two or all three — same credentials.

104 tools

Indian / Vedic Astrology

Panchang, Kundli, dashas, doshas, matchmaking, Lal Kitab & festivals.

https://mcp.divineapi.com/indian/mcp
57 tools

Western Astrology

Natal, synastry, transits, composite charts, progressions & returns.

https://mcp.divineapi.com/western/mcp
63 tools

Horoscope, Tarot & Numerology

Daily to yearly horoscopes, tarot spreads, numerology & PDF reports.

https://mcp.divineapi.com/horoscope/mcp

What happens when a user asks a question

MCP REQUEST FLOW LIVE ARCHITECTURE

AI Agent

“What's today's Panchang for London?”

DivineAPI MCP

divine_get_panchang

Runs the live calculation

Structured Result

Tithi, nakshatra, yoga, karana — exact timings

Calculations run on DivineAPI servers with Swiss Ephemeris precision — not in the model's weights. The AI only phrases the answer.

Works with the AI tools you already use

Claude (Anthropic)

Add one block to claude_desktop_config.json and Claude answers chart questions in any conversation. Works with Claude Desktop, Claude Code and the Messages API.

ChatGPT / OpenAI

Connect as a custom connector with OAuth, or via the Agents SDK. Calculations run on our servers, not in the model's weights.

Cursor / VS Code / Cline

MCP-enabled editor agents can query live astrology data during a coding session — ideal for teams building astrology apps.

Custom AI Agents

LangChain, CrewAI, AutoGen or your own framework. Register the server once and your agent gets the full calculation surface.

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 layer.

Seamlessly connect to Claude

Same API key and auth token as the REST API — no separate MCP subscription, no OAuth app to build. Live astrology at your AI's fingertips in under a minute.

  • Get your keysGrab your API key and auth token from divineapi.com/api-keys.
  • Add one blockPaste the config into claude_desktop_config.json — macOS or Windows.
  • Restart & askRestart Claude Desktop. All 104 Vedic tools appear automatically.
claude_desktop_config.json
{
  "mcpServers": {
    "divineapi-indian": {
      "url": "https://mcp.divineapi.com/indian/mcp",
      "headers": {
        "X-Divine-Api-Key": "your_api_key",
        "X-Divine-Auth-Token": "your_auth_token"
      }
    }
  }
}

Seamlessly connect to ChatGPT

Add DivineAPI as a custom connector in ChatGPT, or wire it into your own OpenAI-powered app. The same credentials power both.

  • Get your keysGrab your API key and auth token from divineapi.com/api-keys.
  • Add the connectorIn ChatGPT settings, add a custom MCP connector pointing at the server URL.
  • Ask awayChatGPT calls the right tool and returns exact chart data.
ChatGPT → Settings → Connectors
Server URL
  https://mcp.divineapi.com/indian/mcp

Authentication  →  Custom headers
  X-Divine-Api-Key:    your_api_key
  X-Divine-Auth-Token: your_auth_token

Seamlessly connect to Claude Code

One command registers the server in your terminal. Every session can then call live astrology tools right where you build.

  • Get your keysGrab your API key and auth token from divineapi.com/api-keys.
  • Run the commandRegister the HTTP server with your two credential headers.
  • Start codingAsk Claude for a Panchang or Kundli without leaving your editor.
terminal
claude mcp add divineapi-indian \
  --transport http \
  https://mcp.divineapi.com/indian/mcp \
  --header "X-Divine-Api-Key: your_api_key" \
  --header "X-Divine-Auth-Token: your_auth_token"

Seamlessly connect to Cursor

Drop a block into your MCP config and Cursor, VS Code or Cline can query DivineAPI mid-session — ideal for building astrology apps.

  • Get your keysGrab your API key and auth token from divineapi.com/api-keys.
  • Add the blockPaste it into .cursor/mcp.json (or your editor's MCP settings).
  • Query live dataYour agent pulls exact chart data as you code.
.cursor/mcp.json
{
  "mcpServers": {
    "divineapi-indian": {
      "url": "https://mcp.divineapi.com/indian/mcp",
      "headers": {
        "X-Divine-Api-Key": "your_api_key",
        "X-Divine-Auth-Token": "your_auth_token"
      }
    }
  }
}

Seamlessly connect to OpenAI Agents

Register the hosted MCP server once and your agent gets the full calculation surface as callable tools.

  • Get your keysGrab your API key and auth token from divineapi.com/api-keys.
  • Add the toolPass the server URL and headers to a HostedMCPTool.
  • Run the agentThe model picks tools and returns structured results.
agent.py
from agents import Agent, HostedMCPTool

agent = Agent(
    name="Astrologer",
    tools=[
        HostedMCPTool(
            server_url="https://mcp.divineapi.com/indian/mcp",
            headers={
                "X-Divine-Api-Key": "your_api_key",
                "X-Divine-Auth-Token": "your_auth_token",
            },
        )
    ],
)

Seamlessly connect to Gemini

Open an MCP session over HTTP and expose the tool list to Gemini as function declarations.

  • Get your keysGrab your API key and auth token from divineapi.com/api-keys.
  • Open a sessionConnect with the streamable HTTP client and your headers.
  • Call toolsForward Gemini's tool calls to the MCP session.
gemini_mcp.py
from mcp import ClientSession
from mcp.client.streamable_http import streamablehttp_client

async with streamablehttp_client(
    "https://mcp.divineapi.com/indian/mcp",
    headers={
        "X-Divine-Api-Key": "your_api_key",
        "X-Divine-Auth-Token": "your_auth_token",
    },
) as (read, write, _):
    session = await ClientSession(read, write).__aenter__()
    tools = await session.list_tools()   # → Gemini function declarations

Seamlessly connect to Claude API

Reference the MCP server directly from the Messages API using the single-token bearer format.

  • Get your keysGrab your API key and auth token from divineapi.com/api-keys.
  • Add the serverJoin both credentials with a colon as the authorization token.
  • Send a messageClaude calls tools and returns the phrased answer.
messages.py
import anthropic

client = anthropic.Anthropic()

client.beta.messages.create(
    model="claude-opus-4-8",
    max_tokens=1024,
    messages=[{"role": "user", "content": "Today's Panchang for Delhi?"}],
    mcp_servers=[{
        "type": "url",
        "url": "https://mcp.divineapi.com/indian/mcp",
        "name": "divineapi-indian",
        "authorization_token": "your_api_key:your_auth_token",
    }],
    betas=["mcp-client-2025-04-04"],
)

Real answers,
not generic horoscopes

Without live data, an AI can only guess. With the DivineAPI MCP server it calculates — exact tithis, degrees and timings for the user's date and place, phrased naturally.

  • The model picks the right tool from the description alone
  • Structured JSON comes back in well under a second
  • Works the same in chat apps, editors and your own product

Every tool, one search away

All 224 tools your AI can discover — each maps 1:1 to a DivineAPI endpoint.

224 tools
divine_get_panchang divine_get_tithi divine_get_nakshatra divine_get_karana divine_get_surya_nakshatra divine_get_yoga_panchang divine_get_choghadiya divine_get_nivas_and_shool divine_get_ritu_and_anaya divine_get_samvat divine_get_chandrabalam_and_tarabalam divine_get_other_calendars_and_epoch divine_get_sun_moon divine_get_auspicious_timings divine_get_inauspicious_timings divine_get_basic_astro_details divine_get_planetary_positions divine_get_horoscope_chart divine_get_bhava_kundli divine_get_planet_analysis divine_get_ashtakvarga divine_get_kundli_matching divine_get_manglik_dosha divine_get_kaalsarp_dosha divine_get_pitra_dosha divine_get_sadhesati divine_get_vimshottari_dasha divine_get_yogini_dasha divine_get_char_dasha divine_get_lalkitab_debts divine_get_lalkitab_remedies divine_get_gem_suggestion divine_get_rudraksha_suggestion divine_get_sade_sati_life divine_get_festivals divine_get_natal_chart divine_get_natal_wheel divine_get_house_cusps divine_get_aspects divine_get_western_positions divine_get_synastry divine_get_composite_chart divine_get_transits divine_get_progressions divine_get_solar_return divine_get_lunar_return divine_get_moon_phases divine_get_retrogrades divine_get_ascendant_report divine_get_planet_report divine_get_house_report divine_get_aspect_report divine_get_daily_horoscope divine_get_weekly_horoscope divine_get_monthly_horoscope divine_get_yearly_horoscope divine_get_chinese_horoscope divine_get_love_compatibility divine_get_tarot_single divine_get_tarot_three_card divine_get_tarot_celtic_cross divine_get_life_path_number divine_get_destiny_number divine_get_lucky_number divine_get_numerology_pdf divine_get_natal_report_pdf

Showing a representative sample — the full catalog of 224 tools ships with every server.

Authenticate your way

All three methods use the same credentials from divineapi.com/api-keys.

Recommended

Header-Based Auth

Two HTTP headers on every request. Works with VS Code, Claude Desktop, Claude Code, OpenAI, Gemini and custom clients.

X-Divine-Api-Key: your_api_key
X-Divine-Auth-Token: your_auth_token

Single Bearer Token

For platforms with one credential field, like the Claude Messages API. Join both credentials with a colon.

Authorization: Bearer
  your_api_key:your_auth_token

OAuth 2.1

For ChatGPT's connector flow. Authorize once in the browser; tokens refresh automatically — no keys stored in config.

Authorize at
  mcp.divineapi.com/oauth/authorize

Frequently asked questions

Do I need a separate MCP subscription?
No. The MCP servers use the same API key and auth token as the REST API. Any plan that covers an endpoint also covers its MCP tool — get keys at divineapi.com/api-keys.
Which AI platforms are supported?
Any MCP-compliant client: Claude (Desktop, Code and the Messages API), ChatGPT, Cursor, VS Code, Cline, the OpenAI Agents SDK, Gemini, and custom LangChain / CrewAI / AutoGen agents.
Where do the calculations run?
On DivineAPI's servers with Swiss Ephemeris precision. The model never guesses — it calls a tool, we calculate, and it phrases the structured result.
Do the tools return the same data as the REST API?
Yes. Each MCP tool maps 1:1 to a DivineAPI endpoint and returns the identical structured JSON — the protocol is just a different door to the same calculations.
How is usage billed?
MCP tool calls count against the same quota as REST calls on your plan. There's no separate MCP metering and no extra fee.
Is there a free trial?
Yes — start a 14-day free trial, grab your keys, and your assistant can answer its first chart question in under a minute.
◆ 224 tools · 3 servers · one API key

Give your AI real astrology today

Get an API key in seconds — your assistant answers its first chart question in under a minute.

Get API Key View MCP Docs
DivineAPI - The Most Complete Astrology API Platform Start for free Start free trial

Product

Menus

DOCs

Others

DivineAPI on Facebook DivineAPI on Instagram DivineAPI on YouTube DivineAPI on LinkedIn DivineAPI on Twitter

© DivineAPI.com