Collection of MCP server templates demonstrating tools, prompts, and resources features
This is a template repository with 8 basic tools across multiple template examples. All tools have descriptions and input schemas with proper types and parameter descriptions. However, descriptions are minimal (10-50 chars), lacking context on WHEN to use each tool or what happens on error. No output schemas are documented. Tools lack error handling guidance, recovery hints, or idempotency markers. The 'get-weather' tool has a suspicious implementation (no actual API call visible) suggesting incomplete code. No tool annotations (readOnlyHint, destructiveHint) despite all being marked READ_ONLY. Naming is adequate but generic (calculate-*, format-*, count-*). This is template-grade code, not production-ready.
Add two numbers together
Divide one number by another
Multiply two numbers
Subtract one number from another
Count characters, words, or lines in text
Format text (uppercase, lowercase, capitalize)
Get current weather for a location
Descriptions are too brief (10-50 chars). Rubric baseline is 194 chars. Missing context on WHEN to use each tool, prerequisites, and what happens on error.
No output schemas documented. LLMs cannot plan downstream tool calls or extract required fields without knowing response structure.
No error handling guidance. Tools do not indicate what errors are retryable, user-fixable, or fatal. No recovery hints provided.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | F | 46 | 2026-07-28+ | v2 |
A simple hello world tool
Tool annotations missing. All tools marked READ_ONLY but no readOnlyHint annotation present in schema. Prevents clients from optimizing caching and retry logic.
get-weather tool description is vague ('Get current weather for a location') and implementation is incomplete, no actual API call visible in source code.