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
| 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-Afteron 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.