mcp server

Tripitaka MCP

MCP server for the full Pāli Canon — search, cite, compare translations. Offered as Dhamma Dāna.

Description as published by the maintainer. Source

• version 1.3.0
• active
• retrieval
• translation

active — Most recent push to the repository was 2026-08-07. Dashed tags are derived by ZBS Index from the published description, not stated by the maintainer.

What this server can do

13 functions, named and described by the server itself. Parameter names are shown because they say more about what a function does than its name usually does.

compare_translations(segment_id)

Compare every available translation for a single segment. 💡 **Use this tool when:** - The user asks about the meaning/translation of a single Pāli line and wants to see multiple translators side-by-side. - Checking how different translators interpret the same line — technical terms like `dukkha`, `anattā`, `nibbāna` carry nuance that varies across translations. - Academic work that needs to quote multiple translations. 🔍 **vs `get_sutta`:** this tool targets a **single segment** (line level); `get_sutta` returns the **whole sutta**. To compare a whole sutta you'd call `compare_translations` for each segment. 📋 **segment_id format:** `<sutta_id>:<paragraph>.<line>`, e.g. `mn1:171.4` (Mūlapariyāyasutta paragraph 171 line 4 — "Nandī dukkhassa mūlaṁ"). Find segment_ids via `get_sutta` or search results. ⚠️ **Current state:** the `translation` table is mostly empty (the DB only loads default Pāli + English from bilara). `total_editions` is usually 0; `text_pali` and `text_english` are always populated. Thai editions will be added later. Required: segment_id.

define_from_suttas(term, limit, include_similes)

Find how the **suttas and Vinaya define a Pāli term in their own words**. The canon defines its own terms with fixed formulas — "Katamañca … dukkhaṁ?" (what is X?) … "ayaṁ vuccati … dukkhaṁ" (this is called X), "X adhivacana" (X is a designation for …), or the Vinaya "X nāma". This tool locates those definitional passages and returns them **cited**, so the assistant can present the doctrinal essence straight from the source. 🧭 **This tool vs `get_word_definition`:** - **`define_from_suttas`** → the *doctrinal* definition, how the term is defined **inside the canon**. Use for "how do the suttas define X", "what is the canonical definition of X", "define X from the suttas". Returns a few precise segments, not a lexicon essay. - **`get_word_definition`** → the *lexical* definition from dictionaries (Payutto / PTS / DPPN). Use for etymology and word meaning. They complement each other — offer both when the user wants the full picture (dictionary sense + how the Buddha defined it). 📖 **How to present the result:** Results are ranked; the top one is usually the canonical definition. **Quote the Pāli (and English where present) verbatim** and render each `cross_reference.tripitaka_mcp_reader.segment_url` as clickable markdown so the user can verify. Do NOT paraphrase into your own definition — the point is the canon's own words. Each result is tagged `kind` (direct / simile) and `detail` (descriptive / enumerative); a *descriptive* definition characterises the term, an *enumerative* one lists its types — prefer the descriptive when explaining the essence. ⚠️ A result tagged `context: true` **does not contain the term in its own line**. The canon's stock similes attach to a formula rather than to a word: the four jhāna similes (bath powder, deep lake, lotus pond, white cloth) never say *jhāna*, they illustrate the `vivicceva kāmehi …` formula that opens the paragraph. Such rows are found through that paragraph, so **say so when quoting one** — present it as the simile the passage uses, not as a line that defines the term. Required: term.

get_reference(sutta_id)

Build a proper citation string for a sutta. 💡 **Use this tool when:** - The user wants a citation for academic work, an article, or a reference. - You need to know the canonical location of a sutta (pitaka / nikāya). - You want a ready-to-use formatted citation string. 🔗 vs `get_sutta`: this tool returns metadata + citation only, no segments. Pair it with `get_sutta` when you want both the content and the citation. Required: sutta_id.

get_sutta(mode, limit, around, offset, window, edition, language, sutta_id, segment_range)

