Bible data parser and API with MCP server integration for accessing Bible translations, passages, quotes, and daily verses
Four tools with basic schemas and descriptions, but significant gaps in parameter documentation and error handling. Tool names follow verb_noun convention (getDailyVerse, generateBooks). Descriptions exist but are generic (10-150 chars, below the 194-char baseline). Input schemas present but lack comprehensive parameter descriptions, most params have minimal guidance. No output schemas documented. Admin tools expose systemToken as a parameter, violating secret-injection pattern. No error recovery guidance. Composition is reasonable (single responsibility per tool), but parameter constraints and validation rules are absent.
Admin endpoint to generate and store books data for all translations. Requires system token as query parameter. Processes all translations and generates their books data.
Admin endpoint to generate and store books data for a translation. Requires system token as query parameter. Generates and stores books data (chapter/verse structure) for a specific Bible translation.
Retrieve the daily verse for a specific date with its text in the requested translation. Required Parameters: bibleTranslationSlug: Translation identifier (e.g., "vdcc"). Optional Parameters: date: Date for the daily verse (YYYY-MM-DD). Defaults to today if not provided.
Retrieve daily verses for a date range with their text in the requested translation. Required Parameters: bibleTranslationSlug: Translation identifier (e.g., "vdcc"), startDate: Start date for range query (YYYY-MM-DD), endDate: End date for range query (YYYY-MM-DD). Returns array of daily verses with dates, references, and verse text.
systemToken exposed as tool parameter in generateBooks and generateAllBooks. Secrets must never appear in tool parameters; use server-side injection via environment variables.
No output schemas documented for any tool. LLMs cannot plan downstream calls or extract required fields without knowing response structure.
Parameter descriptions are minimal or missing context. 'bibleTranslationSlug' lacks guidance on valid values or how to discover them. 'date' format is stated but no validation rules for out-of-range dates.
No error handling or recovery guidance. Tools lack descriptions of failure modes (invalid date, unknown translation, auth failure) and what the LLM should do next.
Inferred effective spec: <=2025-11-25.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | D | 53 | <=2025-11-25 | v2 |
Admin tools (generateBooks, generateAllBooks) lack permission gates and audit trail documentation. No indication of who can call them or what side effects occur.