Discovery & Onboarding Gates


MCP Server & UI Tiers

Gate 1 Static Policy Linter & MCP Streamable HTTP Workbench

Every tool exposed by tools/list on POST /mcp must satisfy Gate 1 static policy requirements and support stateless or auto-rehydrating Mcp-Session-Id headers across horizontally scaled instances.

Mandatory ToolAnnotations & String-Typed 64-Bit Identifiers

  1. Every tool must explicitly declare boolean values for all four behavioral hints inside annotations: readOnlyHint, destructiveHint, idempotentHint, and openWorldHint.
  2. Any 10+ digit identifier (item_id, reservation_id) must use type: "string" ("984729104829") in inputSchema rather than integer or number to prevent IEEE 754 float64 precision loss above $2^{53} - 1$.

Interactive Linter & JSON-RPC 2.0 Workbench

1. Gate 1 Static Policy Linter (tools/list Audit)

Run the static policy linter against either the compliant 6-tool exemplar manifest or an intentionally broken tool manifest to inspect validation findings for verb_noun naming, self-contained descriptions, mandatory ToolAnnotations, and 64-bit string ID schemas.

2. Live MCP Streamable HTTP JSON-RPC 2.0 Dispatcher (POST /mcp)

Dispatch live JSON-RPC 2.0 calls (initialize, tools/list, tools/call, resources/list, resources/read) to POST /mcp. For user-authenticated tools (get_user_reservations, create_reservation, update_reservation_notes, cancel_reservation), click Mint Demo User Bearer Token first or test unauthenticated 401 WWW-Authenticate discovery challenges.

3. Error Code (-32300..-32500) & Stateless Session Failover Simulator

Test structured JSON-RPC error codes (-32300 USER_RATE_LIMITED, -32301 MISSING_REQUIRED_INFORMATION, -32302 USER_PERMISSION_DENIED, -32400 RUNTIME_ERROR, -32500 DEADLINE_EXCEEDED, or isError: true) via simulate_error_condition, and test serverless instance failover by sending an arbitrary Mcp-Session-Id header.