# TathaAstu Panchang

> TathaAstu Panchang is a freemium MCP server for astrology. Panchang, festival dates with their rules, and muhurat for any place via TathaAstuAPI. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Platforms:** API, CLI
- **Website:** https://tathaastuapi.com/developers/
- **MCP Registry name:** com.tathaastuapi/mcp
- **Categories:** astrology, religion
- **Listing updated:** 2026-11-15

## About

Hindu festival dates can differ by place and tradition, so this server returns the reasoning along with the date. It is the stdio MCP client for TathaAstuAPI, a REST service for panchang, festivals and muhurat, and it needs a TATHAASTU_API_KEY from the service's dashboard.

The API accepts a location from latitude and longitude alone and applies daylight saving automatically. An explain endpoint shows the derivation behind a festival date, and an observatory mode exposes the raw astronomical facts. The site says festival derivation is fully verified for New Delhi, with other places computed on thinner cached data, and that only the North Indian rule pack is populated today.

The developer page describes the MCP package as six tools over stdio but does not name them. The same API also has Python and TypeScript SDKs, a CLI and a VS Code extension.

## Features

- **Daily panchang:** Returns panchang data for a date and a location.
- **Festival explanations:** An explain endpoint shows the rule behind any festival date.
- **Observatory mode:** Adds the raw astronomical facts behind a festival decision.
- **Coordinates-only locations:** Latitude and longitude are enough, with time zone and daylight saving handled.
- **Muhurat and compatibility:** Higher plans add muhurat, kundli and compatibility endpoints scored against Muhurta Chintamani.
- **Plan-based limits:** Exceeding a limit returns 429 rather than a degraded answer.

## Good for

- Ask an assistant when a festival falls in a given city and why
- Look up Rahukaal and other daily timings for a location
- Add Hindu calendar data to a planning or reminder app
- Check marriage compatibility scores with source status per koota

## Install

### Claude Code (Terminal)

```sh
claude mcp add mcp --env TATHAASTU_API_KEY='<TATHAASTU_API_KEY>' -- npx -y @tathaastu/mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@tathaastu/mcp"
      ],
      "env": {
        "TATHAASTU_API_KEY": "<TATHAASTU_API_KEY>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@tathaastu/mcp"
      ],
      "env": {
        "TATHAASTU_API_KEY": "<TATHAASTU_API_KEY>"
      }
    }
  }
}
```

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

```json
{
  "servers": {
    "mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@tathaastu/mcp"
      ],
      "env": {
        "TATHAASTU_API_KEY": "<TATHAASTU_API_KEY>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@tathaastu/mcp"
      ],
      "env": {
        "TATHAASTU_API_KEY": "<TATHAASTU_API_KEY>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@tathaastu/mcp"
      ],
      "env": {
        "TATHAASTU_API_KEY": "<TATHAASTU_API_KEY>"
      }
    }
  }
}
```

## FAQ

### Do I need an API key?

Yes. TATHAASTU_API_KEY is required, and a Free plan with no card is available.

### What does the Free plan include?

500 requests a month, 10 a minute and 100 a day, covering panchang and festivals only.

### Which locations are fully verified?

Festival derivation is verified for New Delhi; other locations use the same engine with thinner cached data.

### What happens past my quota?

The API returns 429 instead of silently degrading or billing overage.

### Is TathaAstu Panchang free?

TathaAstu Panchang has a free plan, with paid plans for more usage or features.

### How do I add TathaAstu Panchang to Claude Code?

Run this command in your terminal: claude mcp add mcp --env TATHAASTU_API_KEY='<TATHAASTU_API_KEY>' -- npx -y @tathaastu/mcp

### What are the best alternatives to TathaAstu Panchang?

The closest alternatives to TathaAstu Panchang are Madeenan Quran and Hadith Sources, Natal Chart Lab, SalahTable, VedicDost: Vedic Astrology, Kundli & AI Astrologer and AstroLogics.

## Alternatives

- [Madeenan Quran and Hadith Sources](https://ai-powered.com/mcp/madeenan-quran-and-hadith-sources): Madeenan Quran and Hadith Sources is a freemium MCP server for religion.
- [Natal Chart Lab](https://ai-powered.com/mcp/natal-chart-lab): Natal Chart Lab is an open-source MCP server for astrology.
- [SalahTable](https://ai-powered.com/mcp/salahtable): SalahTable is a free MCP server for religion.
- [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.

---
Source: https://ai-powered.com/mcp/tathaastu-panchang
