Model Context Protocol

MCP Server for AI Agents

A first-party MCP server for astrology. 48 semantic tools covering Vedic, Western, and KP systems plus Vastu, Tarot, Chinese (BaZi), Numerology & more. Give your AI agents autonomous access to 1,128 endpoints, computed by the open-source XALEN Ephemeris.

Answers are built from computed chart data. AI chat in 30 languages, 15 of them Indic.

Get Startedsetup steps View on npm@vedika-io/mcp-server 
npx @vedika-io/mcp-server

48 Tools

48Semantic Tools
1,128Endpoints
12Systems & Domains
30Response Languages

Why MCP for Astrology?

Model Context Protocol lets AI agents call APIs autonomously

Autonomous

Autonomous AI Agents

Your AI agents compute birth charts, check doshas, run compatibility, and generate predictions autonomously. No manual API calls needed.

Grounded

Grounded in Computed Data

AI answers are built from chart data computed by the open-source XALEN Ephemeris, and the chart used comes back in the response.

Coverage

12 Systems & Domains

Vedic, Western and KP, plus Vastu, Tarot, BaZi, Numerology and 20 more.

Setup

Step 1 Get your API key

Sign up at vedika.io/pricing. Your key will look like vk_live_abc123...

Step 2 Add to your AI tool

Add the following server configuration to your MCP desktop client's config file (typically a JSON file in the app's config directory):

{
  "mcpServers": {
    "vedika": {
      "command": "npx",
      "args": ["-y", "@vedika-io/mcp-server"],
      "env": {
        "VEDIKA_API_KEY": "vk_live_your_key_here"
      }
    }
  }
}
Step 3 Start asking

Restart your AI tool. Now you can ask natural language questions and the agent will autonomously call the right Vedika tools:

"Generate a Vedic birth chart for someone born June 15, 1990 at 2:30 PM in Delhi"
"Check Mangal Dosha and Kaal Sarp Dosha for this person"
"Run synastry analysis between these two people using Western tropical astrology"
"What does today's panchang look like for Mumbai?"

48 Semantic Tools

Each tool groups related endpoints by domain. The tables describe the most used tools; every tool the server lists follows them.

Core AI (2 tools)

Tool What It Does
vedika_ai_chat Natural language astrology question + birth details. AI-interpreted analysis across Vedic/Western/KP, built from computed chart data. Multi-turn conversations. 30 languages, 15 of them Indic.
vedika_conversation List, retrieve, delete, or extend TTL of multi-turn conversation history.

Vedic Computation (9 tools)

Tool What It Does
vedika_birth_chart Kundli, planetary positions, house cusps, ascendant. 8 ayanamsa systems. Computed by the open-source XALEN Ephemeris.
vedika_dasha Vimshottari, Yogini, Mahadasha, Antardasha, Pratyantardasha. Full planetary period timeline.
vedika_doshas Mangal Dosha, Kaal Sarp, Pitru, Nadi, Sade Sati (basic + advanced with remedies).
vedika_compatibility 36-point Guna Milan, Kundali matching, Nakshatra Porutham, Thirumana Porutham.
vedika_panchang Daily Hindu calendar: tithi, nakshatra, yoga, karana. Location-aware (defaults to Delhi).
vedika_muhurta 10 muhurta types: Choghadiya, Hora, Rahu Kaal, Gulika Kaal, Abhijit, Brahma, and more.
vedika_divisional_charts 60 divisional charts: D1-D60 including Navamsa (D9), Dasamsa (D10), Hora (D2), and more.
vedika_predictions Daily, weekly, monthly, quarterly, yearly predictions by rashi or from birth details.
vedika_ashtakavarga Individual planet Ashtakavarga and Sarvashtakavarga composite strength scores.

Western Astrology (4 tools)

Tool What It Does
vedika_western_transits Tropical transit chart, positions, and aspects. Current planetary transits against natal chart.
vedika_western_progressions Secondary progressions: progressed chart, positions, and aspects.
vedika_western_solar_return Solar return chart for any year. Birthday chart showing themes for the year ahead.
vedika_western_relationship Synastry aspects and composite chart. Relationship compatibility analysis.

Cross-System & Supplementary (6 tools)

