io.github.BharatDharmaAcademy/bda-mcp
Jyotish, Panchang, Hindu festival and Sanatan Dharma knowledge tools with citations.
Open source Repository Open in the app JSON README (API)
About
Jyotish, Panchang, Hindu festival and Sanatan Dharma knowledge tools with citations.
Details
- Kind
- MCP servers
- Topic
- No topic detected
- Publisher
- bharatdharmaacademy
- Origin
- official
- Category
- ferramentas
- Transport
- http
- Version
- 1.0.0
- Last push
- 2026-08-03T15:23:18Z
- Repository state
- ativo
- License
- MIT
- Added
- 2026-08-29 03:01:42
- Updated
- 2026-08-29 03:01:42
- Origin id
io.github.BharatDharmaAcademy/bda-mcp
README
# BDA MCP — Jyotish, Panchang & Sanatan Dharma tools for AI agents
Remote [Model Context Protocol](https://modelcontextprotocol.io) server by [Bharat Dharma Academy](https://www.bda.ai), 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](https://www.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`](https://jyotish-api.bda.ai/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](mailto: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](https://jyotish-api.bda.ai/api-docs#usage-rules).