Skip to content
MCP server

TathaAstu Panchang

Panchang, festival dates with their rules, and muhurat for any place via TathaAstuAPI

Runs locallyStatus and history
Pricing
Freemium
Platforms
API, CLI
Runs
Locally
Version
0.2.0
Listing updated
2 days ago

About TathaAstu Panchang

TathaAstu Panchang is a freemium MCP server for astrology. It runs locally on your machine and is started by your AI client.

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.

Install

Run in a terminal

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

Add to claude_desktop_config.json

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

Add to ~/.cursor/mcp.json

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

Add to .vscode/mcp.json

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

Add to ~/.codeium/windsurf/mcp_config.json

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

Add to your client's MCP settings (most use this shape)

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

Configuration

  • TATHAASTU_API_KEYYour TathaAstuAPI key (free plan available at https://tathaastuapi.com/dashboard.html)Required

What it does

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

Pricing

Freemium

Free plan with 500 requests a month; paid plans for higher quotas and more endpoints

Prices change. Check tathaastuapi.com before you buy.

TathaAstu Panchang 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 to TathaAstu Panchang

  1. Read-only MCP server for citing Quran, Hadith, Tafsir and dua sources in AI answers

    Runs locally
    • 7 tools
    • Freemium
    • Religion
  2. Natal Chart Lab

    MCP server

    Keyless MCP server for planet positions, retrogrades, Moon phases and birth placements

    Runs locally
    • 5 tools
    • Open source
    • Astrology
  3. SalahTable

    MCP server

    Prayer times for 407 cities with 15 methods, both Asr schools, Qibla and monthly tables

    • 6 tools
    • Remote
    • Free
    • Religion
  4. AstroLogics

    MCP server

    Vedic astrology calculations for AI assistants: birth chart, dasha, panchang, matching

    • 23 tools
    • Remote
    • Freemium
    • Astrology