Tool What It Does
vedika_horoscope Daily, weekly, monthly horoscopes. Vedic and Western systems. Advanced tropical positions.
vedika_numerology Life path, destiny, personality, soul urge, personal year, compatibility. Pythagorean and Chaldean.
vedika_varshaphal Vedic annual horoscope (solar return). Year-ahead analysis based on Sun's return.
vedika_strength Shadbala (6-fold strength), Chandra Bala, Tara Bala, Upagraha positions, planet relationships.
vedika_calendar 11 Vedic calendar calculations: Ritu, solstice, Anandadi Yoga, auspicious/inauspicious periods, Gowri Nalla Neram, Disha Shool, Chandrashtama.
vedika_usage Check wallet balance, usage history, cost summary, and model usage stats.

All 48 tools

The names the server returns from tools/list. The connectors guide shows how to list them yourself.

  • vedika_ai_chat
  • vedika_conversation
  • vedika_birth_chart
  • vedika_dasha
  • vedika_doshas
  • vedika_compatibility
  • vedika_panchang
  • vedika_muhurta
  • vedika_divisional_charts
  • vedika_predictions
  • vedika_ashtakavarga
  • vedika_western_transits
  • vedika_western_progressions
  • vedika_western_solar_return
  • vedika_western_relationship
  • vedika_horoscope
  • vedika_numerology
  • vedika_varshaphal
  • vedika_strength
  • vedika_calendar
  • vedika_usage
  • vastu_reference
  • vastu_audit_floor_plan
  • vastu_room_placement
  • vastu_mandala_project
  • vastu_generate_plan
  • vastu_declination
  • vastu_operation
  • vastu_job_submit
  • vastu_job_status
  • vastu_job_results
  • vastu_job_cancel
  • vastu_job_artifact
  • vedika_tarot_draw
  • vedika_tarot_daily
  • vedika_iching_cast
  • vedika_chinese_zodiac
  • vedika_chinese_bazi
  • vedika_human_design_chart
  • vedika_crystals_recommend
  • vedika_matrimony_match
  • vedika_dasha_ashtottari
  • vedika_lalkitab_remedies
  • vedika_spiritual_mantra
  • vedika_spiritual_deity
  • vedika_health_ayurvedic
  • vedika_daily_bundle
  • vedika_numerology_complete

Use Cases

What developers are building with Vedika MCP

Apps

Astrology Apps

Build AI-powered astrology chatbots, horoscope apps, and kundali generators. Your agent calls vedika_ai_chat for natural language and computation tools for structured data.

Matchmaking

Matchmaking Platforms

Automate compatibility scoring with vedika_compatibility (36-point Guna Milan) and vedika_western_relationship (synastry + composite).

Events

Event Planning

Find auspicious times with vedika_muhurta and vedika_panchang. Check Rahu Kaal, Choghadiya, and auspicious yogas automatically.

Content

Content Generation

Generate daily/weekly/monthly horoscope content with vedika_predictions and vedika_horoscope. All 12 signs, Vedic and Western.

Research

Research & Analytics

Compute Shadbala scores, Ashtakavarga strengths, and divisional chart positions programmatically for astrology research.

Numerology

Numerology Platforms

Calculate life path, destiny numbers, and compatibility with vedika_numerology. Pythagorean and Chaldean systems.

How It Works

When you ask your AI tool a question, it autonomously selects and calls the right Vedika tools:

You "What career opportunities are ahead for someone born June 15, 1990 at 2:30 PM in Delhi? Check both Vedic dasha and Western transits."

The agent automatically calls:

  1. vedika_birth_chart - gets planetary positions + houses
  2. vedika_dasha - checks current Vimshottari dasha period
  3. vedika_western_transits - analyzes current transits in tropical zodiac
  4. Synthesizes both Vedic and Western perspectives into a unified career analysis

Vedika MCP at a Glance

Feature Vedika MCP
MCP Tools 48 semantic tools
Astrology Systems 12 (Vedic, Western, KP, Vastu, Tarot & more)
AI Chatbot Answers built from computed chart data
Endpoints Covered 1,128
Languages (AI chat) 30 languages, 15 of them Indic
Calculation Engine XALEN Ephemeris (open source)

Give Your AI Agent Astrology Superpowers

48 tools. 1,128 endpoints. 12 systems.

Get API Keysee pricing Read Full DocsAPI reference
GitHub npm SDKs Blog Post