CordFind generator guide search, connector compatibility, and cord-size planning as an MCP server.
Three tools with complete schemas and descriptions. All parameters have types and descriptions. Tool names follow verb_noun pattern (search_, get_, calculate_). Descriptions are adequate (100-200 chars) but lack actionable context for LLM selection. Enum constraints are well-applied. No output schema documentation visible. Error handling delegates to remote service without recovery guidance. Missing dependency hints and parameter relationship documentation.
Compare common American Wire Gauge sizes using load current, voltage, one-way distance, and a voltage-drop planning limit.
Screen a generator outlet, destination, and cord distance for direct compatibility, adapter needs, verification boundaries, or unsafe paths.
Search CordFind for generator cords, plugs, sizing, transfer equipment, maintenance, and safety guidance. Results include direct CordFind source URLs.
No output schema documentation. LLMs cannot predict response structure or plan downstream operations. Tool descriptions mention 'Results include...' but no formal schema is provided.
Error handling lacks recovery guidance. safeRemoteTool() catches errors and returns generic message 'Try the hosted server directly', does not tell LLM what to do next or how to self-correct.
Descriptions lack WHEN-to-use context. 'Search CordFind for...' states WHAT but not WHEN to call this vs alternatives or what prerequisites exist. LLMs need explicit selection guidance.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | B | 70 | 2026-07-28+ | v2 |
Parameter relationships undocumented. calculate_generator_cord_size has interdependent params (amps, volts, distanceFeet affect valid AWG output) but no description hints about dependencies or constraints.
Remote tool delegation obscures actual behavior. Tools call a remote CordFind API; local schema validation passes, but remote API may reject or return unexpected results. No fallback or partial-result handling.