World's First

Vedic Astrology MCP Server

Astrology Tools for Your AI

Connect Claude, ChatGPT, Kiro, or any AI assistant to Vedic astrology. Get horoscope predictions, compatibility match reports, numerology analysis, and decode planetary influences — all through one simple MCP connection.

Buy API Key - $1/mo Connect Now Try Live Demo

Free tier: 5 requests/minute • No sign-up required

AI meets Vedic Astrology - MCP Server

1st

Astrology MCP Server in the World

200+

Horoscope Predictions Analyzed

Free

5 Requests/Minute Free Tier

$1/mo

Unlimited Use with API Key

AI connecting to Vedic Astrology

What is MCP?

MCP (Model Context Protocol) is the open standard created by Anthropic that lets AI assistants connect to external tools and data sources. Think of it as a universal plug that gives any AI the ability to access real-world capabilities.

VedAstro's MCP Server brings the full power of Vedic astrology — horoscope predictions, compatibility matching, numerology, planetary positions, yogas, and house analysis — directly into AI conversations.

Why It Matters

Natural Conversations

Ask your AI "What does my birth chart say?" and get real Vedic astrology analysis, not generic horoscopes.

Works with Any AI

Claude, ChatGPT, AWS Kiro, Cursor, Gemini, OpenClaw — any MCP-compatible client works.

Authentic Calculations

Powered by VedAstro's Swiss Ephemeris engine with Raman Ayanamsa — the same precision astrologers trust.

Zero Code Required

Just paste one URL into your AI client's settings. No SDKs, no libraries, no API wrappers needed.

How It Works

Three simple steps to Vedic astrology-powered AI

Configure, Ask, Receive - 3 steps
1
Copy the URL

Copy the MCP server endpoint URL from below

2
Paste in Your AI

Add it to Claude Desktop, ChatGPT, AWS Kiro, or any MCP client

3
Ask Anything

"What are my horoscope predictions?" and your AI delivers Vedic insights

MCP Server Endpoints

Use the protected URL for app-style remote MCP setup, OAuth discovery, or direct bearer-auth flows. Use the public URL when your client relies on manual headers, config files, or deterministic local setup.

Protected / App https://mcp.vedastro.org/api/mcp
Public Manual https://mcp.vedastro.org/api/mcp/public

Quick Connect Guide

Pick your AI app, inspect the exact setup path, and copy the right VedAstro MCP snippet for your environment.

Mini Docs Widget

Find the right guide for your AI app

Browse app-based, dev-tool, and self-hosted MCP clients. Each guide shows the exact endpoint, auth mode, transport, and copy-paste config that currently matches the VedAstro server behavior.

Protected app URL: /api/mcp Manual headers: /api/mcp/public Transport: HTTP POST / Streamable HTTP Unlimited access via subscriber key
Troubleshooting

If a connector opens a broken authorize page

Some clients may still open /api/oauth/authorize even when their manual connector fields are the more reliable path. If that page fails or returns HTTP 500, switch back to the client settings screen and use the documented manual setup for that provider instead of waiting on the browser flow.

For Claude Desktop, the currently validated path is: protected URL /api/mcp, vedastro as Client ID, and your VedAstro subscriber key as the secret in Advanced settings.

Claude Desktop VedAstro connector settings example

Available MCP Tools

What your AI can do with VedAstro connected

get_horoscope_predictions
Available

Get comprehensive Vedic astrology horoscope predictions for a person based on their birth time and location. Returns 200+ life predictions covering personality, career, relationships, health, wealth, marriage, children, longevity, and more based on planetary positions, yogas, and house placements.

latitude - Birth location latitude longitude - Birth location longitude birth_time - HH:MM format birth_date - DD/MM/YYYY format timezone - +HH:MM format sort_by_weight - Sort by importance (optional, default: true)
get_match_report
Available

Get a Vedic astrology compatibility/match report between two people. Returns Kuta score percentage and detailed predictions for all 16 Kuta factors (Dina, Gana, Mahendra, Stree Deergha, etc.). Each factor is rated as Good or Bad with a detailed explanation.

male_* - Male birth details (lat, lon, time, date, tz) female_* - Female birth details (lat, lon, time, date, tz)
get_numerology_prediction
Available

Get a numerology prediction based on a name using the Chaldean system. Returns the name number, ruling planet, detailed prediction, and life aspect scores (Finance, Romance, Education, Health, Family, Growth, Career, Reputation, Spirituality, Luck). Works for person names, business names, project names, house numbers, or car numbers.

name - Name to analyze
get_context_based_astrology_data
Available AI-routed

Single smart entrypoint for natal, transit, and current-sky questions. It accepts a plain-English query plus either birth_*, check_*, or both; then semantically ranks the top 10 matching Calculate methods (from 640+ options), enriches the request with RAG context, and invokes the matches in parallel. This is also the replacement for the old live-sky flow: for questions like "moon sign today" or "is Mercury retrograde right now?", send only the check_* block.

query - Plain-English description birth_* - Natal query inputs check_* - Current / transit query inputs location_name - Optional birth place label check_location_name - Optional observer place label
get_current_transits
Available

Get current planetary transit (Gochara) positions for all 7 Vedic planets relative to your birth chart. Returns each planet's current zodiac sign, Ashtakvarga Bindu score (0-8, higher is more favorable), Sarvashtakavarga score, Kaksha lord, and Kaksha score.

latitude - Birth location latitude longitude - Birth location longitude birth_time - HH:MM format birth_date - DD/MM/YYYY format timezone - +HH:MM format
find_best_times_for_task
Available

