Sri Guru Granth Sahib Ji in AI-ready Markdown: verified corpus, static site, citation-first verifier, and MCP server.
Three read-only tools with clear, domain-specific descriptions (avg 156 chars). All tools have proper verb-noun naming (search_*, read_*) and documented input schemas with types. However, output schemas are not explicitly documented in the source code, only inferred from descriptions. Parameter descriptions are present but minimal. No error handling guidance, no pagination support despite potential for large result sets, and no tool annotations (readOnlyHint despite all being read-only). Schemas are visible and typed, placing this in the fair-to-good range, but missing production-grade output documentation and error recovery patterns.
Read a complete ang (page) from the Sri Guru Granth Sahib Ji by its page number. Returns all verses on that page with Gurmukhi, transliteration, and English translation.
Search the Sri Guru Granth Sahib Ji corpus by English translation text. Returns matching verses with their ang (page) numbers, transliteration, and English translation.
Search the Sri Guru Granth Sahib Ji corpus by Roman transliteration. Supports normalization aliases and compound aliases from the search-normalization.json table. Returns matching verses with ang numbers, Gurmukhi, transliteration, and English translation.
Output schemas not documented. Descriptions mention return fields (verses, ang numbers, transliteration, English translation) but no formal schema definition visible in source code. LLMs cannot plan downstream operations without knowing exact response structure.
No pagination or result limiting documented. search_* tools may return hundreds of matching verses; no limit, offset, or cursor parameters visible. Large result sets will exhaust context windows and degrade LLM reasoning.
No tool annotations despite all tools being read-only. readOnlyHint should be set to true for all three tools to signal to agents that these are safe, non-destructive operations.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | D | 50 | 2026-07-28+ | v2 |
No error handling guidance. If a search returns no results, or if read_ang receives an invalid page number (outside 1-1430), no recovery hints provided. Descriptions mention constraints but no error messages documented.
Parameter descriptions are minimal (under 50 chars each). 'English text to search for in translations' and 'Roman transliteration text to search for' lack guidance on format, length limits, or special character handling. LLMs may pass malformed queries.