# bda-mcp [Health: Active]

**Category:** 🔬 Research  
**Repository:** https://github.com/BharatDharmaAcademy/bda-mcp  
**GitHub Stars:** 0  
**Views:** 0  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/bda-mcp

## Description
Jyotish, Panchang, Hindu festival and Sanatan Dharma knowledge tools with citations.

## Tools
Capabilities this server exposes over MCP:

- **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

## Claude Desktop Quick Installation
Remote MCP endpoint (confidence: high). Install path detected from listing signals. Add as a URL/SSE server in your client:

```json
"mcpServers": {
  "bda-mcp": {
    "url": "https://jyotish-api.bda.ai/mcp"
  }
}
```

## Documentation & 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).