Search for local businesses worldwide via the discava API. 49 countries, 8 languages, millions of businesses.
Server has well-structured tool definitions with complete schemas and descriptions. All 6 tools use Zod for input validation with proper types. Descriptions are clear and action-oriented (avg ~120 chars). However, output schemas are not documented, responses are returned as raw JSON without specifying expected fields. Error handling is minimal (generic API errors). Tool composition is sound: search_businesses → get_business follows a logical chain. No security issues detected (no secrets in params). Main gaps: missing output schema documentation, no error recovery guidance, no pagination metadata in search results despite potentially large result sets.
Get full details for one or more businesses: address, phone, website, opening hours, services, payment methods, social links, logo, business image, coordinates. Pass comma-separated IDs for batch.
Get top businesses by demand score.
Check if the discava API is online.
Search for local businesses. Returns name, category, city, country, logo_url, available_details (what data exists), and scores. Check available_details to see what is available, then call get_business for full details.
Report data quality issues for a business.
Autocomplete for cities or categories/business names.
Output schemas not documented. Responses are returned as raw JSON without specifying expected fields, field types, or structure. LLMs cannot plan downstream tool calls or extract data reliably.
Error handling is generic. API errors return raw HTTP status + body without actionable recovery guidance. LLM cannot determine if error is retryable, user-fixable, or fatal.
search_businesses accepts limit (1-50) but no pagination metadata returned. Large result sets may exceed context window. No next_cursor or total_count in response.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | C | 63 | 2026-07-28+ | v2 |
send_feedback description lacks clarity on what constitutes success. Does it return confirmation? Error details? Side effects are not documented.
get_business accepts comma-separated IDs for batch but no documentation on per-item success/failure handling. If one ID is invalid, does entire batch fail?