MCP server

Birthstar Vedic Astrology MCP

io.github.amarpathak/birthstar

Checked 26 Oct 2026, 08:29 UTC · Connected to it and listed its tools

30 Vedic Jyotish tools: natal charts, dashas, yogas, nakshatras. Swiss Ephemeris.

At a glance

Type

MCP server

Publisher

Not verified

Status

Working at last check

Tools

30

Token cost

About 8,091 tokens per request

Sets up in

Claude Code, Claude Desktop, Codex, Gemini CLI, Cursor, VS Code, Antigravity, ChatGPT, OpenAI API, Grok

Last checked

26 Oct 2026, 08:29 UTC

Connect it to your agent

Add to CursorAdd to VS CodeVS Code Insiders

Opens the app, which shows the server and asks you to confirm. For other apps, copy the setup below.

Claude Code

claude mcp add --transport http birthstar https://mcp.birthstar.ai/mcp

Claude Desktop

Settings → Connectors → Add custom connector, and paste the URL.

Codex (config.toml)

[mcp_servers.birthstar]
url = "https://mcp.birthstar.ai/mcp"

Gemini CLI

{"mcpServers":{"birthstar":{"httpUrl":"https://mcp.birthstar.ai/mcp"}}}

Cursor

{"mcpServers":{"birthstar":{"url":"https://mcp.birthstar.ai/mcp"}}}

VS Code

{"servers":{"birthstar":{"type":"http","url":"https://mcp.birthstar.ai/mcp"}}}

Antigravity

agy mcp add birthstar https://mcp.birthstar.ai/mcp

ChatGPT

Settings → Apps & Connectors → Advanced settings: turn on Developer mode, then Create a connector and paste the URL. Which plans can do this varies.

OpenAI API (Responses tools)

{"type":"mcp","server_label":"birthstar","server_url":"https://mcp.birthstar.ai/mcp","require_approval":"always"}

Grok (xAI API tools)

{"type":"mcp","server_label":"birthstar","server_url":"https://mcp.birthstar.ai/mcp"}

Tools

• calculate_birth_star ~364 tokens
  Compute just a person's Vedic birth star (nakshatra) and core anchors. A one-shot shortcut: use this when the birth star is the whole question. If you expect follow-up questions about the same person's chart, prefer create_chart, which caches the full chart behind a reusable handle.
• create_chart ~624 tokens
  Compute a full Vedic natal chart and cache it, returning a short handle. Call this FIRST. It returns a `chart_id` plus a small summary. Pass that chart_id to the other tools (get_grahas, get_houses, get_current_dasha, get_panchanga, get_yogas) to read specific parts of the chart without
• describe_chart ~144 tokens
  Get metadata and an inventory of what a cached chart contains. Useful for orienting before drilling in: returns the birth data and config it was computed with, the top-level sections available in the document, and how many fields the engine honestly marked as deferred or uncomputable.
• get_account_status ~234 tokens
  Check the calling account's plan, remaining chart credits, and what is gated. Call this BEFORE attempting a tool that might be refused, not after. It is to subscription limits what describe_chart is to chart sections: the index you consult to find out what is reachable, so a paywall is
• get_ashtakavarga ~276 tokens
  Get Ashtakavarga bindus — the point-score each sign carries, used for transit strength. Call this for "is this a good sign for Saturn to transit" or "which signs are strongest overall". Sarvashtakavarga (SAV) sums the seven planetary charts; the classical pre-reduction total is always 3
• get_aspects ~263 tokens
  Get planetary and sign aspects — who is looking at which house. Graha drishti is the Parasari planetary aspect (everything aspects the 7th; Mars, Jupiter, Saturn and the nodes have special aspects). Rasi drishti is the Jaimini sign aspect, a different system — do not merge the two.
• get_avasthas ~220 tokens
  Get planetary avasthas — the maturity, alertness and mood states of each graha. Baladi is the age state (infant..dead) and scales a planet's ability to deliver. Jagradadi is awake/dreaming/sleeping. Deeptadi is the mood from exaltation down to combustion. Two further ladders, lajji
