MCP server for WideSutra — query Buddhist scriptures, collections, figures, and concepts from Claude, Cursor, and Windsurf
Project description
widesutra-mcp
MCP server for WideSutra -- query Buddhist scriptures directly from Claude, Cursor, and Windsurf. Ask your AI assistant about Pali Canon passages, Mahayana sutras, Buddhist figures, and core concepts backed by 5 collections, 5,326 texts, Pali + English translations, 10 figures, and 15 concepts.
Explore Buddhist scriptures at widesutra.com -- Collections | Figures | Concepts | Glossary
Table of Contents
- Install
- Configure
- Available Tools
- Example Conversations
- Buddhist Scripture Collections
- Environment Variables
- Also Available
- WideHoly Scripture Platform
- License
Install
pip install widesutra-mcp
Or with uvx (no install needed):
uvx widesutra-mcp
Configure
Claude Desktop
Edit ~/Library/Application Support/Claude/claude_desktop_config.json:
{
"mcpServers": {
"widesutra": {
"command": "uvx",
"args": ["widesutra-mcp"]
}
}
}
Cursor
In .cursor/mcp.json:
{
"mcpServers": {
"widesutra": {
"command": "uvx",
"args": ["widesutra-mcp"]
}
}
}
Windsurf
In ~/.windsurf/mcp.json:
{
"mcpServers": {
"widesutra": {
"command": "uvx",
"args": ["widesutra-mcp"]
}
}
}
Available Tools
| Tool | Description | Example Args |
|---|---|---|
get_text |
Get a specific Buddhist scripture passage by book, chapter, and verse | book="dhammapada", chapter=1, verse=1 |
search_sutra |
Search across 5,326 Buddhist texts by keyword | query="four noble truths", limit=10 |
get_collection |
Get scripture collection details (Tipitaka, Mahayana Sutras, etc.) | slug="tipitaka" |
get_figure |
Get Buddhist figure info (Buddhas, bodhisattvas, arahants) | slug="siddhartha-gautama" |
get_concept |
Get Buddhist concept details (Four Noble Truths, Nirvana, etc.) | slug="four-noble-truths" |
Example Conversations
Reading scripture passages:
"Show me the first verse of the Dhammapada"
"What does the Heart Sutra say about emptiness?"
"Find passages about compassion in the Pali Canon"
Exploring Buddhist teachings:
"Explain the Four Noble Truths with the original Pali terms"
"What is the Noble Eightfold Path?"
"Tell me about dependent origination"
Learning about Buddhist figures:
"Who was Nagarjuna and what did he teach?"
"Tell me about Avalokiteshvara in Mahayana Buddhism"
"What collections are in the Tipitaka?"
Buddhist Scripture Collections
WideSutra covers 5 major collections of Buddhist scriptures spanning Theravada and Mahayana traditions:
| Collection | Tradition | Description |
|---|---|---|
| Tipitaka (Pali Canon) | Theravada | Three baskets: Vinaya, Sutta, and Abhidhamma Pitaka |
| Mahayana Sutras | Mahayana | Heart Sutra, Lotus Sutra, Diamond Sutra, and more |
| Chinese Agamas | East Asian | Chinese translations of early Buddhist discourses |
| Tibetan Kangyur | Tibetan | Translated words of the Buddha in the Tibetan canon |
| Gandharan Manuscripts | Early Buddhist | Ancient Gandhara region texts in Kharosthi script |
Translations include Bhikkhu Sujato (English), Bhikkhu Bodhi (English), and the original Pali texts. The API returns both translated text and original Pali where available.
Environment Variables
| Variable | Default | Description |
|---|---|---|
WIDESUTRA_BASE_URL |
https://widesutra.com/api/v1/sutra |
API base URL |
Also Available
| Platform | Package | Install |
|---|---|---|
| PyPI | widesutra | pip install widesutra |
| npm | widesutra | npm install widesutra |
| Go | widesutra-go | go get github.com/dobestan/widesutra-go |
| Rust | widesutra | cargo add widesutra |
| Ruby | widesutra | gem install widesutra |
WideHoly Scripture Platform
Part of the WideHoly multi-religion scripture platform.
| Site | Domain | Focus |
|---|---|---|
| WideBible | widebible.com | 66 books, 4 translations (KJV, ASV, BBE, YLT), 3,000+ people, 942 places |
| WideQuran | widequran.com | 114 surahs, hadith collections, tafsir commentary |
| WideTorah | widetorah.com | Tanakh, 54 parashot, Talmud tractates, Rashi commentary |
| WideGita | widegita.com | 18 Gita chapters, Upanishads, Yoga Sutras, Hindu deities |
| WideSutra | widesutra.com | 5 collections, 5,326 texts, Pali + English, 10 figures, 15 concepts |
| WideHoly | wideholy.com | Cross-religion search, verse comparison, religious calendar |
Learn More About Buddhist Scriptures
- Scripture: Collections · Translations
- Reference: Figures · Topics · Glossary
- Study: Concepts · Pali Canon
- Tools: Search · Developer Docs
- API: Developer Docs · OpenAPI Spec
License
MIT
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file widesutra_mcp-0.1.1.tar.gz.
File metadata
- Download URL: widesutra_mcp-0.1.1.tar.gz
- Upload date:
- Size: 6.6 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: uv/0.10.11 {"installer":{"name":"uv","version":"0.10.11","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
b5b2bc0b3f7e54c4f0e392fa46192f018dd7c429f93daab8519233371a5cf7aa
|
|
| MD5 |
4082afbe1378a449ffc73d28aabfbfda
|
|
| BLAKE2b-256 |
36a629ae4733e692b05f13f3744753ed4553949f2932d422f8624fba8e2ec207
|
File details
Details for the file widesutra_mcp-0.1.1-py3-none-any.whl.
File metadata
- Download URL: widesutra_mcp-0.1.1-py3-none-any.whl
- Upload date:
- Size: 8.0 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: uv/0.10.11 {"installer":{"name":"uv","version":"0.10.11","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
df84ff9ce8b255431a82597857447af6f0d92347dd77a133309df247fe25c1db
|
|
| MD5 |
8cbbaf31abb1b5b2d6cc773c13fa5409
|
|
| BLAKE2b-256 |
12f04be381dba32285209d23287517488febec0ae519eefe41a80f0fdbc62606
|