Troubleshooting
| Symptom | Likely cause | What to try |
|---|---|---|
| Tool isn't listed | Client not initialized, wrong server URL or stale server schema | Connect to https://mcp.evendo.com/mcp and rerun tools/list |
place_score_gte rejected by MCP |
MCP uses a different argument name than GraphQL | Use min_place_score in MCP; place_score_gte / place_score_lte are GraphQL arguments |
| City name resolves ambiguously | Multiple places share a name | Supply place_type, country_code; inspect candidates |
| Keyword search returns weak matches | City in the keyword, typo or overly broad query | Resolve place first; use within_place_id and short terms |
find_venues returns few neighbourhood results |
Narrow geographic subtree | Widen to the parent city, preserving user intent |
| Filtered search returns no results | Exact value mismatch or too many AND-array tags | Check enum case and remove nonessential tags |
| Nearby search has wrong results | Coordinates/radius or sort mode mismatch | Use verified location coordinates; check radius 0.1–50 km |
| Pagination repeats or fails | Cursor reused with changed arguments | Start a fresh query after any filter/sort change |
| Rate limit response | Too many requests | Back off and retry; respect Retry-After if present; 200/min currently applies to MCP |
| GraphQL syntax error | Incorrect argument type or unverified schema | Compare the query with the full schema or introspect the endpoint |
| Unsafe HTML display | Raw descriptions inserted into markup | Sanitize HTML and escape untrusted values |
How to debug consistently
Record the interface (MCP or GraphQL), tool/query name, non-sensitive request arguments, time, response status, and relevant error body. Avoid logging unrelated personal information. Include these details when you contact Evendo support (see Support in the footer).