Beta — launching with v1.0

Vedic astrology, inside your AI assistant

The DivyAstroAPI MCP server adds 42 Vedic astrology tools to Claude Desktop, Cursor, and any MCP-aware client. Ask the AI in plain language — it calls the right tool and returns accurate, ephemeris-backed results.

Runs on your laptop. No AI keys to buy on our side, no extra credit charge — every call is the same as a normal API call with your dv_live_… key.

Install in 2 minutes GitHub releases →

What it looks like

Once installed, your AI assistant just answers astrology questions naturally. No curl, no code, no API documentation to read.

You

Mera lagna kya hai? Birth: 15 Jan 1990, 10:30 AM, Mumbai.

Claude

[calls chart_ascendant]

Aapka lagna Capricorn (Makara) hai, 12°34′ par. Lagna lord Saturn 10th house mein sthit hai…

How it works

The MCP server is a small Go binary you install on your laptop. The AI client (Claude Desktop, Cursor, etc.) launches it as a subprocess, and it forwards tool calls to api.divyastroapi.com using your existing API key.

Step 1

Install the binary

Homebrew, GitHub Releases, or go install. Pure Go — no Node.js, no Python, no Docker required.

Step 2

Add your API key

Paste your dv_live_… key into your AI client's MCP config (one JSON file, 5 lines).

Step 3

Ask anything

The AI sees 12 new tools. Ask in English, Hindi, or any language — the AI picks the right tool from your question.

42 tools shipping in v0.2

Curated from our 245-endpoint catalog — the tools customers ask AI assistants for most often. Grouped by domain so you can spot-check coverage at a glance.

Panchang (6)

panchang_today/v1/panchang/summary

Daily Hindu panchang — tithi, vara, nakshatra, yoga, karana, sunrise/sunset, Rahu Kaal

panchang_tithi/v1/panchang/tithi

Lunar day (Krishna/Shukla paksha + tithi name + end timestamp)

panchang_choghadiya/v1/panchang/choghadiya

8 day + 8 night Choghadiya muhurta windows (Amrit / Shubh / Labh / Rog / Kaal / Udveg)

panchang_hora/v1/panchang/hora

Planetary hours (hora) schedule for the day

panchang_rahu_kaal/v1/panchang/rahu-kaal

Today's inauspicious Rahu Kaal window with start/end timestamps

panchang_brahma_muhurat/v1/panchang/brahma-muhurat

Pre-sunrise Brahma Muhurat window — most auspicious for sadhana

Birth Chart (10)

chart_ascendant/v1/chart/ascendant

Birth lagna (rising sign) with degree, nakshatra, pada

chart_planets/v1/chart/planets

All 9 grahas — sign, degree, house, nakshatra, retrograde flag

chart_houses/v1/chart/houses

12 house cusps with sign, lord, and degrees

chart_aspects/v1/chart/aspects

All Vedic graha drishti — full + special aspects

chart_dignity/v1/chart/dignity

Dignity status: exalted / debilitated / mool / own / friend / etc.

chart_navamsa/v1/chart/divisional/D9

D9 Navamsa — marriage / dharma divisional

chart_divisional/v1/chart/divisional/{varga}

Any of the 16 divisional charts (D1 to D60) by name or number

chart_nakshatra/v1/chart/nakshatra

Birth (Janma) nakshatra and pada with ruling planet

chart_avakhada/v1/chart/avakhada

Avakhada Chakra — varna, vashya, yoni, gana, nadi, paya, tatva

chart_shadbala/v1/chart/shadbala

Six-fold strength of all 9 planets (sthana / dig / kala / chesta / naisargika / drik bala)

chart_ashtakavarga/v1/chart/ashtakvarga

Sarvashtakavarga benefic-point grid for transit timing

Dasha (3)

dasha_current/v1/dasha/vimshottari/current

5-level Vimshottari dasha stack (MD/AD/PD/SD/Prana) at any moment

dasha_vimshottari_full/v1/dasha/vimshottari

Full 120-year Vimshottari Mahadasha sequence anchored at birth

dasha_yogini_current/v1/dasha/yogini/current

Currently-running Yogini Mahadasha (8-period secondary system)

Match Making & Compatibility (5)

match_making_score/v1/milan/ashtakoota/total

36-point Ashtakoota / Guna Milan total compatibility

ashtakoota_breakdown/v1/milan/ashtakoota

All 8 kootas individually with scores, max, reasoning, dosha flags

mangal_dosha/v1/milan/mangal-dosha

Manglik check — sub-rule, cancellation, severity, marriage implications

nadi_dosha/v1/milan/nadi-dosha

Nadi koota check + cancellation rules + remedy notes

vivah_phal/v1/milan/vivah-phal

Marriage outcome reading — longevity, bhakoot/gana balance, qualitative outlook

Muhurta (3)

muhurta_vivah/v1/muhurta/vivah

Wedding muhurta finder — ranks days by tithi/nakshatra/vara/Guru-Shukra strength

muhurta_naamkaran/v1/muhurta/naamkaran

