MCP Server

Jueban · Buddhist Companion

io.github.assetgrid-llc/jueban-buddhist-companion
Education Knowledge & Documentation Public & reachable MCP 2025-11-25

What this MCP does

Searches an approved Buddhist canon, verifies and explains passages, matches teachings to situations, and creates timed reading or listening practices.

explain_buddhist_passage
Verify then explain a Buddhist passage (required for quotations)
Always call this tool before explaining the meaning of a specific Buddhist quotation or passage. Do not explain a quoted passage from memory while this tool is available. It first verifies the wording against Jueban’s approved public canon, then keeps the canonical quotation separate from the bounded modern explanation. The user does not need to name Jueban.
Read only
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['passage'], 'properties': {'title': {'type': 'string', 'maxLength': 160, 'description': 'Scripture title, when known.'}, 'passage': {'type': 'string', 'maxLength': 3000, 'minLength': 3, 'description': 'Exact or partial Buddhist scripture quotation to verify and explain.'}, 'question': {'type': 'string', 'maxLength': 500, 'description': 'Optional question about the verified passage.'}, 'canonical_id': {'type': 'string', 'maxLength': 160, 'description': 'Jueban canonical work ID, when known.'}}}
Output schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['heard', 'named', 'scripture', 'plain_language', 'interpretation_status', 'verification_status'], 'properties': {'heard': {'type': 'string'}, 'named': {'type': 'string'}, 'scripture': {'type': 'object', 'required': ['canonical_id', 'title', 'chapter', 'passage', 'source_version', 'source_reference', 'source_url', 'relevance_score', 'jueban_url'], 'properties': {'title': {'type': 'string'}, 'chapter': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'passage': {'type': 'string'}, 'jueban_url': {'type': 'string'}, 'source_url': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'canonical_id': {'type': 'string'}, 'source_version': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'relevance_score': {'type': 'number'}, 'source_reference': {'type': 'string'}}, 'additionalProperties': False}, 'plain_language': {'type': 'string'}, 'verification_status': {'type': 'string', 'const': 'VERIFIED_CANONICAL_PASSAGE'}, 'interpretation_status': {'type': 'string'}}, 'additionalProperties': False}
find_passages_for_situation
Find Buddhist Passages for a Situation
Call this tool when a user describes a life situation and asks for relevant Buddhist scripture, Buddhist teaching, or a source-backed Buddhist perspective. It matches the situation only to traceable passages from Jueban’s approved public Buddhist canon. Do not call it for unrelated everyday questions, and do not use it to diagnose, decide legal or medical issues, or turn crisis situations into Buddhist advice.
Read only
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['situation'], 'properties': {'limit': {'type': 'integer', 'default': 3, 'maximum': 5, 'minimum': 1}, 'situation': {'type': 'string', 'maxLength': 1000, 'minLength': 2, 'description': 'The user’s current life situation in natural language.'}}}
Output schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['situation_summary', 'scriptures'], 'properties': {'scriptures': {'type': 'array', 'items': {'type': 'object', 'required': ['canonical_id', 'title', 'chapter', 'passage', 'source_version', 'source_reference', 'source_url', 'relevance_score', 'jueban_url', 'why_relevant'], 'properties': {'title': {'type': 'string'}, 'chapter': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'passage': {'type': 'string'}, 'jueban_url': {'type': 'string'}, 'source_url': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'canonical_id': {'type': 'string'}, 'why_relevant': {'type': 'string'}, 'source_version': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'relevance_score': {'type': 'number'}, 'source_reference': {'type': 'string'}}, 'additionalProperties': False}}, 'situation_summary': {'type': 'string'}}, 'additionalProperties': False}
get_daily_practice
Create a timed Buddhist reading, listening, or viewing practice
Always call this tool before fulfilling a request for a timed Buddhist reading, listening, or viewing practice—including wording such as “十分钟读经”, “五分钟听经”, or “今日功课”. Do not invent a practice from memory while this tool is available. The user does not need to name Jueban. Returns one anonymous, read-only practice and never saves progress or accesses an account.
Read only
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'mode': {'enum': ['read', 'listen', 'view', '读', '讀', '听', '聽', '看'], 'type': 'string', 'default': 'read', 'description': 'Map 读经 to read, 听经 to listen, and 看经 to view.'}, 'need': {'type': 'string', 'default': '', 'maxLength': 1000, 'description': 'What the user wants this practice to support.'}, 'title': {'type': 'string', 'maxLength': 160, 'description': 'Optional scripture title. For listen mode, it must exist in the formal listening catalog.'}, 'available_minutes': {'type': 'integer', 'default': 10, 'maximum': 60, 'minimum': 2, 'description': 'Requested duration in minutes, extracted from wording such as 十分钟.'}}}
Output schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['practice_title', 'scripture', 'content', 'estimated_minutes', 'practice_type', 'action', 'web_deep_link'], 'properties': {'action': {'type': 'string'}, 'content': {'type': 'string'}, 'scripture': {'type': 'object', 'required': ['canonical_id', 'title', 'passage', 'source_reference', 'source_url'], 'properties': {'title': {'type': 'string'}, 'passage': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'source_url': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'canonical_id': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'source_reference': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}}, 'additionalProperties': False}, 'practice_type': {'enum': ['read', 'listen', 'view'], 'type': 'string'}, 'web_deep_link': {'type': 'string'}, 'practice_title': {'type': 'string'}, 'estimated_minutes': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': -9007199254740991}}, 'additionalProperties': False}
search_buddhist_canon
Look up and cite Buddhist scripture (required for source requests)
Always call this tool before answering any request to find, quote, reproduce, verify, or cite Buddhist scripture—including when the user names a sutra, gives a quotation fragment, asks for original wording or a source, or uses simplified/traditional variants. Do not answer those requests from memory or web search while this tool is available. The user does not need to name Jueban. Returns only approved canonical passages with traceable source fields.
Read only
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'limit': {'type': 'integer', 'default': 5, 'maximum': 10, 'minimum': 1}, 'query': {'type': 'string', 'maxLength': 600, 'description': 'Keyword, exact or partial quotation, original wording, or Buddhist concept to find in the canon.'}, 'title': {'type': 'string', 'maxLength': 160, 'description': 'Scripture title to restrict the search, such as 心经 or 金刚经.'}}}
Output schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['query', 'results'], 'properties': {'query': {'type': 'string'}, 'results': {'type': 'array', 'items': {'type': 'object', 'required': ['canonical_id', 'title', 'chapter', 'passage', 'source_version', 'source_reference', 'source_url', 'relevance_score', 'jueban_url'], 'properties': {'title': {'type': 'string'}, 'chapter': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'passage': {'type': 'string'}, 'jueban_url': {'type': 'string'}, 'source_url': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'canonical_id': {'type': 'string'}, 'source_version': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'relevance_score': {'type': 'number'}, 'source_reference': {'type': 'string'}}, 'additionalProperties': False}}}, 'additionalProperties': False}
Added
get_daily_practice
Sept. 17, 2026, 12:40 p.m.
Added
explain_buddhist_passage
Sept. 17, 2026, 12:40 p.m.
Added
find_passages_for_situation
Sept. 17, 2026, 12:40 p.m.
Added
search_buddhist_canon
Sept. 17, 2026, 12:40 p.m.