hn
[ tools: 4 ][ checks: 11 ][ latency: 6ms ]
82/100(B)
uvx mcp-hn
check breakdown
✓Tools exposed — Server exposed 4 tools.
• get_stories
• get_user_info
• search_stories
• get_story_info
✓Input schemas valid — All tools have a valid JSON-Schema input definition.
!Input schema quality — 6 schema-quality issue(s) across 4 tool(s).
get_stories: no "required" array (which params are mandatory?)
get_stories: inputSchema.additionalProperties is not set to false (extra args pass through silently)
get_user_info: inputSchema.additionalProperties is not set to false (extra args pass through silently)
search_stories: inputSchema.additionalProperties is not set to false (extra args pass through silently)
get_story_info: no "required" array (which params are mandatory?)
get_story_info: inputSchema.additionalProperties is not set to false (extra args pass through silently)
→ Declare `required` for every schema that has properties, so agents know which params are mandatory.
→ Give every property a `description` and a concrete `type` (avoid bare `{}` placeholders).
→ Set `additionalProperties: false` on the top-level inputSchema so models can't silently pass extra, unvalidated arguments.
!Output schemas — No tools declare an outputSchema.
→ Optional: declare outputSchema for tools with structured results so agents can validate/parse output reliably.
✓Duplicate tool names — All tool names are unique.
✓Tool naming — All tool names use spec-legal characters.
!Descriptions — 1 description issue(s) found.
get_story_info.story_id: parameter description very short ("Story ID")
→ Descriptions are the model's only guide to when/how to call a tool — treat them as prompt engineering.
→ Describe every tool and every parameter, including units, formats, and constraints.
→ Each tool's description should say something the name doesn't, and should be unique to that tool.
!Tool annotations — Annotation coverage 0% (0/20 hint fields set).
• get_stories: no annotations at all
• get_user_info: no annotations at all
• search_stories: no annotations at all
• get_story_info: no annotations at all
→ Add annotations: title, readOnlyHint, destructiveHint, idempotentHint, openWorldHint.
→ These let clients gate risky calls and give agents/users a friendly display name — optional but valuable.
!Tool titles — 4 of 4 tool(s) have no title.
• get_stories: no top-level title (or annotations.title)
• get_user_info: no top-level title (or annotations.title)
• search_stories: no top-level title (or annotations.title)
• get_story_info: no top-level title (or annotations.title)
→ Declare a top-level `title` on each tool — it gives clients a friendly display name distinct from the machine-readable `name`.
→ `annotations.title` (the older location) is also accepted, but the top-level `title` field is now the spec-preferred place for it.
!Server instructions — No top-level instructions declared.
→ Declare instructions to guide agents on when/how to use this server.
→ Return a non-empty `instructions` string in your InitializeResult — most SDKs let you set this alongside serverInfo.
✓Handshake + list latency — tools/list responded in 6ms.
add the badge
Paste into your README:
[](https://scoremcp.dev/servers/mcp-hn)