streamable-httpMITupdated 1mo ago
Remote Model Context Protocol server by Bharat Dharma Academy, an Australian registered charity preserving Sanatan Dharma knowledge (ABN 54 683 667 656).
What can you do with 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-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.
Install
Add bda mcp to your client. Pick the one you use.
claude mcp add --transport http bda-mcp https://jyotish-api.bda.ai/mcpcodex mcp add bda-mcp --url https://jyotish-api.bda.ai/mcp{
"mcpServers": {
"bda-mcp": {
"url": "https://jyotish-api.bda.ai/mcp"
}
}
}Add to `~/.cursor/mcp.json`, or `.cursor/mcp.json` for a single project.
{
"servers": {
"bda-mcp": {
"type": "http",
"url": "https://jyotish-api.bda.ai/mcp"
}
}
}Add to `.vscode/mcp.json` in your workspace.
{
"mcpServers": {
"bda-mcp": {
"url": "https://jyotish-api.bda.ai/mcp"
}
}
}Add to `claude_desktop_config.json`, then restart Claude Desktop.
{
"mcpServers": {
"bda-mcp": {
"serverUrl": "https://jyotish-api.bda.ai/mcp"
}
}
}Add to `~/.codeium/windsurf/mcp_config.json`.
15 tools
bda mcp exposes 15 tools to a connected agent.
- 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
Score
74 / 100
Good
- Documentation22/25
- Maintenance19/25
- Trust13/20
- Capability8/15
- Install experience12/15
- Documents what it does and how to connect
- Has a resolvable package or endpoint
- Exposes at least one tool, prompt or resource
- README has substantive content
- Includes a code example
- Documents its configuration
- Mentions credentials or security posture
- Last commit 28 days ago
- Has a release history
- Repository is not archived
- Licensed MIT
- Namespace verified in the official MCP registry
- Claimed by its owner
- Published under an organisation
- 15 tool(s) documented
- Provides prompt templates
- Provides resources
- 6 documented install method(s)
- Published to a package registry
- Offers a hosted endpoint — no local install
Version history
| Versions | Published |
|---|---|
| 1.0.0Latest | Aug 3, 2026 |