• get_compatibility ~164 tokens
  Calculate 36-point Ashta-Kuta Guna Milan compatibility between two charts. Evaluates all 8 classical Parashari Kutas (Varna, Vashya, Tara, Yoni animal intimacy, Graha Maitri, Gana, Bhakoot, and Nadi) plus a Kuja Dosha (Manglik) mutual cross-audit between Person 1 and Person 2.
• get_current_dasha ~177 tokens
  Get the currently-running dasha periods for a cached chart. Returns the active lord at every nested level (Maha -> Antar -> Pratyantar -> Sukshma -> Prana) for each dasha system the engine computed, with the ISO start/end dates of each period. NOTE: "current" is evaluated against t
• get_dasha_periods ~368 tokens
  Walk the dasha tree — list periods at any level, past or future. Use this for "when does my next antardasha start", "what runs after this mahadasha", "when was I in Jupiter". get_current_dasha only tells you what is running now; this gives you the whole sequence. Args: char
• get_day_periods ~176 tokens
  Get sunrise/sunset and the auspicious/inauspicious windows of the BIRTH day. Rahu kala, Yamaganda, Gulika kala, Abhijit and Brahma muhurta, plus true sunrise/sunset, day length and whether the birth was by day. IMPORTANT: these are the windows for the DATE OF BIRTH, not for today. This
• get_doshas ~130 tokens
  Audit classical Vedic doshas: Kuja Dosha (Manglik), Kaal Sarp, Gandanta, Pitre. Evaluates Mars placements from Lagna, Moon, and Venus with 8 classical cancellation exceptions, 12 Kaal Sarp variants, Gandanta junctions, and Pitre dosha indicators.
• get_fixed_stars ~146 tokens
  Get conjunctions between the grahas and named prominent fixed stars. Returns only real conjunctions within the configured orb, plus what was scanned. An empty `conjunctions` list is a provable negative, not a skipped check — `planets_scanned` and `stars_scanned` show the search that ran
• get_grahas ~312 tokens
  Get planetary positions for a cached chart. Args: chart_id: Handle returned by create_chart. planets: Optional list of names to fetch (e.g. ["Moon", "Saturn"]). Defaults to the 9 classical grahas. Also accepts the outer bodies Uranus, Neptune, Pluto, Cere
• get_houses ~251 tokens
  Get the 12 houses (bhavas) for a cached chart. Args: chart_id: Handle returned by create_chart. method: "whole_sign" (default) — sign, lord, lord placement, karaka, occupants. "bhava_chalit" — Sripati/Porphyry cusps with degree spans, which can place a pl
• get_karakas ~174 tokens
  Get the Chara (Jaimini) karakas plus Karakamsa and Swamsa. The Atmakaraka — the planet at the highest degree in its sign — is the single most-used significator in Jaimini analysis. Returns the whole ladder in descending degree order, plus the natural (naisargika) karakas. Note Rahu
• get_lagna_points ~169 tokens
  Get the chart angles, special lagnas, Arudha padas and Bhrigu Bindu. Beyond the ascendant: MC/IC/Descendant/Vertex, the time-based special lagnas (Bhava/Hora/Ghati/Sree/Indu), the Jaimini Arudha padas (AL, A2-A12, Upapada) and Bhrigu Bindu. Special lagnas whose rate is school-diver
• get_longevity ~180 tokens
  Get Ayurdaya (longevity) estimates — EXPERIMENTAL, not for predictive use. The engine computes Pindayu and Nisargayu, but flags the whole section experimental: the classical methods are textually divergent and the reduction rules are only partially applied. The disclaimer is returned wi
• get_numerology ~138 tokens
  Calculate Chaldean Name Numerology and Vedic Date of Birth numbers. Calculates Name Number (compound + root), Birth Number (Mulank), Destiny Number (Bhagyank), ruling planetary archetypes (Swami Grahas), and harmonic resonance.
• get_panchanga ~118 tokens
  Get the birth panchanga (the five limbs of the Vedic calendar). Returns tithi (lunar day + paksha), vara (weekday), nakshatra, yoga, and karana at the moment of birth, plus the lunar month and season.
