World's First

Vedic Astrology MCP Server

Astrology Tools for Your AI

Connect Claude, ChatGPT, 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.

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

1st

Astrology MCP Server in the World

200+

Horoscope Predictions Analyzed

Free

5 Requests/Minute Free Tier

$1/mo

Unlimited Use with API Key

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, Google Gemini, Cursor — 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

1
Copy the URL

Copy the MCP server endpoint URL from below

2
Paste in Your AI

Add it to Claude Desktop, ChatGPT, Google Gemini, or any MCP client

3
Ask Anything

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

MCP Server Endpoint

This is the only URL you need. Copy it and paste into your AI client.

https://mcp.vedastro.org/api/mcp

Quick Connect Guide

Select your AI client for step-by-step setup instructions

Claude Desktop
ChatGPT
Google Gemini
Cursor
Other / Custom
Claude Desktop Setup

Requires a Pro, Max, Team, or Enterprise plan.

  1. Open Claude Desktop and go to Settings > Connectors
  2. Scroll to the bottom and click "Add custom connector"
  3. Paste the MCP Server URL below and click Add
  4. In a new chat, click "+" (bottom-left) > Connectors and toggle VedAstro on
  5. Ask Claude: "Using my birth details (date, time, location), get my Vedic horoscope predictions"
Free Tier: 5 requests/minute (no API key needed)
Unlimited: $1/month - Get your API key from Account Page or API Builder Page
// Free Tier (5 requests/minute)
https://mcp.vedastro.org/api/mcp

// Unlimited Tier - Currently not supported by Claude Desktop UI
// Claude Desktop doesn't allow custom headers in the "Add custom connector" dialog
// For unlimited access, use Claude Code (CLI) or other MCP clients that support headers

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
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_astrology_raw_data
Available

Get raw Vedic astrology data for all 9 planets and 12 houses. Returns detailed planet data (sign placement, constellation, house occupied, houses owned, lord of sign/constellation, degrees, retrograde status) and house data (sign, constellation, planets in house, lord, aspecting planets). Use this for detailed chart analysis.

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

Get 24 general Vedic astrology properties for a birth chart including Ascendant/Lagna, Moon Sign, Moon Nakshatra, Sunrise/Sunset, Nithya Yoga, Karana, Tithi, Day/Night birth, Varna, Hora, Weekday & Lord, Kuja Dosa Score, Maraka Planets, Kartari Yoga data, Pancha Pakshi Birth Bird, and more.

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

Get Ashtakvarga charts including Sarvashtakavarga (combined planetary strength across 12 signs) and Bhinnashtakavarga (individual planet contributions). Each chart has rows per planet with 12 sign values and totals. Essential for transit analysis and planetary strength assessment.

latitude - Birth location latitude longitude - Birth location longitude birth_time - HH:MM format birth_date - DD/MM/YYYY format 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?

Using get_horoscope_predictions with latitude: 19.0760, longitude: 72.8777...

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
Get API Key - $1/month

Technical Specifications

Protocol

Model Context Protocol (MCP) via Streamable HTTP transport

Infrastructure

Azure Functions v4 (Node.js) with Streamable HTTP 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, no personal data stored, stateless calculations

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, Google Gemini, Cursor, and many more AI assistants and chat applications. The list is growing rapidly. Any application that supports the MCP protocol can connect to VedAstro's astrology server.

Yes, completely free with no sign-up required. The free tier allows 5 requests per minute, which is plenty for personal use. If you need more (e.g., for an app or heavy research), you can get an API key for just $1/month for unlimited requests.

VedAstro uses the Swiss Ephemeris — the same precision astronomical engine used by professional astrologers worldwide. Calculations use the Raman Ayanamsa system and analyze all 9 Vedic planets across 12 houses with hundreds of yoga combinations. The predictions are based on classical Vedic astrology texts and principles, the same used for thousands of years.

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.