The io.github.BharatDharmaAcademy/bda-mcp MCP server provides knowledge tools centered on Jyotish, Panchang, Hindu festival, and Sanatan Dharma, with citations for referenced information. It is intended to surface structured religious and calendrical knowledge via MCP tooling.

🛠️ Key Features

Jyotish knowledge tools
Panchang knowledge tools
Hindu festival knowledge tools
Sanatan Dharma knowledge tools
Responses include citations

🚀 Use Cases

Retrieve Jyotish-related information with cited sources
Look up Panchang details and related festival context
Support study or reference for Sanatan Dharma topics

⚡ Developer Benefits

Citation-backed outputs for easier verification
Focused tool domain: Jyotish, Panchang, Hindu festivals, Sanatan Dharma

⚠️ Limitations

Available metadata does not specify tool count or exact tool capabilities beyond the listed domains and citation support.

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:

json

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

Claude Code:

bash

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

Raw JSON-RPC:

bash

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

Tools

Tool	What it returns
`get_today_panchang`	Daily Panchang (tithi, nakshatra, yoga, karana, sunrise/sunset) for a city/date
`get_panchang_by_date_city`	Panchang JSON for any date + location
`get_festival_calendar`	Hindu festival feed / calendar export
`get_udaya_lagna`	Ascendant-sign windows from local sunrise
`get_tithi_info`	Tithi context via public Panchang evidence endpoints
`get_tithi_calendar`	Annual start/end spans for one tithi in a location
`get_nakshatra_info`	Nakshatra context by date/location
`get_kundali_explanation`	Public Jyotish concept explanations
`search_sanatan_encyclopedia`	Canonical public Sanatan Encyclopedia pages
`get_mantra_meaning`	Reviewed-source discovery guidance for mantra meanings
`get_jyotish_glossary_term`	Jyotish glossary / concept metadata
`get_public_bda_feature_summary`	BDA service and API discovery metadata
`list_public_sitemap_urls`	Paged public URL catalog from BDA sitemaps
`get_public_page_metadata`	Safe metadata for a single allowlisted public URL
`list_public_api_endpoints`	Public evaluation endpoints from the filtered OpenAPI contract

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

Discovery & documentation

MCP documentation page: https://jyotish-api.bda.ai/docs/mcp
Full public REST API docs (OpenAPI): https://jyotish-api.bda.ai/api-docs
A2A agent card: https://jyotish-api.bda.ai/.well-known/agent-card.json
llms.txt: https://jyotish-api.bda.ai/llms.txt

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.

io.github.BharatDharmaAcademy/bda-mcp