MCP server for Joomil.ch — Swiss classifieds marketplace. Exposes read-only tools for searching listings, retrieving classified details, browsing categories, filtering by canton, and inferring search filters from natural language queries.
Server has well-structured tool definitions with clear naming (verb_noun pattern), comprehensive parameter schemas with types and descriptions, and thoughtful output schemas. All 5 tools follow consistent patterns. However, descriptions are somewhat generic and lack LLM-optimized guidance on when/why to use each tool. Error handling is present but minimal. Parameter descriptions could be more actionable with examples of valid values and constraints. The suggest_filters tool lacks output schema documentation.
List supported canton filter values. Returns the exact canton names and codes accepted by the search API.
List categories optionally filtered by parent category. Returns available categories for browsing and filtering listings.
Get a single listing by ID. Returns detailed information about a specific classified advertisement.
Search listings with filters. Supports filtering by query, category, canton, location, price range, and sorting options.
Infer search filters from a natural-language query. Parses user input and suggests appropriate search parameters including category, canton, price range, and sort order.
suggest_filters lacks documented output schema. Code shows it parses natural language but returns type is not specified in tool definition.
Descriptions are functional but lack LLM-optimized guidance. Missing context on WHEN to use each tool vs alternatives (e.g., when to call suggest_filters vs search_classifieds directly).
Parameter descriptions lack actionable constraints. E.g., 'sort' enum is documented but no guidance on default behavior or when each sort order is useful. 'limit' has no min/max bounds stated.
Error handling returns JSON error objects but lacks recovery guidance. JoomilApiError includes status/URL but no suggestion for what the LLM should do next (retry, try different params, etc.).
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | C | 64 | 2025-06-18+ | v2 |
Canton parameter accepts enum but code comment warns that accented forms (Genève, Neuchâtel) are silently ignored by upstream API. LLM may still attempt these despite enum constraint.