MCP server providing access to Ellen G. White (EGW) writings with local database support, API integration, and PDF generation capabilities
Server provides 13 read-only tools with complete JSON schemas and basic descriptions. All tools have proper input schemas with types and descriptions, meeting baseline requirements. However, descriptions are generic and lack LLM-optimized guidance on when/why to use each tool. No output schemas documented. Error handling is minimal. Tool naming is clear and verb-based (search_, get_, list_, browse_), following conventions well. Parameter descriptions exist but lack constraints (enums, ranges, formats). No tool annotations (readOnlyHint, idempotentHint) despite all being read-only. Missing composition guidance for multi-step workflows.
Find content by EGW reference (e.g., "AA 15.1", "GC 123")
Get chapter content from a book
Get detailed information about a specific book
Get surrounding paragraphs for better context
Get statistics about the local database
Get book information from local database
Get paragraphs from a book in the local database
No output schemas documented. LLMs cannot plan downstream calls or extract required fields without knowing response structure. All 13 tools lack documented return types.
Descriptions lack LLM-optimized guidance. Generic descriptions like 'Get detailed information about a specific book' do not explain WHEN to use this tool vs alternatives (e.g., get_book_details vs get_book_content vs get_local_book). Average description length ~60 chars; baseline is 194 chars.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | D | 55 | 2026-07-28+ | v2 |
Get search suggestions for a partial query
List books in a specific language and category
Get available languages for EGW writings
List books available in local database
Search locally indexed EGW writings with full-text search
Search Ellen G. White writings and Adventist literature
No tool annotations despite all tools being read-only. Missing readOnlyHint, idempotentHint metadata that would help agents understand safety and retry semantics.
Parameter descriptions lack constraints. 'limit' and 'offset' parameters have no min/max bounds; 'language' has no enum of valid codes; 'reference' format (e.g., 'AA 15.1') is not formally specified. LLMs cannot validate inputs without explicit constraints.
Duplicate/overlapping tools create LLM confusion. search_writings vs search_local, get_book_details vs get_local_book, get_book_content vs get_local_content. No guidance on which to use when (API vs local database). Agents waste reasoning cycles deciding between similar tools.