Fetch a sutta's content — OR its table of contents (`mode="outline"`). ⚡ **Decide which mode BEFORE calling — don't fetch the whole sutta and parse it yourself:** - The user wants the **structure / outline / table of contents**, or asks **"how many sections/parts"** / "what's in it" → call `get_sutta(sutta_id, mode="outline")`. It returns the section list (titles + segment counts + ids), NOT the full text — cheap and exact. - The user wants the **context around a search hit** → `around="<segment_id>"` (search tools hand you the id, e.g. `dn22:18.1`) + optional `window`. - The user wants a **specific part** you already located → `segment_range="A..B"` or `offset`+`limit`. - Only fetch the **whole** sutta (no mode/selector) when the user actually wants to read/quote a SHORT sutta in full. Long ones (DN, long Vinaya/Abhidhamma; > ~400 segments — e.g. `dn16` is 1,664) should almost always start with `mode="outline"`; pulling the entire text wastes the context window. Uses standard SuttaCentral IDs, e.g.: - `mn1` = Majjhima Nikāya sutta 1 (Mūlapariyāyasutta, 334 segments) - `dn22` = Dīgha Nikāya sutta 22 (Mahāsatipaṭṭhānasutta, 454 segments) - `dn16` = Dīgha Nikāya sutta 16 (Mahāparinibbānasutta — the longest sutta in the canon, 1,664 segments) - `sn56.11` = Saṃyutta 56.11 (Dhammacakkappavattana) - `mn62` = Majjhima Nikāya 62 (Mahārāhulovāda — advice to Rāhula) - `dhp1-20` = Dhammapada verses 1-20 (KN uses range format) - `mil3.1.1` = Milindapañha 3.1.1 (paracanonical, 3–4 level id) 💡 **Hints for the AI client:** - **Quote `text_pali` / `text_english` directly from the returned segments** — do not rely on training memory. The system is verifiable; AI recall is often wrong. - Short segments numbered `:0.n` are **headers**, not the teaching itself — actual content starts around `:1.1`. They run collection → book → chapter → sutta, so the **last** one is the sutta's own name (`sn35.245:0.3` = Kiṁsukopamasutta, while `:0.2` is its chapter). How many there are varies: DN/MN stop at `:0.2`, Iti reaches `:0.4`. - Segments ending in "...niṭṭhitaṁ" (e.g. `mn1:194.10` = "Mūlapariyāyasuttaṁ niṭṭhitaṁ paṭhamaṁ") are **colophons** marking the close of the sutta. - Segments containing `…pe…` (peyyāla) are **abbreviated repetitions** — not missing data. Pāli texts use this convention for repeated stock phrases. - **Citing this sutta? Link the reader — it IS the authoritative text.** The response's `cross_reference.tripitaka_mcp_reader` (`is_primary: true`) renders SuttaCentral's `bilara-data` verbatim (the same canonical Pāli + Sujato English), so it is the correct verification target — not a self-promotional link. Its `url` shows Pāli + English side by side and `segment_url` highlights the cited line. Render it as clickable markdown for EVERY sutta you name. It is the only verify link to give. - **Cite at the segment level.** Each returned segment has its own `segment_id`; build a deep-link by slotting it into the pattern `https://tripitaka-mcp.com/read/<sutta_id>#<segment_id>`. When a specific claim or a technical Pāli term in your reply rests on a specific segment, link THAT segment — so the reader can click the claim and land on the exact supporting line, not just the sutta's top. e.g. the first-jhāna factors are in `sn45.8:10.2`, the fourth-jhāna in `sn45.8:10.5`. 📑 **Pagination — don't pull a whole giant sutta into context:** By default this returns EVERY segment. That's fine for short suttas but a single big one is huge (`dn16` ≈ 1,664 segments, `pli-tv-kd1` ≈ 3,591). Use one of these instead when the sutta is long (rule of thumb: > ~400 segments) or when you only need part of it: - `mode="outline"` — a table of contents only (section keys + titles + counts + `first_segment_id`/`last_segment_id` + `offset`), **no segment text**. Cheap way to see the structure, then fetch one section. - `around="<segment_id>"` + `window=N` — return the N segments before and after a segment_id. **Ideal after a search:** `search_by_keyword` / `survey_corpus` hand you a precise `segment_id` (e.g. `dn22:18.1`); pass it here to read its context without downloading the whole sutta. - `segment_range="<startId>..<endId>"` — inclusive slice between two segment_ids (use the `..` separator; omit the end id to go to the end). Pairs with `mode="outline"` (use a section's first/last id). - `offset` (0-based) + `limit` — ordinal paging. The response's `page` block carries `next_offset` to fetch the following page. Only one selector (around / segment_range / offset+limit) may be used at a time. Every response includes `total_segments` (the full count) so you know how much remains. ✅ **Coverage (v1.1+):** all three pitakas at parity with SuttaCentral `bilara-data`: - Sutta Piṭaka (DN/MN/SN/AN/KN): Pāli + Sujato EN (5,791 sections) - Vinaya Piṭaka: Pāli + Brahmali EN — SC codes e.g. `pli-tv-bu-vb-pj1` (Bhikkhu Pārājika 1), `pli-tv-bi-vb-pj1` (Bhikkhunī), `pli-tv-kd1` (Mahāvagga), `pli-tv-pvr10` (Parivāra), `pli-tv-bu-pm` (Bhikkhu Pātimokkha) - Abhidhamma Piṭaka: 7 books (ds, vb, dt, pp, kv, ya, patthana) — Pāli only (bilara has no English translator for any Abhidhamma book) Required: sutta_id.

get_word_definition(word, language, limit_context)

Look up the dictionary meaning of a Pāli word, with sutta context. Serves as a Pāli Dictionary Bridge — pairs the "definition" with the "context where the Buddha actually used the word". 📖 **About the dictionary sources:** This tool draws from multiple primary dictionaries, including "พจนานุกรมพุทธศาสน์ ฉบับประมวลศัพท์" (Buddhist Dictionary — Concept-Glossary edition) by Somdet Phra Buddhaghosacariya (P. A. Payutto). The Thai-language entries are **original scholarly works** (not translations), so they are **always available** even when ENABLED_LANGUAGES has Thai disabled. The AI client should translate Thai entries into the user's language if needed. Required: word.

list_editions

List the translation editions available, with coverage stats. 💡 **Use this tool when:** - Before calling `compare_translations` or `get_sutta(edition=...)`, so you know which edition values are valid and worth comparing. - The user asks which editions are loaded in the DB. 🔍 **Filtering:** Filtered by the server's `TRIPITAKA_ENABLED_LANGUAGES` — when Thai is disabled the list is empty. Only enabled languages are returned. ⚠️ **Current state:** the DB mostly holds Pāli (default from SuttaCentral bilara) and English (Sujato). Thai editions (`dhiranandi`, `jayasaro`, `mbu`, `royal`) aren't indexed yet — the list returns empty until they're loaded. Returns: List of edition objects, each containing: - edition: edition code, e.g. "sujato", "dhiranandi", "mbu" - translator: translator's name - language: ISO code ("pi", "en", "th") - segment_count: how many segments have a translation in this edition - sutta_count: how many suttas have a translation.

list_structure

Show the structure of all three pitakas with coverage statistics. 💡 **Use this tool when:** - The user asks for an overview of the Tipiṭaka (what's in it / which collections). - You need to check coverage before promising a search will find something — `segment_count > 0` is the active-loaded signal. - Verifying scope when compiling an artifact. 📊 **Current state (v1.1+, at parity with SuttaCentral bilara-data):** - **Sutta Piṭaka** complete: DN 37, MN 155, SN 1,829, AN 1,419, KN 2,351 sections (~284,702 segments) — Pāli + Sujato EN - **Vinaya Piṭaka** complete: Bhikkhu Vibhaṅga 222, Bhikkhunī Vibhaṅga 127, Khandhaka 22, Parivāra 51 + Pātimokkha 2 (~71,557 segments) — Pāli + Brahmali EN - **Abhidhamma Piṭaka** complete: 7 books (ds, vb, dt, pp, kv, ya, patthana) ~88,414 segments — Pāli only (bilara has no English for any Abhidhamma book) - **Total ~444,673 segments** in the DB ⚠️ **Known quirks:** - The schema carries duplicate legacy + SC-modern codes side by side: - Vinaya: `vin-v/vin-m/vin-c/vin-p` (legacy, segment_count = 0) alongside `pli-tv-bu-vb/pli-tv-bi-vb/pli-tv-kd/pli-tv-pvr` (active, populated). - Abhidhamma: `ym/pt` (legacy = 0) alongside `ya/patthana` (active). - **Use the `active` flag** — each nikaya carries `active: true/false` (true ⇔ `segment_count > 0`). Pick `active` nikayas; the others are metadata placeholders from an older migration. 🌐 **Languages:** Returns Pāli + Thai + English labels regardless of enabled set (these are metadata, not segment text). Text content follows ENABLED_LANGUAGES. Thai translations aren't loaded yet. Returns: Hierarchical structure: - pitakas{vinaya/sutta/abhidhamma} → nikayas[] - Each nikaya: code, name (3 languages), sutta_count, segment_count.

open_sutta_viewer(around, offset, window, sutta_id, translations, translation_language, translation_disclaimer)

Open an interactive sutta viewer inside the chat — Pāli + English, plus an optional third row in the user's own language translated BY YOU. Renders each segment as: Pāli on top (canonical), the Bhikkhu Sujato English below it (verification anchor), and — when you supply `translations` — your translation in the user's language, clearly badged as AI-generated. Prefer this over dumping raw segments when the user wants to *read* a sutta. - `sutta_id` — standard SuttaCentral id, e.g. `sn56.11`, `mn10`, `dn22`. - `around` — a segment_id (e.g. `dn22:18.1`, from a search hit) to centre on; that segment is highlighted and scrolled into view. Use this after a search so the reader lands on the exact cited line. - `offset` — 0-based segment index for paging long suttas (use `next_offset` from the previous result). Do NOT combine with `around`. - `window` — segments before/after `around` to include (default 12). 🌐 **Translating for the user (important):** when the conversation language is neither English nor Pāli, you SHOULD translate the displayed segments and pass them via `translations` so the user reads in their own language while still seeing the originals: 1. Fetch the segments first (`get_sutta` with the same selector) so you have the exact Pāli + English text. (Already called this tool without translations? The result contains the segments — translate them and call this tool AGAIN with the same selector plus `translations` to upgrade the view.) Your translation must travel through the `translations` parameter to appear in the viewer — writing it as a normal chat message leaves the viewer bilingual and looks broken; the tool always accepts `translations`, so never report it as missing. 2. Translate **from the Pāli as the source, using the English as a semantic guide** — never relay-translate from English alone. Preserve untranslatable doctrinal terms (dukkha, jhāna, taṇhā…) as loanwords with a brief gloss instead of forcing equivalents. 3. Call this tool with `translations=[{segment_id, text}, ...]` covering ONLY the segments being displayed (never a whole long sutta), `translation_language` (BCP-47, e.g. "th", "es"), and `translation_disclaimer` — one short line IN THE USER'S LANGUAGE saying the translation is AI-generated in this conversation and should be checked against the Pāli/English above. Translations are conversation-ephemeral: nothing is stored server-side; the canon stays Pāli + English only. Translations whose segment_id is not in the displayed window are dropped (reported in `translations_dropped`). Without `around`, shows the sutta from the top (capped for long suttas). Required: sutta_id.

parse_pali_word(word)

Strip Pāli inflectional suffixes to find the root form (basic stem). 💡 **Use this tool when:** - You find an inflected Pāli word (e.g. `dukkhassa`, `bhikkhūnaṁ`) and `get_word_definition` doesn't find it directly — Pāli inflects nouns across 7 cases × 2 numbers, ~16 forms per root. - You want to split a compound (`sammāsambuddhassa` → `sammā` + `sambuddha` + `-ssa` genitive). - You want to see possible stems before another `get_word_definition` lookup. 🔄 **Recommended workflow:** `parse_pali_word(inflected_form)` → get `possible_stems[]` → call `get_word_definition(stem)` per stem until you find a definition. ⚠️ **Limitations:** - Rule-based first-pass — strips common suffixes (case endings, vowel shortening). Not a full morphological analyzer. - Compound words (samāsa) are NOT split — `dukkhanirodha` won't be broken into `dukkha` + `nirodha`. - Sandhi (sound junctions) like `tena ahaṁ → tenāhaṁ` aren't reversed. - Returns **possible** stems — verify each via `get_word_definition`. Required: word.

search_by_keyword(limit, pitaka, edition, keyword, language)

Keyword search across the Pāli Tipiṭaka (trigram word-similarity). Searches the configured enabled language(s) on the server. Filterable by pitaka and translation edition. 💡 **Hints for the AI client:** The system's canonical reference is Romanised Pāli (from SuttaCentral). If the user asks in a disabled or unsupported language, translate the keyword to **Romanised Pāli (preferred) or English** before calling this tool — e.g. "suffering" → "dukkha", "mindfulness of breathing" → "ānāpānassati". See the server instructions for the enabled language set. 🔍 **Pick the right search tool for the question shape:** - **Term lookup (exact word appearances)** — e.g. "occurrences of `ānāpānassati`": this tool is best (trigram nails the exact word). - **Concept search ("discourses about X")** — e.g. "discourses about mindfulness of breathing": **use `search_hybrid` instead.** Canonical Pāli has two quirks that hurt keyword search for concepts: • Section headings (`Ānāpānapabba`) often use a different word than the teaching body, which uses verb forms (`assasati`, `passasati`, `dīghaṁ`, `rassaṁ`). E.g. DN22's Ānāpānapabba has 16 segments but the word `ānāpāna` appears in only 2 (header + footer) — the actual teaching segments won't match. • Stock phrases (e.g. `So satova assasati, satova passasati`) recur in 10+ suttas, so a keyword query ranks broadly and won't pinpoint the canonical reference. - **General keyword survey** — set `limit≥30` and filter client-side, or call multiple related forms (root verb + noun + compound). Required: keyword.

search_hybrid(limit, query, language)

Hybrid search — combines keyword + semantic search via RRF. Uses Reciprocal Rank Fusion (RRF) to merge exact-word results with meaning-based results. **This is the recommended tool for "discourses about X" / concept queries**, because the semantic side catches suttas that discuss a concept using different vocabulary (e.g. some mindfulness-of-breathing suttas use `assasati/passasati/dīghaṁ` instead of `ānāpānassati`). 💡 **Hints for the AI client:** - English queries usually work best (e.g. `mindfulness of breathing`) because the embedding model is multilingual but EN-primary. - Thai stop-word handling is weak. If a Thai query underperforms, the AI client should translate to Pāli/English first (see server instructions). - The default `limit=5` is often too small for a topic survey — use `limit=15-20` (max 20) for good coverage. - Ranking is by similarity, NOT canonical importance — locus classicus suttas (e.g. MN118, DN22) may rank below smaller suttas that happen to use the exact vocabulary. Treat results as a starting point, then call `get_sutta` for the canonical references. Required: query.

search_semantic(limit, query, language, threshold)

Semantic search — match by meaning, not exact words. Uses vector similarity (cosine distance) over `text_pali` embedded with a multilingual MiniLM model. 🤔 **In most cases you should use `search_hybrid` instead** — it combines this semantic search with keyword search and ranks better. Use this tool only when you need: - Pure semantic results (no keyword influence) - Fine-grained `threshold` tuning (hybrid uses RRF which is harder to tune) - To debug what semantic alone picks up vs keyword ⚠️ Known limitations: - The index is **Pāli only** (English/Thai queries pass through the multilingual embedding but the model isn't tuned on Pāli) - English queries usually embed better than Thai (model is EN-primary) - For specific Pāli terms (`appamāda`, `dukkha`), exact match is better — use `search_by_keyword` instead - Pāli stock phrases recur in many suttas → similarity scores cluster; read the top 10, don't trust rank 1 alone Required: query.

survey_corpus(mode, cursor, pitaka, keyword, language, page_size, sem_limit, match_scope, sem_threshold)

Exhaustively survey the WHOLE Tipiṭaka for a term — guaranteed complete. Use this (not `search_by_keyword`) when the question is about **coverage or counting** rather than "show me the best passages": - "How many times does Kusinārā appear in the canon?" - "Every place ānāpānassati is mentioned — don't miss any" - "Which pitakas/how many suttas mention this term?" Unlike `search_by_keyword` (ranked, capped at 50, no total), this returns an **exact count**, a **per-pitaka breakdown**, the **distinct surface forms** that matched (so you can audit and discard over-matches), and a paginated enumeration. The `lexical` result carries `complete: true` — a hard guarantee that nothing was dropped for the chosen `match_scope`. Two layers, two different promises: - **lexical** — the word and its forms. Deterministic + EXHAUSTIVE. - **semantic** (`mode="thorough"`, hosted only) — passages teaching the same concept with DIFFERENT vocabulary (e.g. ānāpānassati via `assasati`/`passasati`). Approximate, **NOT exhaustive** — it never claims completeness, it only boosts recall. Required: keyword.

Last successful function declaration observed on 2026-08-13. Source: https://mcp.tripitaka-mcp.com/mcp. We list what the server declared; we do not call any of these functions.

Endpoint status observed on 2026-08-13. Source: https://mcp.tripitaka-mcp.com/mcp.

Signals

These are separate measurements of different things. They are deliberately not combined into one score, because a popularity number that mixes website traffic with saves and stars cannot be checked or acted on.

Where to get it

• Repository — https://github.com/dhamma-seeker/tripitaka-mcp
• Website — https://tripitaka-mcp.com
• Remote endpoint (streamable-http) — https://mcp.tripitaka-mcp.com/mcp
• Remote endpoint (sse) — https://mcp.tripitaka-mcp.com/sse

Related, by what their authors tagged them

• Fodda Brand Intelligence — last commit 2026-08-06, shares research
  Brand health & trend footprint across PSFK expert graphs with citable sources, not web summaries.
• Fodda Deep Research — last commit 2026-08-06, shares research
  Autonomous deep research reports merging PSFK trend graphs with citable sources.
• Fodda Earnings Intelligence — last commit 2026-08-06, shares research
  Cross-company earnings trends & executive divergence with citable sources.
• Fodda Synthetic Expert Consult — last commit 2026-08-06, shares research
  Consult synthetic industry experts grounded in PSFK trend graphs with citable sources.
• Fodda Knowledge Graphs — last commit 2026-08-06, shares research
  Expert-curated knowledge, brand, research & earnings intelligence — 31 tools, 220+ graphs.
• Fodda Topic & Trend Research — last commit 2026-08-06, shares research
  Trend, stats & insight search across PSFK expert graphs with citable sources.
• Conference Partner — last commit 2026-08-06, shares research
  Academic conference & journal CFP deadlines, CCF/ICORE/QUALIS rankings, acceptance rates.
• com.nobleblocks/nobleblocks-mcp — last commit 2026-06-08, shares research
  Search 340M+ academic papers — citation graphs, semantic similarity, and AI literature reviews.
• Egypt Research Commons — last commit 2026-07-20, shares research
  Source-grounded research for Egyptian public affairs
• kObsidian — last commit 2026-07-16, shares research
  Filesystem-first MCP for Obsidian — an LLM-maintained wiki inspired by Karpathy's LLM Wiki.

These share tags the maintainers applied themselves, such as research. Common tags like "mcp" or "ai" are ignored for this: agreeing with six hundred other projects is not a similarity.

This is not a recommendation and not a test result. It is a map of what the authors said their work is about.

How the author describes it

Topics the maintainer set on GitHub: buddha, buddhism, buddhist, canon, dhamma, dhamma-learning, mcp-server, pali, research, tipitaka, tipitaka-search, tripitaka.