# fojin — Buddhist Canon Tools — MCP server card for AI agents

Buddhist canon tools: search, passages, cross-canon parallels, dictionaries — all URN-cited.

Registry name: `app.fojin/fojin-mcp` · category: Search and knowledge · version 0.4.0 · updated 2026-08-10

## Connect
- Remote (Claude Code): `claude mcp add --transport http fojin-buddhist-canon-tools https://mcp.fojin.ai/mcp`

## Facts
- Repository: https://github.com/xr843/fojin (361 stars)
- Website: https://fojin.app

Before you connect a server: read its repository, and give it only the permissions and keys it needs.

## Links
- AgentGid page: https://agentgid.com/mcp/servers/app-fojin-fojin-mcp/


## FoJin: Buddhist scriptures your AI assistant can cite

FoJin is a free online library of Buddhist scriptures in Chinese, Pali, Tibetan and Sanskrit. This server lets your AI assistant search it, read the real passages, compare versions across traditions and check whether a quote is genuine. Every passage comes with a stable reference you can cite and open.

### Where to use it
- Check a scripture quote before publishing: Before a quote goes into an article or a talk, the assistant checks whether it really is in the canon, and whether it is in the text you named.
- Answers grounded in real passages: Ask about a Buddhist idea and the assistant searches the texts, reads the passage and quotes it, instead of quoting from memory.
- Compare a passage across traditions: See how the same passage reads in the Chinese, Pali, Tibetan and Sanskrit versions, side by side, with a link to each.
- Look up Buddhist terms: Find a term such as a doctrine name in many Buddhist dictionaries at once, in Chinese, Sanskrit, Pali, Tibetan and English.
- Read what commentators said: Give one line of a sutra and get the classical commentaries on it, each with the commentator's words and a link to the source.
- Footnotes for a study blog: When you write study notes or a blog post, let the assistant add a checked reference and a reading link to every quoted line. (idea, not from the official pages)

### How to start
- Add the hosted server to your assistant. Nothing to install and no key.

```
claude mcp add --transport http fojin https://mcp.fojin.ai/mcp
```

- Or run it on your own computer over stdio with uv.

```
uvx fojin-mcp
```

- Ask a question and have the assistant quote only what read_passage returns, then run verify_quote on each quote.

### License
The server code is free under Apache 2.0, also for paid products. The scripture texts keep their own licenses, and the largest source, CBETA, forbids commercial use.

### Good to know
- All tools only read. The server keeps no passwords, ships no texts of its own and only asks FoJin's public site.
- The hosted server limits how often each client may call it. On an error 429, wait and follow the Retry-After header.
- The quote check covers Classical Chinese only and needs at least four Chinese characters. Short phrases recur, so read whether the reference matched.
- Commentary coverage is partial. A missing commentator means the data is not there yet, not that nobody commented.
- The project's own pages disagree on counts, for example 32 or 39 dictionaries and six or eight tools; the code at the checked version has eight tools.

Checked 2026-11-10 against: https://fojin.app/agents, https://github.com/xr843/fojin/blob/486bceca994c3b32b3efe69c4675ebbc0fd36565/README.md, https://github.com/xr843/fojin/blob/486bceca994c3b32b3efe69c4675ebbc0fd36565/NOTICE, https://github.com/xr843/fojin/blob/486bceca994c3b32b3efe69c4675ebbc0fd36565/mcp-server/README.md, https://github.com/xr843/fojin/blob/486bceca994c3b32b3efe69c4675ebbc0fd36565/mcp-server/pyproject.toml, https://github.com/xr843/fojin/blob/486bceca994c3b32b3efe69c4675ebbc0fd36565/mcp-server/server.json, https://github.com/xr843/fojin/blob/486bceca994c3b32b3efe69c4675ebbc0fd36565/mcp-server/fojin_mcp/server.py, https://github.com/xr843/fojin/blob/486bceca994c3b32b3efe69c4675ebbc0fd36565/mcp-server/fojin_mcp/client.py, https://github.com/xr843/fojin/blob/486bceca994c3b32b3efe69c4675ebbc0fd36565/mcp-server/fojin_mcp/http.py, https://pypi.org/pypi/fojin-mcp/json, https://files.pythonhosted.org/packages/5c/fe/14c0efe975dbc4c6175c32f30521caa78a1f11d3c00af80a1d542246dab7/fojin_mcp-0.4.0-py3-none-any.whl

### Mistakes to avoid
- Don't: Letting the assistant quote a sutra from memory → Do: Quote only the text read_passage returns, then run verify_quote on each quoted line. (Language models routinely invent plausible-looking quotes.)
- Don't: Treating verbatim true as proof that your citation is right → Do: Read cite_matched; a hit in another fascicle does not confirm the reference you gave. (A real line is often quoted under the wrong text.)
- Don't: Using every parallel get_parallels returns for one passage → Do: Match the passage against source_chunks[].text and keep the parallels whose aligns_source_chunk equals that chunk_index. (The tool returns parallels for the whole fascicle, often hundreds.)
- Don't: pip install fojin-mcp==0.1.0 with a current mcp package → Do: Use fojin-mcp 0.2.0 or newer (0.4.0 checked), which needs mcp 2.x. (Version 0.1.0 imported a module that mcp 2.0 removed.)

### Questions
- Do I need an account or a key? No. The hosted server is anonymous and needs no key; it only limits how often each client calls it.
- Can the assistant change anything in FoJin? No. All eight tools only read, and the server sends only GET requests to FoJin's public site.
- Can I use the quoted texts in a paid app? Not freely. The code is Apache 2.0, but CBETA texts forbid commercial use and 84000 translations are non-commercial with no derivatives.
- Can I run it against my own copy of FoJin? Yes. Set FOJIN_API_BASE_URL to your own instance when you run the local server.

---
AgentGid's catalog is curated: every entry was checked against the maker's official pages (registry, repository, license and pricing pages) on the date shown; a license value shows the quote it stands on wherever AgentGid has one. Usage numbers come from AgentGid's own scan of public repositories set up for AI coding agents. Claims by makers are reported, not tested by AgentGid.
