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:

config.json

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

Claude Code:

Terminal

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

Raw JSON-RPC:

Terminal

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.