Baby naming ceremony muhurta windows

muhurta_best_time/v1/muhurta/best-time

General-purpose best-time search across a date range

Annual / Numerology (2)

varshaphal_chart/v1/varshaphal/chart

Annual solar-return chart for a given year — Varsha Lagna + muntha + year ruler

numerology_full/v1/numerology/full

5-number Vedic numerology — Driver, Conductor, Soul, Personality, Destiny (master numbers preserved)

Transits (2)

transits_now/v1/transit/positions

Live planetary positions — sign, degree, nakshatra, retrograde

sade_sati/v1/transit/sade-sati

Saturn 7.5-year transit status + past / current / future windows

Sky Events (3)

eclipses_solar/v1/eclipses/solar

Solar eclipses in a date range — peak time, magnitude, type, visibility

eclipses_lunar/v1/eclipses/lunar

Lunar eclipses in a date range — peak time, magnitude, type, visibility

festivals_month/v1/festivals/month

Hindu festivals + observances in a given calendar month (region filter optional)

Planet Moments (2)

planet_retrograde_window/v1/planet-moments/retrograde-window

Planet retrograde windows — start station, end station, sign of each

planet_ingress/v1/planet-moments/ingress

Planet sign-change (sankranti) moments in a date range

Horary & Western (2)

prashna_answer/v1/prashna/answer

Cast a Prashna (horary) chart and compute the classical yes/no answer

western_natal_chart/v1/western/natal/chart

Tropical Western natal chart — planets, ascendant, MC, houses, aspect grid

Horoscope (3)

horoscope_daily/v1/horoscope/daily

Today's rashifal by Moon sign with daily lucky factors

horoscope_weekly/v1/horoscope/weekly

7-day rashifal outlook by Moon sign

horoscope_monthly/v1/horoscope/monthly

Full-month rashifal — sankranti shifts, weekly themes, monthly focus

Install in 2 minutes

Pick whichever fits your workflow. All four options install the same binary; choose by convenience.

macOS / Linux — Homebrew

Recommended for most users

brew tap divyguru/divyastroapi \
  https://github.com/divyguru/divyastroapi
brew install divyastro-mcp

Any platform — GitHub binary

macOS, Linux, Windows (amd64 / arm64)

Download from GitHub Releases, chmod +x, move to your PATH.

chmod +x divyastro-mcp-darwin-arm64
sudo mv divyastro-mcp-darwin-arm64 \
  /usr/local/bin/divyastro-mcp

Go developers

If you already have Go installed

go install github.com/divyguru/\
  divyastroapi/cmd/divyastro-mcp@latest

Build from source

For custom builds and audits

git clone https://github.com/divyguru/\
  divyastroapi.git
cd divyastroapi
make build-mcp

Configure your AI client

Paste this snippet into your AI client's MCP config file, replace the API key, and restart the app. The 12 tools appear in the tool list immediately.

Claude Desktop

macOS: ~/Library/Application Support/Claude/claude_desktop_config.jsonWindows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "divyastro": {
      "command": "/usr/local/bin/divyastro-mcp",
      "env": {
        "DIVYASTRO_API_KEY": "dv_live_..."
      }
    }
  }
}

Cursor

File: ~/.cursor/mcp.json

{
  "mcpServers": {
    "divyastro": {
      "command": "/usr/local/bin/divyastro-mcp",
      "env": {
        "DIVYASTRO_API_KEY": "dv_live_..."
      }
    }
  }
}

Continue.dev, Windsurf, and any other MCP-aware client use the same shape — just point their config at the binary and add your key. See the full MCP docs on GitHub for client-specific notes.

Common questions

Do I need an OpenAI / Anthropic API key?

No. The MCP server is a thin proxy from your AI client to our HTTP API — your AI client (Claude Desktop, Cursor, etc.) already handles the LLM side. We don't run any AI inference.

Does this cost extra credits?

No. Every tool call is one HTTPS request to api.divyastroapi.com using your existing dv_live_… key — same credit cost as a curl call. There is no MCP surcharge.

Where does it run?

On your laptop. The AI client launches the binary as a subprocess (stdio transport) and talks to it locally. The binary then makes outbound HTTPS calls to our API. We never see your laptop, your AI prompts, or anything but the standard API request.

Can I use my free-trial key?

Yes. The free plan's 1,000 calls / month + 100 calls / day apply across all sources — direct API, MCP, anything. Plenty to evaluate every tool.

What if my AI assistant calls the wrong tool?

The MCP SDK validates each call against the tool's input schema, so type mismatches fail before reaching our API. If the AI picks a tool whose data shape doesn't match the user's intent, it sees the upstream response and corrects on the next turn.

Is the source code open?

Yes. The MCP server lives at cmd/divyastro-mcp/ in our public repo. Apache-2.0 license. The 12 tool registrations are a single Go file you can audit before installing.

Get an API key first

Sign up free for 1,000 credits / month — plenty to try every MCP tool. Drop the key into your AI client config and you're done.

Start free trial See pricing →