GST Cranes MCP server for public OpenAPI, API documentation, marketplace, and Crane Wiki discovery.
Server defines 5 tools with complete JSON Schema input schemas and tool annotations (readOnlyHint/destructiveHint). All tools have descriptions (10-60 chars, below the 50-200 char optimum). Naming follows verb_noun pattern (list_, get_, ask, handoff, openapi). However, descriptions are terse and lack context on WHEN to use each tool or what downstream actions they enable. Parameter descriptions are minimal (e.g., 'Company slug' for slug param). No output schema documentation visible. Error handling present but generic. Composition is sound, each tool has one responsibility. Missing: guidance on tool selection, dependency hints, and structured output documentation.
Ask a public GST Cranes resource-routing question.
Fetch one public company record by slug.
Create a browser handoff URL for a public GST Cranes surface.
List public Crane Wiki company records.
Return the GST Cranes public OpenAPI URL.
Tool descriptions are terse (10-60 chars) and lack context on WHEN to use each tool or what it returns. LLMs need 50-200 char descriptions explaining purpose, use case, and output structure.
No output schema documentation. LLMs cannot plan downstream calls or extract required fields (e.g., company_id, slug) without knowing response structure. Document what each tool returns.
Parameter descriptions are minimal or missing context. E.g., 'Company slug' does not explain format, length, or how to obtain it. 'Public resource question' does not clarify what types of questions are supported.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | D | 56 | 2026-07-28+ | v2 |
gstcranes.ask has ambiguous purpose. 'Ask a public GST Cranes resource-routing question' does not clarify what 'resource-routing' means or when to use this vs list_companies or get_company.
No pagination guidance for list_companies. If results exceed limit, does the tool return a cursor? How should agents handle large result sets? Baseline pattern requires pagination documentation.