MCP server - Polish administrative court rulings (NSA + WSA) via CBOSA (orzeczenia.nsa.gov.pl)
Three tools with clear verb-noun naming (search, get_judgment, search_by_case) and reasonable descriptions (80-120 chars). All tools have input schemas with typed parameters and descriptions. However, output schemas are not documented in the source code, the tool definitions show inputs but no explicit return type documentation. Parameter descriptions are adequate but lack format constraints (e.g., date format YYYY-MM-DD is mentioned but not enforced via schema pattern). Error handling is present (HTTP errors caught) but lacks recovery guidance for LLMs. No tool annotations (readOnlyHint, etc.) despite all three being read-only operations.
Retrieve full text of a Polish administrative court ruling by CBOSA document ID (10-character hex)
Search Polish administrative court rulings by keywords, case number, date, or court
Search for a Polish administrative court ruling by exact case number (e.g. 'III OSK 1377/23')
Output schemas not documented. Tool definitions show input parameters but no explicit return type, field structure, or pagination metadata. LLMs cannot plan downstream calls or extract required fields.
No tool annotations despite all three tools being read-only. Missing readOnlyHint annotation prevents LLMs from optimizing retry logic and understanding safety guarantees.
Error responses lack recovery guidance. HTTP errors (e.g., 'HTTP 404 Not Found') are caught but not translated into actionable LLM guidance (e.g., 'Document not found. Try search() with keywords instead.').
Date format constraint (YYYY-MM-DD) documented in description but not enforced via JSON Schema pattern. LLMs may pass invalid formats; validation happens at runtime.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | C | 61 | 2025-06-18+ | v2 |
search tool lacks pagination documentation. No mention of result limits, page size constraints, or total count in response. Large result sets could exhaust context window.