MCP server that exposes Neo4j Aura API endpoints as tools and resources via OpenAPI specification
Two tools with minimal definitions. Both have short descriptions (34-40 chars, below the 50-200 char baseline for LLM-optimized descriptions). Input schemas are present but extremely sparse, only 'id' parameter with basic string type, no constraints, enums, or validation guidance. No output schemas documented. No error handling guidance. Tools are read-only but lack explicit idempotentHint annotations. Naming is acceptable (get_instances, get_tenants) but descriptions fail to explain WHEN to use each tool or what distinguishes them.
Retrieve instance details from Neo4j Aura API
Retrieve tenant details from Neo4j Aura API
Descriptions are too short (34-40 chars vs. baseline 50-200). They lack WHEN/WHY context. 'Retrieve instance details from Neo4j Aura API' does not explain when to call this vs. get_tenants, what fields are returned, or what the user needs to know.
Input schemas lack constraints, enums, or validation guidance. The 'id' parameter has no description of format (UUID? alphanumeric? length bounds?), no examples, and no guidance on how to obtain a valid ID.
No output schemas documented. LLMs cannot plan downstream calls or extract required fields without knowing what get_instances or get_tenants returns. This violates the pattern requirement that 100% of A+ tools have documented return types.
Inferred effective spec: <=2025-11-25.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | F | 36 | <=2025-11-25 | v2 |
No error handling guidance. If an invalid instance ID is passed, what error is returned? Can the agent retry? Should it search for valid IDs first? No recovery path is documented.
Tools are read-only but lack explicit idempotentHint annotations in the schema. This prevents agents from confidently retrying on transient failures.