Docs · MCP

MCP tool catalog.

Vedākṣha exposes a Model Context Protocol surface of 12 tools — natal charts, dashas, vargas, transits, muhurta, ashtakavarga, gochara, graph emit. The catalog below is fetched live from the introspection mirror at vedaksha.net/api/mcp, which mirrors the canonical schema snapshot in the source repository (drift-tested in CI). To run these tools, self-host the library or build from source.

12 tools · live from vedaksha.net/api/mcp · canonical snapshot tools/mcp-tools.json

Discover

One curl, every tool.

The introspection mirror is no-auth. List every tool, its parameters, and its description with one request.

curl -sS -X POST https://vedaksha.net/api/mcp \
  -H 'content-type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}' | jq

tools/call

Calls run where you host the library.

Vedākṣha is a BSL-1.1 library. The introspection mirror documents the surface; to actually call these tools, self-host the library or build from source. Four install paths, one Rust codebase.

cargo install vedaksha-mcp — Rust binary, native MCP server, all 12 tools.

pip install vedaksha — Python bindings via PyO3, identical surface.

npm i vedaksha-wasm — WASM build for browser and edge, 972 KB, no data files.

ghcr.io/arthiqlabs/vedaksha-mcp — pre-built Docker image of the MCP server.

Build from source · BSL 1.1 commercial-use terms · KundaliMCP — fully-packaged production-ready MCP (full Vedic suite, narrative generation, multi-school, multilingual). Built on Vedākṣha core by the same team at ArthIQ Labs.

Technology showcase

Quick hosted demo at mcp.vedaksha.net.

For a fast no-install evaluation, we run a small technology showcase at mcp.vedaksha.net/mcp. Anonymous, no signup, IP-rate-limited at 60 req/hour and 500 req/day. Connect any MCP client and run real chart computation without setup.

What it is — and is not

Is: a packaged demo with 4 agent-friendly wrapper tools (compute_chart_basic, vimshottari_dasha, panchanga, ephemeris_positions), built on top of the vedaksha library. Free tier, anonymous, IP-rate-limited.

Is not: the canonical vedaksha library catalog. The 4 showcase tools are agent-friendly wrappers, not the full 12-tool BSL surface documented above. For the full library, use self-host or build from source.

Catalog

12 tools.

Each tool is a JSON-RPC method. Click a tool to expand its parameter list. Required parameters are unmarked; optional parameters have a trailing ?.

compute_natal_chart

Compute a natal astrological chart for a given time and location. Returns a ChartGraph in JSON format containing planetary positions, house cusps, aspects, nakshatras, and dignities.

5 parameters ▾

ayanamsha?stringAyanamsha system for sidereal: Lahiri, FaganBradley, Tropical, etc.

house_system?stringHouse system: Placidus, Koch, Equal, WholeSign, etc.

julian_daynumberJulian Day number (TDB)

latitudenumberGeographic latitude in degrees [-90, +90]

longitudenumberGeographic longitude in degrees [-180, +180], east positive

compute_dasha

Compute Vedic dasha (planetary period) sequences. Supports five classical systems: Vimshottari, Ashtottari, Yogini (Moon-longitude based, require `moon_longitude`); Chara, Narayana (Lagna-sign based, require `lagna_sign`). Returns a JSON dasha tree with start/end Julian Days.

5 parameters ▾

birth_jdnumberBirth Julian Day (TDB) used as the dasha epoch

lagna_sign?integerLagna (ascendant) sign 1–12 (1 = Aries). Required for Chara, Narayana.

levels?integerNumber of nested dasha levels (1–5). Ignored by Chara and Narayana.

moon_longitude?numberNatal Moon sidereal longitude in degrees [0, 360). Required for Vimshottari, Ashtottari, Yogini.

system?stringDasha system selector

compute_karakas

Compute Jaimini Chara Karaka assignments from sidereal planet longitudes. Ranks planets by degrees within their current sign: highest = Atmakaraka (soul significator), lowest = Darakaraka (spouse significator). Supports 7-karaka (Sun–Saturn) and 8-karaka (adds Rahu) schemes.

9 parameters ▾

jupiternumberSidereal longitude of Jupiter [0, 360)

marsnumberSidereal longitude of Mars [0, 360)

mercurynumberSidereal longitude of Mercury [0, 360)

moonnumberSidereal longitude of Moon [0, 360)

rahu?numberSidereal longitude of Rahu [0, 360). Required for scheme '8'.

saturnnumberSidereal longitude of Saturn [0, 360)

scheme?stringKaraka scheme: '7' (default, Sun–Saturn) or '8' (adds Rahu + Pitrikaraka)

sunnumberSidereal longitude of Sun [0, 360)

venusnumberSidereal longitude of Venus [0, 360)

compute_combustion

Compute combustion state for each planet relative to the Sun per BPHS Ch.7 vv.28-29. Returns Combust, DeeplyCombust, or None for Moon, Mars, Mercury, Jupiter, Venus, Saturn with degrees of separation.

12 parameters ▾

jupiternumberSidereal longitude of Jupiter [0, 360)

jupiter_retrograde?boolean

marsnumberSidereal longitude of Mars [0, 360)

mars_retrograde?boolean

