MCP Server Registry Service - a monorepo workspace containing registry, auth-server, workflow-worker, and shared packages for managing MCP servers, authentication, and workflows
Three tools with basic schemas and descriptions, but significant gaps in parameter documentation and output schema clarity. execute_tool accepts generic 'arguments' object with no structure guidance. Descriptions are present but minimal (50-80 chars, below the 194-char baseline). No error handling guidance, no parameter constraints (enums, ranges), and no output schema documentation. Tool names are action-verb based (execute_, read_) which is good, but the proxy pattern obscures what each tool actually does on the target server.
Execute or get an MCP prompt from a server
Execute a discovered tool on an MCP server
Read an MCP resource from a server
Generic 'arguments' parameter lacks structure. All three tools accept an untyped object dict with no schema, constraints, or guidance on what keys/values are valid. LLMs cannot infer required vs optional fields or validate input before calling.
No output schema documentation. Tool descriptions do not specify what fields are returned, their types, or structure. LLMs cannot plan downstream operations or extract required data (e.g., does execute_tool return result, status, error, metadata?).
Descriptions are minimal (45-50 chars vs 194-char baseline). 'Execute a discovered tool on an MCP server' lacks context on when to use it, what it returns, or how it differs from direct MCP calls. No dependency hints or prerequisites stated.
Inferred effective spec: <=2025-11-25.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | D | 56 | <=2025-11-25 | v2 |
No error handling guidance. Descriptions do not explain what errors are possible (invalid server_id, tool not found, execution timeout) or how the LLM should recover. No actionable error messages specified.
Parameter descriptions are generic. 'Arguments to pass to the tool' does not explain format, required keys, or validation rules. 'The URI of the resource' lacks format guidance (is it 'scheme://path' or 'scheme:path'?).