# vedaksha [Health: Active]

**Category:** 🔮 Spirituality & Esoterica  
**Repository:** https://github.com/arthiqlabs/vedaksha  
**GitHub Stars:** 4  
**Views:** 1  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/vedaksha

## Description
Vedic astrology and astronomical ephemeris: kundali, panchanga, dashas, vargas, transits

## Claude Desktop Quick Installation
Install path detected from listing signals. Uses `uvx` (confidence: high):

```json
"mcpServers": {
  "vedaksha": {
    "command": "uvx",
    "args": ["vedaksha"],
    "env": {
      "VEDAKSHA_MCP_TOKEN": ""
    }
  }
}
```

**Requires environment variables:** `VEDAKSHA_MCP_TOKEN` — the values above are empty placeholders; fill in real credentials before running (see the repository for what each one is for).

## Documentation

## What vedaksha MCP server does

The vedaksha MCP server gives MCP-compatible agents access to astronomical ephemeris and Jyotish calculations. Its supported calculations include janam kundali natal charts, panchanga, dashas, nakshatras, vargas, shadbala, ashtakavarga, muhurta, and gochara transits. The underlying engine also includes Western chart concepts such as houses, aspects, and dignities.

Results can be represented as computed charts and exposed through a property-graph model. The project documents output paths including Cypher, SurrealQL, JSON-LD, and retrieval-augmented-generation text, alongside Rust, Python, and WebAssembly libraries.

## How it works

The vedaksha MCP server uses a Rust engine with analytical VSOP87A and ELP/MPP02 models, plus JPL DE440s/DE441 kernel support. The ephemeris pipeline accounts for precession, nutation, light-time, and delta-T. Analytical coefficients are compiled into the package, while the JPL SPK kernel is used for higher-fidelity state-vector work where available.

Public interfaces expect Julian Days in UT1. The engine converts UT1 to TT for dynamical calculations and uses UT1 for Earth rotation, which affects the ascendant, midheaven, and house cusps. The raw SPK state-vector query is the exception: it indexes the kernel directly and expects TDB.

## Setup and configuration

Install the MCP executable with Cargo:

```bash
cargo install vedaksha-mcp
vedaksha-mcp
```

The executable supports stdio and HTTP transport. Docker is also documented:

```bash
docker run -e VEDAKSHA_MCP_TOKEN=... -p 3100:3100 ghcr.io/arthiqlabs/vedaksha-mcp
```

HTTP access uses bearer authentication. The repository also provides Rust, Python, and WebAssembly packages, but those are library installation paths rather than MCP client setup. Python requires version 3.9 or newer and uses WebAssembly without requiring a Rust toolchain.

## Tools and capabilities

The vedaksha MCP server exposes 17 tools covering the documented chart and ephemeris functions. Supported capability areas include:

- Natal chart and kundali computation
- Panchanga and muhurta calculations
- Dashas, nakshatras, vargas, shadbala, and ashtakavarga
- Planetary transits and gochara
- Ephemeris and raw SPK state-vector queries
- Chart-oriented property-graph and structured-output formats

## Limitations and notes

The published 0.103-arcsecond figure measures mean apparent geocentric ecliptic-longitude residuals for the SPK pipeline during 1900–2025; it is not a general accuracy guarantee. The wider 1900–2100 comparison is affected by predicted delta-T divergence, particularly for the Moon. The analytical provider has a reported 0.239-arcsecond mean over 1900–2025, with larger residuals for outer planets; the documentation recommends the SPK path when sub-0.1-arcsecond outer-planet results are required.

House cusps have not been validated against an external reference, and the documented ayanamsha implementations have not been validated against another implementation. The license is BUSL-1.1, with a stated future transition to Apache 2.0.

_Full upstream README: https://allmcps.com/mcp/vedaksha/readme_