mercurynumberSidereal longitude of Mercury [0, 360)

mercury_retrograde?boolean

moonnumberSidereal longitude of Moon [0, 360)

saturnnumberSidereal longitude of Saturn [0, 360)

saturn_retrograde?boolean

sunnumberSidereal longitude of Sun [0, 360)

venusnumberSidereal longitude of Venus [0, 360)

venus_retrograde?boolean

compute_shadbala

Compute full six-fold Shadbala (Sthana, Dig, Kala, Cheshta, Naisargika, Drik Bala) for each planet, plus uccha_bala, ishta_phala, and kashta_phala per BPHS Ch.27-28.

3 parameters ▾

is_daytime?boolean

moon_phase_waxing?boolean

planetsarrayArray of planet data objects.

compute_vargas

Compute Vedic divisional charts (vargas) for a given time and location. Supply a list of division codes (e.g. D1, D9, D10) and receive a ChartGraph JSON for each, including planetary positions and dignities within each varga.

6 parameters ▾

ayanamsha?stringAyanamsha system for sidereal: Lahiri, FaganBradley, Tropical, etc.

divisionsarrayVarga division codes to compute, e.g. ["D1", "D9", "D10"]

julian_daynumberJulian Day number (TDB)

latitudenumberGeographic latitude in degrees [-90, +90]

longitudenumberGeographic longitude in degrees [-180, +180], east positive

planet_longitude?numberSidereal longitude of the planet in degrees [0, 360) for direct varga computation

emit_graph

Convert a ChartGraph JSON (as produced by compute_natal_chart or compute_vargas) into a target output format for downstream storage or retrieval. Supports Neo4j Cypher, SurrealDB SurrealQL, JSON-LD, plain JSON, and RAG embedding text.

3 parameters ▾

chart_jsonobjectChartGraph JSON as returned by compute_natal_chart or compute_vargas

classification?stringOptional label or session ID attached to emitted nodes

formatstringTarget output format

compute_transit

Compute transiting planet positions relative to a natal chart at a specific moment. Returns planet longitudes for the transit time alongside natal positions, enabling aspect calculation between transit and natal placements.

4 parameters ▾

natal_jdnumberJulian Day of the natal chart (TDB)

natal_latnumberNatal geographic latitude in degrees [-90, +90]

natal_lonnumberNatal geographic longitude in degrees [-180, +180], east positive

transit_jdnumberJulian Day of the transit moment to compute (TDB)

search_transits

Search for transiting planet–natal planet aspects within a time window. Supply natal positions and a Julian Day range; receive a list of exact transit moments with aspect type, orb, and applying/separating status.

6 parameters ▾

aspects?arrayAspect types to filter (e.g. conjunction, opposition, trine). Defaults to major aspects.

bodies?arrayTransiting bodies to include. Defaults to all planets.

end_jdnumberEnd of the search window as a Julian Day (TDB)

max_orb?numberMaximum orb in degrees (default 1.0)

natal_positionsarrayArray of natal planet positions to check transits against

start_jdnumberStart of the search window as a Julian Day (TDB)

search_muhurta

Search for auspicious time windows (muhurta) within a given period for a geographic location. Returns ranked muhurta candidates with quality scores based on tithi, nakshatra, yoga, karana, and planetary positions.

5 parameters ▾

end_jdnumberEnd of the search window as a Julian Day (TDB)

latitudenumberGeographic latitude in degrees [-90, +90]

longitudenumberGeographic longitude in degrees [-180, +180], east positive

min_quality?numberMinimum quality score [0.0, 1.0] for muhurta inclusion (default 0.5)

start_jdnumberStart of the search window as a Julian Day (TDB)

compute_ashtakavarga

Compute Bhinna Ashtakavarga (raw bindu tables) and Sarvashtakavarga for all 7 planets from sign positions. Source: BPHS Ch.66 vv.13-68. Trikona/Ekadhipatya Shodhana and Pinda Sadhana are not included.

8 parameters ▾

jupiterinteger

lagnaintegerSign index of Lagna (Ascendant)

marsinteger

mercuryinteger

mooninteger

saturninteger

sunintegerSign index of Sun (0=Aries…11=Pisces)

venusinteger

compute_gochara

Compute Gochara (transit interpretation) for the seven grahas against a natal reference sign per BPHS Ch.29. Returns favourable/unfavourable verdict, house from natal, and raw vedha (obstruction) candidates per planet. The natal reference sign is the caller's choice — typically the natal Moon's sign (Chandra Gochara) or the natal Lagna's sign. Rahu and Ketu are not included.

10 parameters ▾

jupiterintegerTransit sign index of Jupiter

marsintegerTransit sign index of Mars

mercuryintegerTransit sign index of Mercury

moonintegerTransit sign index of Moon

natal_reference_signintegerSign index of the natal reference point — natal Moon for Chandra Gochara, natal Lagna for Lagna-based Gochara

saturnintegerTransit sign index of Saturn

school?stringExemption profile applied to the raw vedha candidate list

sunintegerTransit sign index of Sun (0=Aries … 11=Pisces)

vedha_table?stringVedha pair table source

venusintegerTransit sign index of Venus

Where to go from here.

← All docs Ontology →Playground →