MCP server for beck-online.beck.de — German legal database
Three tools with complete input schemas and descriptions. Naming follows verb_noun pattern (beck_search, beck_get_document, beck_get_toc). Descriptions are adequate (100-150 chars) but lack actionable guidance on when to use each tool or dependencies between them. Parameters are typed with enums where appropriate (documentType, legalArea, sort), but descriptions are minimal (10-30 chars). Output schemas are not documented, LLMs cannot predict response structure. No error handling guidance visible. No tool annotations (readOnlyHint, etc.). Composition is sound: three single-purpose tools with clear separation. Missing: pagination guidance, response field documentation, error recovery hints.
Retrieve the full content of a specific document from beck-online by its vpath. Use beck_search first to find vpaths.
Get the table of contents / navigation tree for a beck-online commentary or handbook. Use this to discover available sections before retrieving specific documents.
Search the beck-online German legal database. Returns a list of matching documents (commentaries, laws, court decisions, articles). Use documentType to filter by category.
Output schemas not documented. LLMs cannot predict response structure (fields, types, pagination). Forces trial-and-error tool use.
Parameter descriptions are too brief (10-30 chars). 'Filter by document type' lacks context on what each enum value means (ges=laws, buch=commentaries, etc.). LLMs cannot infer meaning.
No tool-chaining guidance. beck_search returns vpaths; beck_get_document accepts vpath. This dependency is not documented. LLMs may not realize they must call search first.
No error handling guidance. No recovery hints (e.g., 'If document not found, try a broader search'). Agents cannot self-correct on failures.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | D | 53 | 2026-07-28+ | v2 |
No tool annotations (readOnlyHint). All three tools are read-only; marking them as such helps agents reason about safety and retry logic.