Metadata-Version: 2.4
Name: widegita-mcp
Version: 0.1.1
Summary: MCP server for WideGita — Bhagavad Gita verses, commentaries, Upanishads, and Yoga Sutras from Claude, Cursor, and Windsurf
Project-URL: Homepage, https://widegita.com
Project-URL: Repository, https://github.com/wideholy/widegita-mcp
Author: WideHoly
License-Expression: MIT
License-File: LICENSE
Keywords: bhagavad-gita,claude,cursor,gita,hinduism,mcp,patanjali,sanskrit,upanishads,vedanta,yoga-sutras
Classifier: Development Status :: 4 - Beta
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Classifier: Topic :: Religion
Requires-Python: >=3.12
Requires-Dist: httpx>=0.27
Requires-Dist: mcp[cli]<2.0,>=1.0
Description-Content-Type: text/markdown

# widegita-mcp

[![PyPI version](https://img.shields.io/pypi/v/widegita-mcp)](https://pypi.org/project/widegita-mcp/)
[![Python](https://img.shields.io/pypi/pyversions/widegita-mcp)](https://pypi.org/project/widegita-mcp/)
[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)

MCP server for [WideGita](https://widegita.com) -- query Bhagavad Gita verses, commentaries, Upanishads, and Yoga Sutras directly from Claude, Cursor, and Windsurf. Ask your AI assistant about Krishna's teachings, Vedantic philosophy, Patanjali's Yoga Sutras, and classical Sanskrit commentaries.

> **Explore the scriptures at [widegita.com](https://widegita.com)** -- 18 chapters, 6,308 verses across 9 translations, 2,103 commentary entries, 10 Upanishads, and 196 Yoga Sutras.

## Table of Contents

- [Install](#install)
- [Configure](#configure)
  - [Claude Desktop](#claude-desktop)
  - [Cursor](#cursor)
  - [Windsurf](#windsurf)
- [Available Tools](#available-tools)
- [Example Conversations](#example-conversations)
- [What You Can Explore](#what-you-can-explore)
  - [Bhagavad Gita](#bhagavad-gita)
  - [Commentaries](#commentaries)
  - [Upanishads](#upanishads)
  - [Yoga Sutras](#yoga-sutras)
- [Environment Variables](#environment-variables)
- [Also Available](#also-available)
- [WideHoly Scripture Platform](#wideholy-scripture-platform)
- [License](#license)

## Install

```bash
pip install widegita-mcp
```

Or with `uvx` (no install needed):

```bash
uvx widegita-mcp
```

## Configure

### Claude Desktop

Edit `~/Library/Application Support/Claude/claude_desktop_config.json`:

```json
{
  "mcpServers": {
    "widegita": {
      "command": "uvx",
      "args": ["widegita-mcp"]
    }
  }
}
```

Or if installed with pip:

```json
{
  "mcpServers": {
    "widegita": {
      "command": "widegita-mcp"
    }
  }
}
```

### Cursor

Edit `~/.cursor/mcp.json`:

```json
{
  "mcpServers": {
    "widegita": {
      "command": "uvx",
      "args": ["widegita-mcp"]
    }
  }
}
```

### Windsurf

Edit `~/.codeium/windsurf/mcp_config.json`:

```json
{
  "mcpServers": {
    "widegita": {
      "command": "uvx",
      "args": ["widegita-mcp"]
    }
  }
}
```

## Available Tools

| Tool | Description |
|------|-------------|
| `get_verse` | Get a Gita verse by chapter and verse number, with translation selection |
| `search_gita` | Search across all Gita verse texts |
| `get_chapter` | Get chapter information -- name, Sanskrit title, verse count, summary |
| `get_commentary` | Get a classical commentary entry for a specific verse |
| `get_upanishad` | Get Upanishad details -- Veda, themes, verse count |
| `get_yoga_sutra` | Get a Yoga Sutra by pada-sutra slug (e.g. "1-2") |

## Example Conversations

Once configured, ask your AI assistant:

- *"What does Bhagavad Gita Chapter 2 Verse 47 say?"*
- *"Search the Gita for verses about dharma"*
- *"Tell me about Chapter 11 of the Bhagavad Gita"*
- *"What does Shankaracharya say about Gita 2.47?"*
- *"Show me the Isha Upanishad"*
- *"What is Yoga Sutra 1.2 -- the definition of yoga?"*
- *"Find Gita verses about karma yoga"*
- *"What is Ramanujacharya's commentary on Chapter 4, Verse 7?"*

The server will call the WideGita API and return Sanskrit text, transliterations, translations, commentaries, and scholarly context.

## What You Can Explore

### Bhagavad Gita

The Bhagavad Gita contains 18 chapters and 700 verses, a dialogue between Krishna and Arjuna on the battlefield of Kurukshetra. WideGita provides 6,308 verse records across 9 translations including Swami Sivananda, Swami Gambhirananda, Shri Purohit Swami, and more. Each verse includes the original Sanskrit, transliteration, and English translation.

### Commentaries

2,103 commentary entries from classical Vedantic scholars:

| Commentator | Tradition | Period |
|-------------|-----------|--------|
| Shankaracharya | Advaita Vedanta | 8th century |
| Ramanujacharya | Vishishtadvaita | 11th century |
| Madhvacharya | Dvaita Vedanta | 13th century |

### Upanishads

10 principal (Mukhya) Upanishads from the four Vedas -- the philosophical foundation of Vedanta. Each entry includes the source Veda, verse count, key themes, and description.

### Yoga Sutras

196 Yoga Sutras of Patanjali across 4 padas (chapters): Samadhi Pada (51 sutras), Sadhana Pada (55), Vibhuti Pada (56), and Kaivalya Pada (34). Each sutra includes Sanskrit text, transliteration, translation, and commentary.

## Environment Variables

| Variable | Default | Description |
|----------|---------|-------------|
| `WIDEGITA_BASE_URL` | `https://widegita.com/api/v1/gita` | Override API base URL |

## Also Available

| Platform | Install | Link |
|----------|---------|------|
| **PyPI** | `pip install widegita` | [PyPI](https://pypi.org/project/widegita/) |

## WideHoly Scripture Platform

| Site | Domain | Focus |
|------|--------|-------|
| WideBible | [widebible.com](https://widebible.com) | 31,102 Bible verses, 66 books, cross-references |
| **WideGita** | [widegita.com](https://widegita.com) | **18 chapters, 6,308 Gita verses, Upanishads, Yoga Sutras** |
| WideQuran | [widequran.com](https://widequran.com) | 6,236 Quran verses, 114 surahs, tafsir |
| WideTorah | [widetorah.com](https://widetorah.com) | Torah, Talmud, Mishnah, Jewish commentaries |
| WideSutra | [widesutra.com](https://widesutra.com) | Buddhist sutras, Pali Canon, Mahayana texts |
| WideHoly | [wideholy.com](https://wideholy.com) | Multi-religion scripture encyclopedia |

## Learn More About the Bhagavad Gita

- **Scripture**: [Chapters](https://widegita.com/chapters/) · [Translations](https://widegita.com/translations/)
- **Reference**: [Deities](https://widegita.com/deities/) · [Topics](https://widegita.com/topics/) · [Glossary](https://widegita.com/glossary/)
- **Study**: [Concepts](https://widegita.com/concepts/) · [Upanishads](https://widegita.com/upanishads/) · [Yoga Sutras](https://widegita.com/yoga-sutras/)
- **Tools**: [Search](https://widegita.com/) · [Developer Docs](https://widegita.com/developers/)
- **API**: [Developer Docs](https://widegita.com/developers/) · [OpenAPI Spec](https://widegita.com/api/schema/)

## License

MIT License -- see [LICENSE](LICENSE) for details.
