{
 "kind": "mcp",
 "slug": "app-fojin-fojin-mcp",
 "path": "mcp/servers/app-fojin-fojin-mcp/",
 "name": "fojin — Buddhist Canon Tools",
 "maker": "xr843",
 "density": "full",
 "crumbs": [
  [
   "MCP servers",
   "mcp/"
  ],
  [
   "Search and knowledge",
   "mcp/search/"
  ]
 ],
 "lead": "Buddhist scriptures your AI assistant can cite.",
 "chips": [
  {
   "label": "Search and knowledge",
   "path": "mcp/search/"
  },
  {
   "label": "Official"
  },
  {
   "label": "Remote"
  }
 ],
 "primary": {
  "label": "Copy connect command",
  "copy": "claude mcp add --transport http fojin https://mcp.fojin.ai/mcp"
 },
 "links": [
  {
   "label": "GitHub",
   "href": "https://github.com/xr843/fojin"
  },
  {
   "label": "Website",
   "href": "https://fojin.app"
  }
 ],
 "track": "New versions and outages of the remote endpoint on your dashboard",
 "verdicts": [
  {
   "key": "official",
   "label": "Made by",
   "value": "The service itself",
   "status": "yes",
   "sub": "Official server",
   "quote": "Homepage = \"https://fojin.app\"",
   "note": "The server comes from the same repository and maker as the FoJin site it wraps; the package homepage is fojin.app and the README names mcp.fojin.ai as FoJin's own hosted endpoint.",
   "src": "https://github.com/xr843/fojin/blob/486bceca994c3b32b3efe69c4675ebbc0fd36565/mcp-server/pyproject.toml"
  },
  {
   "key": "secrets",
   "label": "Keys",
   "value": "No key needed",
   "status": "yes",
   "sub": "No account",
   "quote": "any client that speaks streamable HTTP can point at https://mcp.fojin.ai/mcp.",
   "note": "Any client that speaks streamable HTTP can use the hosted address; any stdio client can launch uvx fojin-mcp. FOJIN_API_BASE_URL (optional) points the local server at a self-hosted FoJin.",
   "src": "https://github.com/xr843/fojin/blob/486bceca994c3b32b3efe69c4675ebbc0fd36565/mcp-server/README.md"
  },
  {
   "key": "where",
   "label": "Runs",
   "value": "Remote",
   "status": "yes",
   "sub": "Nothing runs on your machine",
   "note": "Endpoint: https://mcp.fojin.ai/mcp. Checked: yes.",
   "src": "https://mcp.fojin.ai/mcp"
  },
  {
   "key": "license",
   "label": "Commercial use",
   "value": "With conditions",
   "status": "cond",
   "sub": "Apache-2.0 license",
   "quote": "Attribution required; commercial use prohibited; derivatives must be shared under the same license and must not alter the substantive content.",
   "note": "The server code is Apache 2.0, but each source text keeps its own license; CBETA texts forbid commercial use.",
   "src": "https://github.com/xr843/fojin/blob/486bceca994c3b32b3efe69c4675ebbc0fd36565/NOTICE"
  }
 ],
 "vfoot": "Checked against its repository at one commit, on Nov 10, 2026.",
 "blocks": [
  {
   "id": "overview",
   "nav": "Overview",
   "h2": "What fojin — Buddhist Canon Tools does",
   "parts": [
    {
     "t": "prose",
     "text": "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."
    },
    {
     "t": "h3",
     "text": "What people use it for"
    },
    {
     "t": "uses",
     "items": [
      {
       "title": "Check a scripture quote before publishing",
       "text": "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.",
       "idea": false
      },
      {
       "title": "Answers grounded in real passages",
       "text": "Ask about a Buddhist idea and the assistant searches the texts, reads the passage and quotes it, instead of quoting from memory.",
       "idea": false
      },
      {
       "title": "Compare a passage across traditions",
       "text": "See how the same passage reads in the Chinese, Pali, Tibetan and Sanskrit versions, side by side, with a link to each.",
       "idea": false
      },
      {
       "title": "Look up Buddhist terms",
       "text": "Find a term such as a doctrine name in many Buddhist dictionaries at once, in Chinese, Sanskrit, Pali, Tibetan and English.",
       "idea": false
      },
      {
       "title": "Read what commentators said",
       "text": "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.",
       "idea": false
      },
      {
       "title": "Footnotes for a study blog",
       "text": "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": true
      }
     ]
    }
   ]
  },
  {
   "id": "popularity",
   "nav": "Popularity",
   "h2": "fojin — Buddhist Canon Tools popularity",
   "parts": [
    {
     "t": "stats",
     "items": [
      {
       "n": "361",
       "l": "GitHub stars, xr843/fojin"
      },
      {
       "n": "0",
       "l": "public agent projects connect it"
      }
     ]
    }
   ]
  },
  {
   "id": "tools",
   "nav": "Tools",
   "h2": "Tools it gives your agent (8)",
   "parts": [
    {
     "t": "tools",
     "items": [
      {
       "name": "search_corpus",
       "text": "Searches the whole collection by meaning and returns matching passages with a reference, title, snippet and score."
      },
      {
       "name": "read_passage",
       "text": "Returns the full text of one fascicle (chapter) of a text."
      },
      {
       "name": "get_parallels",
       "text": "Returns the matching passages in the Pali, Tibetan and Sanskrit canons for a Chinese fascicle."
      },
      {
       "name": "lookup_dictionary",
       "text": "Looks a Buddhist term up across FoJin's dictionaries."
      },
      {
       "name": "lookup_entity",
       "text": "Finds people, places, works and terms in FoJin's knowledge graph."
      },
      {
       "name": "resolve_urn",
       "text": "Turns a fojin reference into a reading link and confirms it exists."
      },
      {
       "name": "verify_quote",
       "text": "Checks whether a Classical Chinese quote appears word for word in the canon, and whether it is where you said."
      },
      {
       "name": "commentaries",
       "text": "Returns what historical commentators wrote about a given line of scripture."
      }
     ]
    }
   ]
  },
  {
   "id": "data",
   "nav": "Data and license",
   "h2": "What it sends and its license",
   "parts": [
    {
     "t": "rows",
     "rows": [
      {
       "l": "Sends",
       "v": "your search words, quotes and references the assistant sends to a tool",
       "sub": "To mcp.fojin.ai (hosted) or fojin.app (the local server's default target); on every tool call. Opt out: run the local server against a self-hosted FoJin with FOJIN_API_BASE_URL."
      },
      {
       "l": "Sends",
       "v": "an access log line per request and a log line per tool call, with the client address used for rate limiting",
       "sub": "To the hosted server at mcp.fojin.ai; on every request to the hosted server. Opt out: use the local server with uvx fojin-mcp."
      }
     ]
    },
    {
     "t": "prose",
     "text": "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."
    },
    {
     "t": "rows",
     "rows": [
      {
       "l": "In a paid app",
       "v": "With conditions",
       "status": "cond",
       "sub": "The server code is Apache 2.0, but each source text keeps its own license; CBETA texts forbid commercial use.",
       "quote": "Attribution required; commercial use prohibited; derivatives must be shared under the same license and must not alter the substantive content.",
       "src": "https://github.com/xr843/fojin/blob/486bceca994c3b32b3efe69c4675ebbc0fd36565/NOTICE"
      },
      {
       "l": "Pass on its files",
       "v": "With conditions",
       "status": "cond",
       "sub": "The code may be passed on under Apache 2.0 with its NOTICE file; the texts follow their sources' licenses.",
       "quote": "Under Apache-2.0 §4(d) this NOTICE travels with every redistribution of FoJin",
       "src": "https://github.com/xr843/fojin/blob/486bceca994c3b32b3efe69c4675ebbc0fd36565/NOTICE"
      },
      {
       "l": "ai-training",
       "v": "With conditions",
       "status": "cond",
       "sub": "Not covered by FoJin itself; check each source, for example 84000 permits training use, while SuttaCentral asks that its texts not be used in AI applications.",
       "quote": "Users and deployers are responsible for complying with each data source's license when using FoJin.",
       "src": "https://github.com/xr843/fojin/blob/486bceca994c3b32b3efe69c4675ebbc0fd36565/NOTICE"
      }
     ]
    }
   ]
  },
  {
   "id": "alive",
   "nav": null,
   "spy_as": "data",
   "h2": "Is it alive",
   "parts": [
    {
     "t": "rows",
     "rows": [
      {
       "l": "Latest version",
       "v": "0.4.0 in the registry, updated Aug 10, 2026"
      },
      {
       "l": "Last release",
       "v": "fojin-mcp 0.4.0 on PyPI, uploaded 2026-08-10"
      },
      {
       "l": "Remote endpoint",
       "v": "yes",
       "status": "yes"
      }
     ]
    }
   ]
  },
  {
   "id": "alternatives",
   "nav": "Alternatives",
   "h2": "Alternatives",
   "parts": [
    {
     "t": "alts",
     "items": [
      {
       "name": "fojin — Buddhist Canon Tools",
       "me": true,
       "facts": [
        "361 stars",
        "Remote"
       ]
      },
      {
       "name": "Context7",
       "why": "Pick it if you need current documentation for a code library",
       "path": "mcp/servers/io-github-upstash-context7/",
       "facts": [
        "65K stars",
        "Remote",
        "in 1323 projects"
       ]
      },
      {
       "name": "mcp-server-search",
       "why": "Pick it if you need general web search results, not scripture",
       "path": "mcp/servers/io-github-bytedance-mcp-server-search/",
       "facts": [
        "39.6K stars",
        "Local"
       ]
      }
     ],
     "more": "All search and knowledge servers",
     "more_path": "mcp/search/"
    }
   ]
  },
  {
   "id": "start",
   "nav": "Get started",
   "h2": "Get started",
   "parts": [
    {
     "t": "prompt",
     "text": "Add the FoJin MCP server (claude mcp add --transport http fojin https://mcp.fojin.ai/mcp); answer from passages that read_passage returns, cite each with its fojin URN, and run verify_quote on every quoted line."
    },
    {
     "t": "h3",
     "text": "Connect it"
    },
    {
     "t": "tabs",
     "label": "Connect by client",
     "items": [
      {
       "tab": "Claude Code",
       "code": "claude mcp add --transport http fojin https://mcp.fojin.ai/mcp"
      },
      {
       "tab": "Any client (JSON)",
       "code": "{\n  \"mcpServers\": {\n    \"fojin-buddhist-canon-tools\": {\n      \"url\": \"https://mcp.fojin.ai/mcp\"\n    }\n  }\n}"
      }
     ]
    },
    {
     "t": "small",
     "text": "Any client that speaks streamable HTTP can use the hosted address; any stdio client can launch uvx fojin-mcp. FOJIN_API_BASE_URL (optional) points the local server at a self-hosted FoJin."
    },
    {
     "t": "h3",
     "text": "Mistakes to avoid"
    },
    {
     "t": "mistakes",
     "items": [
      {
       "dont": "Letting the assistant quote a sutra from memory",
       "fix": "Quote only the text read_passage returns, then run verify_quote on each quoted line.",
       "why": "Language models routinely invent plausible-looking quotes."
      },
      {
       "dont": "Treating verbatim true as proof that your citation is right",
       "fix": "Read cite_matched; a hit in another fascicle does not confirm the reference you gave.",
       "why": "A real line is often quoted under the wrong text."
      },
      {
       "dont": "Using every parallel get_parallels returns for one passage",
       "fix": "Match the passage against source_chunks[].text and keep the parallels whose aligns_source_chunk equals that chunk_index.",
       "why": "The tool returns parallels for the whole fascicle, often hundreds."
      },
      {
       "dont": "pip install fojin-mcp==0.1.0 with a current mcp package",
       "fix": "Use fojin-mcp 0.2.0 or newer (0.4.0 checked), which needs mcp 2.x.",
       "why": "Version 0.1.0 imported a module that mcp 2.0 removed."
      }
     ]
    }
   ]
  },
  {
   "id": "faq",
   "nav": "Questions",
   "h2": "Questions",
   "parts": [
    {
     "t": "faq",
     "items": [
      {
       "q": "Do I need an account or a key?",
       "a": "No. The hosted server is anonymous and needs no key; it only limits how often each client calls it.",
       "evidence": {
        "url": "https://github.com/xr843/fojin/blob/486bceca994c3b32b3efe69c4675ebbc0fd36565/README.md",
        "quote": "Point any MCP client at the hosted endpoint — nothing to install, no key to get:"
       }
      },
      {
       "q": "Can the assistant change anything in FoJin?",
       "a": "No. All eight tools only read, and the server sends only GET requests to FoJin's public site.",
       "evidence": {
        "url": "https://github.com/xr843/fojin/blob/486bceca994c3b32b3efe69c4675ebbc0fd36565/mcp-server/README.md",
        "quote": "Read-only by construction: it only issues GETs against fojin's public API."
       }
      },
      {
       "q": "Can I use the quoted texts in a paid app?",
       "a": "Not freely. The code is Apache 2.0, but CBETA texts forbid commercial use and 84000 translations are non-commercial with no derivatives.",
       "evidence": {
        "url": "https://github.com/xr843/fojin/blob/486bceca994c3b32b3efe69c4675ebbc0fd36565/NOTICE",
        "quote": "FoJin's Apache 2.0 license applies only to the FoJin source code itself, NOT to the content obtained from these data sources."
       }
      },
      {
       "q": "Can I run it against my own copy of FoJin?",
       "a": "Yes. Set FOJIN_API_BASE_URL to your own instance when you run the local server.",
       "evidence": {
        "url": "https://github.com/xr843/fojin/blob/486bceca994c3b32b3efe69c4675ebbc0fd36565/mcp-server/README.md",
        "quote": "Point it elsewhere (self-host, staging) with an env var"
       }
      }
     ]
    }
   ]
  }
 ],
 "glance": [
  [
   "Registry name",
   "app.fojin/fojin-mcp"
  ],
  [
   "Category",
   "Search and knowledge"
  ],
  [
   "Version",
   "0.4.0"
  ],
  [
   "Remote endpoint",
   "https://mcp.fojin.ai/mcp"
  ],
  [
   "License",
   "Apache-2.0"
  ],
  [
   "GitHub",
   "xr843/fojin"
  ],
  [
   "In the registry since",
   "Aug 10, 2026"
  ],
  [
   "Works with",
   "Claude Code, OpenAI Codex, OpenCode, LangChain, n8n, LangGraph"
  ]
 ],
 "good": [
  "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."
 ],
 "checked_line": "Read by AgentGid from 11 pages and files at one commit, checked Nov 10, 2026; stars update daily.",
 "logo": "https://agentgid.com/media/avatars/xr843.png"
}