MCP server for publishing content to a tiny note-sharing service
Single tool 'publish-to-tiny-server' has a basic description and Zod-based schema, but falls short of production quality. Description is 89 chars (below the 194-char baseline for A+ tools) and lacks context on when/why to use it. Parameter descriptions are minimal (e.g., 'The suffix of the content only allow .md .html .gist or empty' is 67 chars but contains a typo and lacks actionable constraint formatting). No output schema documented. No error handling guidance, the tool returns raw error text without recovery hints. The tool name uses hyphens (publish-to-tiny-server) rather than snake_case convention, and 'publish-to' is less clear than 'publish'. No idempotency guarantees, no rate-limit guidance, no mention of side effects despite being a WRITE operation.
Publish content to a tiny note-sharing server with optional file suffix
Tool name uses hyphens instead of snake_case; 'publish-to' is less action-oriented than 'publish'. Naming convention should be verb_noun (e.g., 'publish_content').
Description is 89 characters (below 194-char baseline). Lacks WHEN to use, prerequisites, and side-effect clarity. Should state: 'Publishes content to a note-sharing server and returns a shareable URL. Supports markdown, HTML, and gist formats. This is a write operation with no undo.'
Parameter 'suffix' description contains typo ('only allow' should be 'only allows') and lacks enum constraint. Should be: 'File suffix: .md (markdown), .html, .gist, or empty string. Defaults to empty.'
No output schema documented. LLM cannot predict return structure. Should document: returns {url: string, key: string} or similar.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | F | 39 | 2026-07-28+ | v2 |
Error handling returns raw error text without recovery guidance. Should return: 'Invalid suffix: got "<value>", must be .md, .html, .gist, or empty.' and 'Network error publishing to note.linkof.link, retry in 30s.'