A demonstration MCP server implementing a streamable-HTTP transport with tenant isolation, document management, and approval-based write operations.
Two tools with basic schemas and minimal descriptions. documents.list has a well-formed input schema with tenant_id pattern constraint (^tenant-[a-z]+$), but description is generic (34 chars, below 50-char baseline). documents.archive lacks input schema visibility in source, only parameter names inferred from code logic (tenant_id, document_id, approval), no type definitions or descriptions visible. Both tools lack output schema documentation. No parameter descriptions provided for any input. Error handling is present in server logic (403 for tenant boundary, 422 for schema rejection) but not surfaced in tool definitions. No tool annotations (readOnlyHint, destructiveHint, idempotentHint) despite clear read/write distinction.
Archive a synthetic document after explicit local approval.
List safe synthetic documents for the authenticated tenant.
documents.archive has no visible input schema in source code, only parameter names inferred from server.mjs logic. Cannot verify type definitions, constraints, or descriptions.
documents.archive has no description in tool definition. Server logic shows it archives documents after approval, but this intent is not declared in the tool metadata.
No parameter descriptions for any input across both tools. LLMs cannot infer what tenant_id, document_id, or approval parameters control. Baseline: 100% of A+ tools have parameter descriptions.
No output schema documented for either tool. LLMs cannot plan downstream calls or extract required fields. documents.list returns {items: [...]}, documents.archive returns {archived, reviewed, document_id}, but these are not declared in tool metadata.
Inferred effective spec: <=2025-11-25.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | F | 47 | <=2025-11-25 | v2 |
No tool annotations despite clear risk profile. documents.list is READ_ONLY (should have readOnlyHint: true), documents.archive is WRITE and requires approval (should have destructiveHint: true). Annotations guide agent safety reasoning.