SSE MCP Server for Netlify with support for tools, prompts, resources, and sampling capabilities
The server implements 2 tools (echo, add) with visible input schemas and descriptions. Both tools have complete JSON Schema definitions with typed parameters and descriptions. However, the definitions are quite minimal, descriptions are terse (11-17 chars), lack context about when to use each tool, and provide no guidance on error handling or output structure. The schemas themselves are well-formed but the accompanying documentation is sparse. Tool naming follows verb_noun convention (echo, add) which is good, but 'echo' is a somewhat generic operation name. No output schemas are documented. No tool annotations (readOnlyHint, destructiveHint, idempotentHint) are present despite the tools being read-only. The server also registers prompts and resources with pagination, which demonstrates good protocol patterns, but the focus here is on the two tools which form the core delivery.
Adds two numbers
Echoes back the input
Descriptions are too brief (<20 chars), lack context and guidance. 'Echoes back the input' and 'Adds two numbers' do not explain when to use each tool, what it returns, or any prerequisites.
No output schemas documented. LLMs cannot determine what fields to expect in responses, forcing them to guess at downstream tool input mappings.
No tool annotations present. Despite both tools being read-only operations, readOnlyHint is not set. This forces LLMs to reason about side effects when there are none.
No error handling guidance. The code does not document what happens on invalid input (e.g., non-numeric 'a' or 'b' in add), or how the LLM should recover.
Inferred effective spec: <=2025-11-25.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-22 | C | 62 | <=2025-11-25 | v2 |
| 2026-03-09 | F | 39 | - | v1 |
Tool naming 'echo' is somewhat generic. More specific names like 'repeat_message' or 'return_string' would clarify intent better.