Fojin — Buddhist Canon Tools

What fojin — Buddhist Canon Tools does

fojin — Buddhist Canon Tools provides an MCP interface to FoJin, a searchable aggregation of Buddhist texts and reference data. It is intended for assistants that need to retrieve source material while answering questions about Buddhist scriptures, terminology, and relationships between versions in different canons.

The server exposes eight read-only tools. Retrieved content is addressable through FoJin URNs, allowing an assistant or developer to retain a stable reference to the source passage. The corpus described by the project includes material from 612 sources, more than 10,500 texts, and content in languages including Classical Chinese, Pali, Tibetan, and Sanskrit. The MCP listing does not describe write operations.

How it works

An MCP client sends requests to the server using the Model Context Protocol. The tools query FoJin’s indexed corpus and return text or reference data that the assistant can use in its response. Search and passage retrieval support finding relevant material; cross-canon tools help compare related passages; dictionary tools provide terminology lookup.

The hosted service is available at https://mcp.fojin.ai/mcp and does not require installation or an API key. The project also publishes the fojin-mcp package for local stdio use. A local process can be started with uvx fojin-mcp or installed with pip, then configured to work with a local FoJin deployment.

Setup and configuration

For the hosted option, add the MCP endpoint to a compatible client. The README gives this Claude command:

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

For local use, run:

uvx fojin-mcp

The repository also documents running the broader FoJin platform with Docker, importing source data, and generating embeddings. Those steps apply when operating a complete local FoJin instance, not when using the hosted MCP endpoint. The supplied material does not specify required environment variable names for the MCP package.

Tools and capabilities

The server’s documented capability groups are:

• Searching the Buddhist canon
• Retrieving cited passages
• Finding cross-canon parallels
• Looking up dictionary entries
• Addressing sources through stable FoJin URNs
• Returning read-only results for use by MCP clients

fojin — Buddhist Canon Tools is a suitable fit when an agent needs to locate Buddhist source passages or compare traditions. It is less suited to workflows that require modifying corpus data or using MCP tools to write annotations, collections, or other records.

Limitations and notes

The server is read-only, so the documented interface does not provide mutation tools. The repository’s corpus is assembled from external public sources, and the local platform setup starts with schema and source metadata rather than imported text; content import is required for a fully populated self-hosted deployment. The hosted endpoint avoids that local data-loading process.

The project describes citations as URN-linked and verifiable, but an MCP client still determines how retrieved passages are presented in its final answer. For reproducible research, preserve the returned citation and inspect the referenced source passage rather than relying only on a generated summary.

The fojin — Buddhist Canon Tools MCP server is focused on Buddhist textual research. Its documented coverage should not be treated as a general-purpose web search service or a general dictionary outside the indexed FoJin sources.