shippo-mcp

Agent readability score

Strengths

• submit_feedback tool has a clear purpose for reporting documentation issues.

Weaknesses

• Tool names are overly verbose and not intuitive for quick selection.
• First two tools have overlapping documentation-query functions, creating ambiguity.
• Descriptions are incomplete (e.g., second tool's description cuts off mid-sentence).
• No explicit error handling or parameter constraints documented.

• search_shippo_api_documentation — Overly verbose name with redundant 'Shippo API Documentation' repetition
• query_docs_filesystem_shippo_api_documentation — Description truncated mid-sentence, making purpose unclear
• query_docs_filesystem_shippo_api_documentation — Functionally overlaps with search_shippo_api_documentation tool

Verdict

The tools suffer from poor naming conventions, functional overlap between documentation tools, and incomplete documentation. The truncated description for the filesystem query tool creates significant ambiguity for an agent trying to select the correct tool.

9/11/2026, 12:01:05 PM

Event narrative

Server transitioned to 'dual' era with compliance score rising from null to 100.

Risk: medium

• 2026-09-10T21:16:35.016Z — era changed from 'auth-gated' to 'dual' · enabled new operational mode
• —
• —
• —
• —
• —
• —
• —

Advice

Monitor dual-era performance metrics. Smoke tests remain pending (smokeOk:null). Maintain compliance score above 100.