# Vedaksha Vedic Astrology

> Vedaksha Vedic Astrology is a freemium MCP server for astrology. Rust ephemeris and Vedic astrology engine with 17 MCP tools for charts and panchanga. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Platforms:** CLI, API, self-hosted, Web
- **Website:** https://vedaksha.net
- **Repository:** https://github.com/arthiqlabs/vedaksha
- **MCP Registry name:** io.github.arthiqlabs/vedaksha-vedic-astrology
- **Categories:** astrology
- **Listing updated:** 2026-11-14

## About

Vedaksha computes natal charts (kundali), panchanga, dashas, nakshatras, vargas, shadbala, ashtakavarga, muhurta and transits from a Rust ephemeris. Accuracy is stated against JPL Horizons over 1900-2025: 0.096 arcseconds mean longitude residual with a DE440s/DE441 kernel, or 0.160 arcseconds mean with a built-in analytical series that needs no data file. The README calls the implementation clean-room, with each algorithm traced to a primary source.

The same engine ships as a Rust crate, a Python package (via WebAssembly), a browser WebAssembly bundle and the MCP server. The README says the server offers 17 tools over stdio and HTTP with bearer auth, and the registry entry points to a multi-arch Docker image. Charts can also be output as a property graph (Cypher, SurrealQL, JSON-LD) or RAG text.

Licensing matters here. The code is source-available under BUSL-1.1 rather than open source: non-commercial use is free, commercial use costs $500 once per organization, and each release converts to Apache 2.0 four years after its release date. The site names kundalimcp.com and kundali.live as applications built on it.

## Features

- **Vedic chart computation:** Produces natal charts, dashas, vargas, shadbala and ashtakavarga.
- **Panchanga and muhurta:** Calculates panchanga elements and searches for muhurta times and transits.
- **Measured accuracy:** Reports longitude residuals against JPL Horizons with reproducible commands.
- **No-data-file mode:** Runs from compiled analytical series without an ephemeris kernel.
- **Multiple bindings:** Offers Rust, Python and WebAssembly alongside the MCP server.
- **Graph and RAG output:** Exports charts as a property graph or text for retrieval.

## Good for

- Build a kundli app or panchang calendar
- Give an astrology agent exact planetary positions
- Search for auspicious dates by muhurta rules
- Compute transits across a range of dates

## Install

### Claude Code (Terminal)

```sh
claude mcp add vedaksha-vedic-astrology -- docker run -i --rm ghcr.io/arthiqlabs/vedaksha-mcp:v10.2.0
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "vedaksha-vedic-astrology": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/arthiqlabs/vedaksha-mcp:v10.2.0"
      ]
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "vedaksha-vedic-astrology": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/arthiqlabs/vedaksha-mcp:v10.2.0"
      ]
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "vedaksha-vedic-astrology": {
      "type": "stdio",
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/arthiqlabs/vedaksha-mcp:v10.2.0"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "vedaksha-vedic-astrology": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/arthiqlabs/vedaksha-mcp:v10.2.0"
      ]
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "vedaksha-vedic-astrology": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/arthiqlabs/vedaksha-mcp:v10.2.0"
      ]
    }
  }
}
```

## FAQ

### Is it open source?

It is source-available under BUSL-1.1, with no AGPL code; each release becomes Apache 2.0 four years after it ships.

### What does commercial use cost?

$500 one time per organization, covering that version and every later one.

### Is non-commercial use free?

Yes, with no registration or key, if you are not earning revenue from external customers.

### How accurate is it?

The site reports 0.096 arcseconds mean longitude residual against JPL Horizons with the SPK kernel and 0.160 with the analytical series.

### How do I run the MCP server?

Install with cargo install vedaksha-mcp or run the Docker image; it supports stdio and HTTP with bearer auth.

### Is Vedaksha Vedic Astrology free?

Vedaksha Vedic Astrology has a free plan, with paid plans for more usage or features.

### How do I add Vedaksha Vedic Astrology to Claude Code?

Run this command in your terminal: claude mcp add vedaksha-vedic-astrology -- docker run -i --rm ghcr.io/arthiqlabs/vedaksha-mcp:v10.2.0

### What are the best alternatives to Vedaksha Vedic Astrology?

The closest alternatives to Vedaksha Vedic Astrology are Natal Chart Lab, VedicDost: Vedic Astrology, Kundli & AI Astrologer, AstroLogics, GenesisCore Astrology (Western + Vedic) and Céu Natal.

## Alternatives

- [Natal Chart Lab](https://ai-powered.com/mcp/natal-chart-lab): Natal Chart Lab is an open-source MCP server for astrology.
- [VedicDost: Vedic Astrology, Kundli & AI Astrologer](https://ai-powered.com/mcp/vedicdost-vedic-astrology-kundli-and-ai-astrologer): VedicDost: Vedic Astrology, Kundli & AI Astrologer is a free MCP server for astrology.
- [AstroLogics](https://ai-powered.com/mcp/astrologics): AstroLogics is a freemium MCP server for astrology.
- [GenesisCore Astrology (Western + Vedic)](https://ai-powered.com/mcp/genesiscore-astrology-western-vedic): GenesisCore Astrology (Western + Vedic) is a free MCP server for astrology.
- [Céu Natal](https://ai-powered.com/mcp/ceu-natal): Céu Natal is an open-source MCP server for astrology.
- [OIYO Korea Calculators](https://ai-powered.com/mcp/oiyo-korea-calculators): OIYO Korea Calculators is a free MCP server for finance and payments.
- [Moon Phase Software](https://ai-powered.com/mcp/moon-phase-software): Moon Phase Software is a free MCP server for astrology.
- [Zodiac Compatibility](https://ai-powered.com/mcp/zodiac-compatibility): Zodiac Compatibility is a free MCP server for astrology.

---
Source: https://ai-powered.com/mcp/vedaksha-vedic-astrology
