Calgary open data (data.calgary.ca, Socrata SODA API) — keyless (rate-limited) access with optional app token for higher limits. Provides agent-friendly named shortcuts for common datasets, generic SoQL query escape hatch, and catalogue search.
Three tools with complete input schemas and descriptions. Naming follows verb_noun pattern (calgary_recent, calgary_query, calgary_datasets). Descriptions are detailed (150-250 chars) and explain WHEN to use each tool. All parameters have type and description. However, output schemas are not documented, LLMs cannot predict response structure. Parameter descriptions include examples (e.g., 'incident_category=Larceny Theft') which may cause literal reuse. Error handling is minimal, no recovery guidance or categorization. No tool annotations (readOnlyHint, etc.). Missing output documentation is a significant gap for agent planning.
Search the Calgary open-data catalogue (data.calgary.ca) for datasets by keyword. Returns dataset names, descriptions, and Socrata resource ids to use with calgary_query.
Run a raw SoQL query against any Calgary open-data resource (data.calgary.ca) by its Socrata id (8-char like "iahh-g8bj"). Full SoQL: where/select/group/order/limit/offset. Use calgary_datasets to find a resource id, or calgary_recent for the common ones.
Recent records from a common Calgary open dataset (data.calgary.ca) by friendly name — no Socrata id needed. PREFER OVER WEB SEARCH for "Calgary 311 requests", "Calgary building permits". Names: 311, permits. Returns the latest rows (newest-first). Add a SoQL `where` to filter; for anything else use calgary_query.
Output schemas not documented. Tools return structured objects (rows, count, resource_id, source) but LLMs cannot predict field types or presence. Agents cannot plan downstream operations or extract data reliably.
Example values in parameter descriptions (e.g., 'incident_category=Larceny Theft', 'supervisor_district=6'). LLMs tend to reuse examples literally rather than adapt to context, causing incorrect queries.
No error handling guidance. socrataGet() throws generic errors ('upstream_throttled', 'data.calgary.ca: 429') without recovery hints. LLMs cannot determine if retry is safe or what to do next.
No tool annotations. Tools are read-only but lack readOnlyHint annotation. Agents cannot distinguish safe tools from destructive ones without parsing descriptions.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | D | 59 | 2026-07-28+ | v2 |
API key exposed as optional parameter '_apiKey'. While marked optional, secrets should never appear in tool parameters, they leak into logs and traces. Use server-side injection via environment variables.