Finds the best upcoming windows for a task like travel, marriage, haircuts, launch dates, moving, and similar timing questions. It selects relevant event filters, generates chart evidence, merges the result windows, and returns ranked date ranges.

task - Natural-language timing question latitude - Birth location latitude longitude - Birth location longitude birth_time - HH:MM format birth_date - DD/MM/YYYY format timezone - +HH:MM format start_date / end_date - Optional search range max_results - Optional ranked windows count
get_dasa_at_time
Available

Get the Vimshottari dasa periods active at any specific past or future date. Use for questions like "what dasa was I in when..." or "what dasa will I be in on...". Returns nested dasa structure with nature ratings and descriptions.

latitude - Birth location latitude longitude - Birth location longitude birth_time - HH:MM format birth_date - DD/MM/YYYY format timezone - +HH:MM format check_date - Date to check (DD/MM/YYYY) check_time - Time to check (optional, default: 12:00) levels - Dasa depth 1-8 (optional, default: 3)
search_website_pages
Available

Searches a curated VedAstro website catalog and recommends the most relevant product or support pages. Useful when the user is really asking where on vedastro.org they should go next rather than for a chart calculation.

query - Website/help question max_results - Optional match count include_content - Include extracted page markdown
resolve_location
Available

Resolves a free-text place name (e.g. "Chennai, India") into latitude, longitude, and timezone offset. Use it as a prerequisite step before any chart tool that needs geographic coordinates.

location_name - Place / city to resolve
predict_birth_time_range_ncc
Available

Narrows an unknown birth time down to ranked candidate windows using the NCC (Natal Chart Compatibility) machine-learning model over a user-supplied search range.

latitude / longitude - Birth location birth_date - DD/MM/YYYY format timezone - +HH:MM format time_range_start / time_range_end - Search window
get_horary_prediction
Available

Answers a specific yes/no or situational question by casting a Prashna (horary) chart for the moment the question is asked, then summarising the result as a query-aware prediction.

question_text - The horary question horary_number - 1–249 (KP horary) latitude / longitude - Asker's location timezone - +HH:MM format

Live Demo

Test the MCP Server's horoscope predictions right here

See It in Action

A real conversation with Claude using VedAstro MCP Server

I was born on October 25, 1992 at 2:30 PM in Mumbai, India. What are my Vedic horoscope predictions?

Thought process

Running a completely fresh batch of 20 new names

Get numerology prediction
Using VedAstro...

Based on your Vedic birth chart analysis (Mumbai, 25/10/1992 at 14:30):

Career & Success: You have strong Raja Yoga combinations suggesting leadership abilities and professional success. Jupiter's influence on the 10th house indicates wisdom-driven career growth.

Personality: Moon in a benefic position gives you emotional intelligence and intuitive abilities.

Relationships: Venus placement suggests harmonious partnerships with strong emotional bonds...

...and 200+ more detailed predictions covering all life areas

Simple Pricing

Start free, upgrade when you need more

Free

$0

forever

  • 5 requests per minute
  • No sign-up required
  • All MCP tools included
  • Full prediction data
Get Started Free
Most Popular

Unlimited

$1

per month

  • Unlimited requests
  • Priority response times
  • All MCP tools included
  • Works across all your AI clients
Buy Now - $1/month

Technical Specifications

Protocol

Model Context Protocol (MCP) via Streamable HTTP transport

Infrastructure

Azure Functions v4 (Node.js 20+) with the MCP SDK's Streamable HTTP server transport

Ephemeris Engine

Swiss Ephemeris with Raman Ayanamsa for precise planetary calculations

Response Time

Typically under 5 seconds for full horoscope prediction analysis

Security

HTTPS encrypted with protected MCP OAuth metadata, bearer token support, direct subscriber-key bearer support, and public header-based access

Auth Modes

/api/mcp for protected bearer / OAuth-capable clients, and /api/mcp/public for anonymous or header-based setups using x-api-key, APIKey, or Authorization: Bearer

Open Source

Full source code available on GitHub

Frequently Asked Questions

MCP (Model Context Protocol) is an open standard developed by Anthropic that allows AI assistants to connect to external tools and data sources. It's like USB for AI — a universal connector that lets any compatible AI access VedAstro's Vedic astrology calculations without custom integration code. This means Claude, ChatGPT, and other AI tools can all use VedAstro through the same simple connection.

MCP is supported by Claude Desktop, ChatGPT connectors, AWS Kiro, Cursor, Windsurf, VS Code agent workflows, Google Gemini, OpenClaw, and many more AI assistants and chat applications. Any client that supports Streamable HTTP MCP can connect, either through protected bearer/OAuth flows or the public manual endpoint.

Yes. The public MCP endpoint works anonymously at 5 requests per minute with no sign-up required. If you need more, use a VedAstro subscriber key for unlimited requests through either the protected endpoint or public header-based setup.

VedAstro uses the Swiss Ephemeris — the same precision astronomical engine used by professional astrologers worldwide. Calculations use the Raman Ayanamsa system and now include dedicated MCP support for natal analysis, transits, dasa periods, semantic method search, timing windows, and guided website knowledge lookup.

Absolutely! The MCP server is designed to be used by any MCP-compatible client. If you're building an AI-powered astrology app, this is the easiest way to add Vedic astrology capabilities. For direct API access (without MCP), check out the API Builder page.

Bring Ancient Wisdom to the AI Age

VedAstro's MCP Server bridges 5,000 years of Vedic astrology with modern AI. Connect in 30 seconds and give your AI the power of horoscope predictions, compatibility matching, and numerology.

Buy API Key - $1/month Connect Now - It's Free View on GitHub