Power your agent
The publisher's own URL. Not a PlugMCP endpoint.
Host a copy with our keys and logs.
https://mcp.tripitaka-mcp.com/mcpThe Claude button above opens Claude with the name and URL filled in. You still confirm it there.
claude mcp add --transport http dhamma-seeker-tripitaka-mcp https://mcp.tripitaka-mcp.com/mcpRun in a terminal.
{ "mcpServers": { "dhamma-seeker-tripitaka-mcp": { "command": "npx", "args": [ "-y", "mcp-remote", "https://mcp.tripitaka-mcp.com/mcp" ] } }}claude_desktop_config.json
Remote URL or a command on your machine? How the two installs differ
Run on PlugMCP
A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.
LaunchFrom the publisher
An MCP server for searching and citing content from the Pāli Tipiṭaka. It lets AI clients such as Claude or Cursor look up suttas, quote the teachings, and compare translations across languages.
🙏 This project is offered as Dhamma Dāna: 100% free, non-commercial only. License details: LICENSE (code) and NOTICE.md (data)
bilara-data's translators (Bhikkhu Sujato for DN/MN/SN/AN and most of the Khuddaka Nikāya, with John Kelly, Bhikkhu Kovilo and others for a few KN books). Vinaya carries Pāli plus Bhikkhu Brahmali's English. Abhidhamma is Pāli only, because upstream bilara-data has no English for any Abhidhamma book. list_structure reports live counts.mn1, pli-tv-bu-vb-pj1, patthana1.1) and generate a properly formatted academic citation.bhikkhūnaṁ → bhikkhu).bilara-data verbatim, so it is the authoritative text, and AI clients surface the link so users can verify the source in one click./sse) and canonical Streamable HTTP (/mcp, MCP spec 2025-03-26).tripitaka://structure, tripitaka://sutta/{id}, tripitaka://word/{w}, for clients that pin context as resources./topics/*: six markdown pages covering canon structure, getting started and tool selection, places (Mahājanapada, holy sites, cosmology), 10 foundational themes with locus classicus, about 30 major figures, and a phase-based timeline of the Buddha's 45-year mission. Sutta IDs are verified against live data, and an AI client can fetch one page instead of running 30+ tool calls.skills/tipitaka-research.md is a ready-to-install workflow file that turns on a multi-step research pattern (clarify → verify coverage → search → drill in → cite) on Claude Desktop and Claude Code.The maintainers run a free public instance at tripitaka-mcp.com.
Connecting Claude Desktop takes three steps. Nothing to install but Node.js, and no Docker or GPU.
1. Find your absolute npx path. Claude Desktop doesn't read your shell profile, so a bare npx won't resolve. Open a terminal:
which npx
# example: /Users/you/.nvm/versions/node/v22.14.0/bin/npx
2. Open claude_desktop_config.json (~/Library/Application Support/Claude/ on macOS, %APPDATA%\Claude\ on Windows) and add the entry below. Substitute YOUR_NPX_PATH with the output from step 1, and YOUR_NODE_BIN_DIR with that path's parent directory:
{
"mcpServers": {
"tripitaka": {
"command": "YOUR_NPX_PATH",
"args": ["-y", "mcp-remote", "https://mcp.tripitaka-mcp.com/mcp"],
"env": { "PATH": "YOUR_NODE_BIN_DIR:/usr/local/bin:/usr/bin:/bin" }
}
}
}
3. Quit Claude Desktop completely (⌘Q on macOS, tray → Quit on Windows) and reopen. The 🔌 indicator in the bottom-left should show tripitaka with 14 tools available.
The first connection takes 5 to 10 seconds while
npxdownloadsmcp-remoteon demand. Give Claude Desktop a moment after the restart before deciding it failed.
Once connected, try asking Claude things like:
Claude will pick the right tool, fetch the canonical Pāli, and surface a clickable link to the project's bilingual reader for verification.
The hosted server is a small free service offered for personal study, research, and dhamma practice. Keep your request rate reasonable; bursts may be throttled at the edge. Read NOTICE.md before redistributing it or using it commercially.
pipx, local SQLite, no server)If you would rather keep everything on your own machine, with no network calls to the hosted server, install the local edition. It carries the whole Pāli canon as a single SQLite file (~120 MB) and runs as a local stdio MCP server.
pipx install tripitaka-mcp # needs Python 3.10+
tripitaka-mcp init # one-time: downloads the SQLite database
tripitaka-mcp serve # runs the MCP server over stdio
If the install fails like this:
Because the current Python version (3.9.6) does not satisfy Python>=3.10
pipx is using a different interpreter than you think. It builds its own isolated environment on purpose and ignores whatever venv you have active, so an old system Python gets picked even when the shell you typed in has 3.12. Tell it which to use:
pipx install --python python3.12 tripitaka-mcp
(Any 3.10 or newer works; pipx environment shows what it defaults to.)
Then point Claude Desktop or Cursor at the local command, with no npx bridge and no internet:
{
"mcpServers": {
"tripitaka": {
"command": "tripitaka-mcp",
"args": ["serve"]
}
}
}
(If tripitaka-mcp isn't on the client's PATH, use the absolute path from which tripitaka-mcp.)
Need a URL instead of stdio? Scripts, notebooks, and anything that shares one server across several clients want an HTTP endpoint rather than a subprocess:
tripitaka-mcp serve --http # http://127.0.0.1:8765/mcp
tripitaka-mcp serve --http --port 9000 # or MCP_HOST / MCP_PORT
It binds 127.0.0.1 unless you say otherwise; the canon is read-only, but
nothing here asks who is calling, so think before binding a public interface.
Hosted vs local
Both serve the same ~444K-segment canon. The differences:
search_semantic, search_hybrid, and the trigram keyword index need PostgreSQL, pgvector, and a ~1 GB embedding model, which is more than a lightweight local install should carry, so they stay hosted-only. In local mode those two tools are never registered: a connected client sees only the 11 it can actually call.
Because the local server is a standard stdio MCP server, it also gives you a fully offline AI stack. Pair it with a local model such as Ollama and any MCP-capable chat UI, and nothing leaves your machine.
git clone https://github.com/dhamma-seeker/tripitaka-mcp.git
cd tripitaka-mcp
./scripts/install.sh
The installer downloads a prepared database dump from Hugging Face (dhamma-seeker/tripitaka-mcp-dump) and restores it for you, which brings setup down from two to four hours (loading the data, then generating embeddings) to about five minutes. (If a dump file is already on disk, the installer uses that copy instead.)
The installer will:
docker, compose, openssl, and curl are installed.env with random passwords (for both the admin and the readonly user)Options:
./scripts/install.sh --dump PATH # use an existing dump file
./scripts/install.sh --dump-url URL # override the dump source
./scripts/install.sh --no-dump # skip restore (load data yourself later)
git clone https://github.com/dhamma-seeker/tripitaka-mcp.git
cd tripitaka-mcp
cp .env.example .env
# Set POSTGRES_PASSWORD in .env to a random password
docker compose up db -d
python -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt
# 1. Seed metadata (pitaka, nikāya)
python scripts/seed_metadata.py
# 2. Download & load Sutta Piṭaka data from SuttaCentral
python scripts/data_loader.py
# 3. Load Thai CC0 translations (Dhīranando & Jayasāro)
python scripts/load_thai_cc0.py
# 4. Load dictionaries (DPD, PTS, DPPN, and the Payutto dictionary)
python scripts/load_dictionary.py
# 5. Generate embeddings for semantic / hybrid search
python scripts/generate_embeddings.py
python main.py
You can drive the tools from Postman in SSE mode:
MCP_TRANSPORT=sse python main.pyFor production, restore from a database dump instead of re-loading the data and re-running the embedding model.
docker compose -f docker-compose.prod.yml up -d --build
The production stack runs 5 services:
db: PostgreSQL + pgvector (internal only, no exposed port)mcp-server: FastMCP over legacy SSE, behind /sse (readonly DB user, read-only FS, cap_drop: ALL)mcp-server-http: the same server over Streamable HTTP, behind /mcpreader: the bilingual reader that every cross-reference URL points at, behind /read/*caddy: reverse proxy and Let's Encrypt. Its rate_limit block for the MCP site is declared but
does not run as written, which DEPLOYMENT.md explainsFor another layer of hardening, put Cloudflare in front of Caddy (DNS proxy, rate-limit rules, and DDoS protection on the free tier).
Full details are in DEPLOYMENT.md.
The repo ships claude_desktop_config.example.json with three ready-to-use entries. Copy whichever fits your setup into claude_desktop_config.json (~/Library/Application Support/Claude/ on macOS, %APPDATA%\Claude\ on Windows), then edit the absolute paths:
The remote entries route through mcp-remote, a bridge from Claude Desktop through npx to the remote MCP server. The example file comments every field; remove the _comment keys before saving.
For nvm users:
commandandenv.PATHneed absolute node paths, because Claude Desktop doesn't read your shell profile. Get them fromwhich npxandwhich pythonwhile your normal shell is active.
On Claude Desktop and Claude Code, copying the bundled skill turns on the multi-step research workflow:
mkdir -p ~/.claude/skills
cp skills/tipitaka-research.md ~/.claude/skills/
# Restart Claude Desktop (Cmd+Q then reopen) to pick up the skill
Details in skills/README.md.
search_semanticThe vector index is built only on text_pali, using a multilingual MiniLM model that was not trained specifically on Pāli. (bilara-data carries Thai for 6 files in all, and the public server loads no Thai edition.) So:
appamāda, search_by_keyword is more precise.search_hybrid (keyword + semantic) tolerates the limitation best.Moving to a Pāli-trained embedding model such as bge-m3, and embedding the Thai edition, are both on the roadmap.
tripitaka-mcp/
├── main.py # Main MCP Server (14 tools, 1 resource + 2 resource templates)
├── cli.py # `tripitaka-mcp` CLI (init / serve) for the pipx edition
├── sutta_verify.py # Quote matching behind `verify_quote`
├── sutta_definitions.py # Canonical definition formulas behind `define_from_suttas`
├── sutta_titles.py # Sutta title resolution
├── mcp_app.py # MCP Apps registration (env-gated, `TRIPITAKA_MCP_APP`)
├── db/
│ ├── connection.py # Database connection pool
│ └── schema.py # Schema (supports translation table)
├── embedding/
│ └── model.py # SentenceTransformer wrapper
├── scripts/
│ ├── install.sh # One-shot installer (HF dump → DB)
│ ├── deploy.sh # Deploy / restart on a VPS
│ ├── backup.sh # pg_dump → S3-compatible store
│ ├── dump_and_publish.sh # Verify embeddings → pg_dump → upload to HuggingFace
│ ├── seed_metadata.py # Seed pitaka/nikāya metadata
│ ├── data_loader.py # Load Sutta Piṭaka (Pāli + bilara EN, per-book translator)
│ ├── load_vinaya.py # Vinaya loader (Vibhaṅga + Pātimokkha + Khandhaka + Parivāra, Brahmali EN)
│ ├── load_abhidhamma.py # Abhidhamma loader (7 books, Pāli — bilara has no EN)
│ ├── load_thai_cc0.py # Thai translation loader
│ ├── load_dictionary.py # Load dictionary data
│ ├── scrape_payutto.py # Web scraper for the Payutto dictionary
│ ├── generate_embeddings.py # Generate vector embeddings
│ ├── run_embedding_with_retry.sh # Resilient wrapper around embedding generation (retries on DB drop)
│ ├── check_embedding_progress.py # Live progress snapshot (or --watch mode) for the embedding job
│ ├── smoke_test.sh # Endpoint smoke test (TLS + /sse + /mcp + /health)
│ ├── test_full_sutta.py # Full-content smoke test (22 size-tiered suttas, exact pinned counts)
│ ├── test_corpus_parity.py # Check the corpus against the bilara-data clone it claims parity with
│ ├── test_definitions.py # `define_from_suttas` regression + snapshot + backend parity
│ ├── test_verify_quote.py # `verify_quote` regression, both backends
│ ├── test_survey_counts.py # `survey_corpus` count drift
│ ├── test_pagination.py # Slice / window / offset behaviour
│ └── test_mcp_prompts.py # Prompt-level test — a real model picks the tools, a judge reads the answer
├── reader/ # Bilingual reader served at /read/* (FastAPI)
│ ├── app.py # Routes: /read/, /read/{sutta_id}, search, browse
│ ├── queries.py # Read-side queries
│ ├── featured.py # Landing-page sutta cards
│ └── sutta_id_decoder.py # Turn a sutta id into a human-readable location
├── site/ # Static landing page served at the apex domain
├── topics/ # Static markdown pages served at /topics/*
│ ├── README.md # Index of available topic pages
│ ├── tipitaka-overview.md # Canon structure + coverage
│ ├── getting-started.md # Connection paths, tool selection, prompt patterns
│ ├── places.md # Geography of the suttas (Mahājanapada, holy sites, cosmology)
│ ├── themes.md # 10 foundational teachings + locus classicus
│ ├── people.md # ~30 major figures (chief disciples, lay supporters, kings)
│ └── timeline.md # Phase-based timeline of the 45-year teaching career
├── skills/ # Portable Claude skills for AI clients
│ ├── README.md # How to install
│ └── tipitaka-research.md # Multi-step research workflow
├── infra/ # Reverse proxy + deploy config
│ ├── Caddyfile # Caddy: TLS, CORS for /mcp, /topics, /sse, /mcp
│ ├── Dockerfile.caddy # Caddy + caddy-ratelimit plugin
│ ├── cloud-init.yml # VPS bootstrap
│ └── *.tf # Terraform (provider-agnostic)
├── docs/
│ └── CAPACITY.md # Capacity planning per VPS spec
├── claude_desktop_config.example.json
├── docker-compose.yml # Dev (single mcp-server)
├── docker-compose.prod.yml # Prod (db + 2 mcp-server + reader + caddy)
├── Dockerfile
└── requirements.txt
This project aggregates data from several sources under different licenses. Please read NOTICE.md in full before redistributing.
For commercial use: remove the dictionary component, or contact Wat Nyanavesakavan for permission.
See CREDITS.md for contributor details and NOTICE.md for license terms.
Gratitude to:
Sādhu 🙏
May the sharing of this Dhamma bring benefit and happiness to all beings.
MCP server for the full Pāli Tipiṭaka — ~444,000 segments at parity with SuttaCentral (Sutta + Vinaya + Abhidhamma). Hybrid search, full-sutta fetch with cross-references, segment-aligned translation
{ "mcpServers": { "dhamma-seeker-tripitaka-mcp": { "url": "https://mcp.tripitaka-mcp.com/mcp", "headers": {} } }}Overview
MCP server for the full Pāli Tipiṭaka — ~444,000 segments at parity with SuttaCentral (Sutta + Vinaya + Abhidhamma). Hybrid search, full-sutta fetch with cross-references, segment-aligned translation comparison, and Pāli word lookup. Offered as Dhamma Dāna.
Tools
No tool list yet. Remote servers get one after the first health check.
FAQ
Copy the http config for Cursor, Claude Desktop, Claude Code, or VS Code on this page. It uses the publisher's install, not a PlugMCP proxy.
No required environment variable is listed on this record.
Tripitaka is reached over HTTP.
Last checked 2026-11-16. MCP server for the full Pāli Tipiṭaka — ~444,000 segments at parity with SuttaCentral (Sutta + Vinaya + Abhidhamma). Hybrid search, full-sutta fetch with cross-references, segment-aligned translation comparison, and Pāli word lookup. Offered as Dhamma Dāna.