MCP server for interacting with Bazos.cz, Bazos.sk, Bazos.at, and Bazos.pl
Three tools with complete input schemas and descriptions. Naming follows verb_noun convention (search_ads, get_ad_detail, get_user_ratings). Descriptions are adequate (50-100 chars) but lack actionable context for LLM selection. All parameters have type definitions and descriptions. However, output schemas are not documented, LLMs cannot predict response structure. Error handling is minimal (only domain validation shown). No guidance on when to use each tool vs alternatives. Parameter relationships (e.g., latitude/longitude required only when sort='distance') are documented but could be clearer.
Get detailed information about a specific ad by its ID.
Get user ratings by phone ID and/or email ID.
Search ads on Bazos.cz, Bazos.sk, Bazos.at, or Bazos.pl. Returns a list of ads matching the criteria.
Output schemas not documented. LLMs cannot predict response structure (fields, types, pagination format). Agents cannot plan downstream calls or extract required data.
Descriptions lack actionable context. 'Search ads on Bazos.cz...' does not explain WHEN to use this vs get_ad_detail, or what the response contains. LLMs cannot distinguish between similar tools.
Conditional parameter dependencies not clearly enforced. 'latitude/longitude required when sort is distance' is documented but no validation shown. LLMs may omit these and receive silent failures.
Error handling minimal. Only domain validation shown; no guidance on invalid section, sort, offset/limit, or API failures. LLMs receive no recovery hints.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | D | 54 | 2026-07-28+ | v2 |
Pagination parameters (offset, limit) lack explicit constraints in descriptions. 'Must be multiple of 20' and 'up to 200' are stated but no min/max bounds or validation logic visible.