• get_prompt_library ~401 tokens
  Fetch curated high-value prompt templates and multi-tool question workflows. Call this tool whenever you want to suggest high-value questions to the user, or when the user asks "what can you do?", "what should I ask?", or wants guided astrology workflows (e.g. Sade Sati analysis, timeli
• get_strengths ~444 tokens
  Get Shadbala, Bhava Bala and Ishta/Kashta phala — how strong each planet and house is. Call this for "which planet is strongest", "is Saturn strong enough", or "which houses are weak". Shadbala is the six-fold Parasari strength; a planet meets expectation when `ratio` >= 1. Read `r
• get_timeline ~733 tokens
  Get the turning points between two dates — dasha changes and slow-planet ingresses. This is the two-clocks view: the dasha sequence counted from birth (which theme is switched on) against gochara, the real sky on that date (the trigger). Use it for "what happens in the next five years",
• get_transits ~204 tokens
  Get gochara — where the planets are now relative to the natal chart. Answers "is Sade Sati running", "is Jupiter transiting well", "is today favourable". Houses are counted from BOTH the natal Moon (the classical reference for gochara) and the natal Lagna. IMPORTANT: transits are c
• get_varga ~242 tokens
  Get one divisional chart (varga) from a cached chart. Args: chart_id: Handle returned by create_chart. varga: Which divisional chart, e.g. "D9" (navamsa), "D10" (dashamsa), "D11", "D60". See describe_chart -> varga_coverage for the full list of what this
• get_vimsopaka ~185 tokens
  Get Vimsopaka bala — each planet's dignity-weighted strength across the 16 vargas. Use this to answer "which planets are strong across the divisional charts?" A planet in its own or exalted sign in all sixteen scores the full 20. Returns the score, the ceiling actually applicable, and
• get_yogas ~142 tokens
  Get the yogas (classical planetary combinations) present in a chart. Only yogas whose rule actually tested true are listed, each with the rule that matched. An empty list is a real result — it means none of the implemented yogas are present in this chart, not that the check was skipped.
• health_check ~179 tokens
  Check whether this server is correctly configured and computing accurately. Reports the ephemeris mode actually in use, engine versions, and cache state. Call this when chart positions look wrong or disagree with another source: the usual cause is a missing ephemeris directory, which de
• rectify_birth_time ~794 tokens
  Test how much a recorded birth time can actually be narrowed, and against what. Two modes: * **No events** — scans the uncertainty window and reports how many genuinely distinct charts it contains, what differs between them, and what does not. Use this FIRST to find out whether
• server_stats ~139 tokens
  Get usage metrics for this server session: calls, latency, errors, payload size. Per tool: call count, p50/p95/max latency, average and peak response size, and how many responses exceeded the payload budget. Plus cache hit rate and a breakdown of errors by type. Counters are per-pr

Browse

• GitHub tools
• Website monitoring
• Calendars
• GitHub and code hosting

Related MCP servers

• Jagannatha Hora — Vedic Astrology (Jyotish, Kundli, Horoscope, Panchang)
  Vedic astrology (Jyotish): birth charts, divisional charts, dashas, yogas, transits, panchang
• Jyotish — Vedic astrology for AI agents
  Vedic astrology for AI agents: chart facts, panchang windows, and Guna Milan compatibility.
• AstralRead
  Natal charts, transits, the sky of a day, Vedic chart and dasha. Read-only, no account.
• AstroTune — Vedic astrology (Jyotish)
  Jyotish charts, vargas, dashas, panchang, transits, matching. Place by name, no API key.
• ERUX Astrology & Ephemeris Engine
  Ephemeris natal & mundane charts, Vimshottari Dasha, transit horoscopes, Horas, and Vedic yogas.
• Astro Agents - deterministic Western + Vedic astrology
  Natal charts, transits, kundli, dashas, panchang, Gun Milan. JPL DE440, no LLM, hashed.
• Trikaal Vaani Jyotish
  Vedic astrology (Jyotish): kundali, dasha, yog, dosha, muhurat, milan — Swiss Ephemeris + BPHS
• Sahadeva
  Vedic astrology MCP: panchanga, kundli matching, muhurta, dashas.

Badge for your README

[![AptLynx](https://aptlynx.net/badge/io.github.amarpathak/birthstar.svg)](https://aptlynx.net/servers/io.github.amarpathak/birthstar)

Listing text is written by the maker; AptLynx lists tools and does not vouch for them. Find another tool · Browse by topic · For agents