bda-mcp

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-After on 429). Commercial access: [email protected].
• 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.