OpenAPI to MCP adapter that converts OpenAPI specifications into MCP-compatible tools and exposes them via Server-Sent Events (SSE) over HTTP
Single tool 'dynamic_openapi_tools' has critical definition gaps. Tool name lacks action verb (should be 'call_openapi_endpoint' or similar). Description is generic and does not explain WHEN to use this tool or what it returns. Input schema properties ('pathNames', 'searchParams', 'requestBody', 'headers') lack individual descriptions, LLMs cannot infer parameter meaning from names alone. No output schema documented. No error handling guidance. Tool definition appears inferred from adapter code rather than explicitly registered with full metadata. Violates 6+ core patterns from the rubric.
Dynamically generated tools from OpenAPI specifications. Each endpoint in the OpenAPI spec becomes a tool with parameters extracted from path, query, header, and request body definitions.
Tool name 'dynamic_openapi_tools' lacks action verb. Should start with verb (e.g., 'call_', 'invoke_', 'execute_') to signal intent to LLM. Current name is a noun phrase, not an action.
Tool description is generic ('Dynamically generated tools from OpenAPI...') and does not explain WHEN to use this tool, what it returns, or how it differs from calling APIs directly. LLMs cannot determine tool selection without actionable context.
Input schema properties lack descriptions. 'pathNames', 'searchParams', 'requestBody', 'headers' are all type 'object' with only brief descriptions. LLMs cannot infer what values to pass or how to structure nested objects without per-property documentation.
No output schema documented. Tool returns are not specified, LLMs cannot plan downstream calls or extract required fields (e.g., response status, body, headers). Violates response-shaper pattern.
Inferred effective spec: <=2025-11-25.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | F | 26 | <=2025-11-25 | v2 |
No error handling guidance. Tool does not document what errors can occur (network failure, invalid OpenAPI spec, malformed request) or how LLM should recover. Violates recovery-guide pattern.