My MCP server — built from the NyxTools MCP Server Template
Three tools with basic definitions and schemas, but significant gaps in LLM-optimization and parameter documentation. All tools have descriptions (10-50 chars baseline), but descriptions are generic and lack WHEN/HOW guidance per pattern:tool-description. Input schemas present with type info, but parameter descriptions are minimal (5-15 chars). No output schemas documented. No error handling guidance. Tool names are action-oriented (hello, add_numbers, search_items) but lack specificity, 'hello' and 'add_numbers' are trivial utilities, not production patterns. search_items has a reasonable description but lacks pagination guidance despite accepting max_results. No tool annotations (readOnlyHint, idempotentHint). Overall: template-quality, not production-ready.
Add two numbers together. Use when the user needs basic arithmetic.
Say hello to someone. Use this when the user wants to greet someone by name.
Search for items by keyword. Returns up to max_results matching items. Use when the user wants to find something in the collection.
Parameter descriptions are too brief (5-15 chars). LLMs cannot infer meaning from 'The name of the person to greet' alone, need context on format, constraints, and examples.
No output schemas documented. Tools return strings, but LLMs need to know structure: does search_items return JSON, CSV, or plaintext? What fields are in each result?
Tool descriptions lack WHEN/HOW guidance. 'Say hello to someone' does not explain when an LLM should call this vs. other greeting tools, or what the user intent is.
search_items accepts max_results but no pagination guidance. No mention of limit caps, offset/cursor support, or total count in response. Large result sets risk context window exhaustion.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | D | 50 | 2026-07-28+ | v2 |
No error handling or recovery guidance. Tools return strings but no indication of failure modes, retryability, or what the LLM should do if a call fails.