English Français العربية

io.github.BharatDharmaAcademy/bda-mcp

Official registry Other

Jyotish, Panchang, Hindu festival and Sanatan Dharma knowledge tools with citations.

Source code Website Documentation

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

Remote (streamable-http)
Claude Code 
claude mcp add --transport http bda-mcp 'https://jyotish-api.bda.ai/mcp'
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "bda-mcp": {
            "type": "http",
            "url": "https://jyotish-api.bda.ai/mcp"
        }
    }
}

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. BDA MCP — Jyotish, Panchang & Sanatan Dharma tools for AI agents
  2. Quick start
  3. Tools
  4. Discovery & documentation
  5. Notes
  6. License

BDA MCP — Jyotish, Panchang & Sanatan Dharma tools for AI agents

Remote Model Context Protocol server by Bharat Dharma Academy, an Australian registered charity preserving Sanatan Dharma knowledge (ABN 54 683 667 656).

Endpoint: https://jyotish-api.bda.ai/mcp (JSON-RPC 2.0 over HTTPS — no install, no API key for the evaluation tier)

The server exposes 15 public, read-only tools backed by the same deterministic engines that power bda.ai: Swiss-Ephemeris Panchang computation, festival calendars, muhurat windows, Jyotish concept explanations, and a source-grounded Sanatan knowledge corpus with citations and provenance metadata.

Quick start

Any MCP client that supports remote HTTP servers:

{
  "mcpServers": {
    "bda-jyotish": {
      "type": "http",
      "url": "https://jyotish-api.bda.ai/mcp"
    }
  }
}

Claude Code:

claude mcp add --transport http bda-jyotish https://jyotish-api.bda.ai/mcp

Raw JSON-RPC:

curl -X POST https://jyotish-api.bda.ai/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

Tools

ToolWhat it returns
get_today_panchangDaily Panchang (tithi, nakshatra, yoga, karana, sunrise/sunset) for a city/date
get_panchang_by_date_cityPanchang JSON for any date + location
get_festival_calendarHindu festival feed / calendar export
get_udaya_lagnaAscendant-sign windows from local sunrise
get_tithi_infoTithi context via public Panchang evidence endpoints
get_tithi_calendarAnnual start/end spans for one tithi in a location
get_nakshatra_infoNakshatra context by date/location
get_kundali_explanationPublic Jyotish concept explanations
search_sanatan_encyclopediaCanonical public Sanatan Encyclopedia pages
get_mantra_meaningReviewed-source discovery guidance for mantra meanings
get_jyotish_glossary_termJyotish glossary / concept metadata
get_public_bda_feature_summaryBDA service and API discovery metadata
list_public_sitemap_urlsPaged public URL catalog from BDA sitemaps
get_public_page_metadataSafe metadata for a single allowlisted public URL
list_public_api_endpointsPublic evaluation endpoints from the filtered OpenAPI contract

Live machine-readable catalog: /mcp/tools.json

Discovery & documentation

Notes

  • Read-only and public. Authenticated user tools (personal Kundali, dashboards, saved reports) are intentionally not exposed here.
  • Free evaluation tier with fair-use rate limits (Retry-After on 429). Commercial access: info@bda.ai.
  • Responses carry citations, provenance and trust-tier metadata — keep them intact and visible to downstream users.
  • Jyotish content is spiritual/cultural guidance, not medical, legal or financial advice.

License

The documentation in this repository is MIT-licensed. The hosted API itself is governed by the usage terms at jyotish-api.bda.ai/api-docs.

Frequently asked questions

What is io.github.BharatDharmaAcademy/bda-mcp?

Jyotish, Panchang, Hindu festival and Sanatan Dharma knowledge tools with citations.

How do I install io.github.BharatDharmaAcademy/bda-mcp?

It runs as a remote server. In Claude Code: claude mcp add --transport http bda-mcp 'https://jyotish-api.bda.ai/mcp'. For other clients, paste the JSON configuration from this page into their MCP settings.

Does io.github.BharatDharmaAcademy/bda-mcp need an API key?

Its registry entry lists no required key or secret. Some features may still need an account with the service it connects to.

Is io.github.BharatDharmaAcademy/bda-mcp open source?

Yes. Its code is on GitHub under the MIT license.

Who maintains io.github.BharatDharmaAcademy/bda-mcp?

It is published by BharatDharmaAcademy. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.