Protocol conformance

Copy Markdown View Source

This matrix describes OzMcp 0.9.0 against the Model Context Protocol specification, revision 2025-11-25. It is the only revision that the server supports.

Legend: โœ… implemented ยท ๐ŸŸก partially implemented ยท โŒ not implemented

Checked by

The CI checks the server from the outside on each build:

  • The official conformance tool, @modelcontextprotocol/conformance 0.1.16 (server scenarios). One scenario is expected to fail: server-sse-multiple-streams. It sends the header MCP-Protocol-Version: 2025-03-26 and the server answers 400, as the transport specification requires for a version that the server does not support. The list of expected failures is in test/conformance/expected_failures.yml.
  • The official TypeScript SDK client, @modelcontextprotocol/sdk 1.32.2, over HTTP and stdio (mix test.sdk).

Base protocol

  • โœ… JSON-RPC 2.0 requests, notifications and responses, with a check of the envelope
  • โœ… Request ids: strings and integers of any size; null, float, boolean and object ids are refused with -32600
  • โœ… A request id is unique while its request runs; a duplicate gets -32600
  • โœ… Batches refused (-32600 "batching is not supported"), on HTTP and stdio
  • โœ… Parse errors: text that is not JSON, invalid UTF-8, a lone surrogate, text after the object, a number over 100 characters, 1e400 all give -32700
  • โœ… params must be an object; null counts as absent
  • โœ… A method that exists only as a notification is refused as a request (-32601); an unknown notification is ignored
  • ๐ŸŸก _meta: the type is checked on a message of the client (an object, a string or integer progressToken); the key format and the reserved prefixes are checked on what the server declares, not on what the client sends
  • โœ… Standard error codes, plus -32002 (resource not found) and -32042 (URL elicitation required)
  • โœ… Every response carries its id, also when the callback raises or returns a wrong shape (-32603)
  • โœ… Icons, title, description and websiteUrl where the specification puts them
  • โœ… JSON Schema 2020-12 by default

Lifecycle

See Declare a server and Runtime options.

  • โœ… initialize: version negotiation (an unknown version gets 2025-11-25), clientInfo and capabilities checked, instructions
  • โœ… A second initialize is refused on both transports
  • โœ… notifications/initialized; a second one is accepted and ignored
  • โœ… Requests before the initialization are refused; ping is allowed
  • โœ… Initialization timeout, DELETE
  • โœ… Idle timeout with one rule: a stream, a request, a request to the client or a tracked task holds the session; it expires session_timeout_ms after the last one ends
  • โœ… Capability gating: a method of a capability that the server does not declare gives -32601
  • โœ… ping in both directions
  • โœ… A request of the server role sent by the client gives -32601
  • โŒ Protocol revisions other than 2025-11-25 (by design)

Transport: stdio

See stdio transport.

  • โœ… Newline-delimited JSON, logs on stderr only
  • โœ… Concurrent requests, drain at the end of stdin, bounded output queue
  • โœ… The same outcome as HTTP for every message, except a malformed answer of the client, which gets no line on stdio
  • โœ… Every request gets one line, also on a crash
  • โœ… An answer of the client gets no line, valid or malformed, with an id or with none

Transport: Streamable HTTP

See HTTP transport.

  • โœ… POST, GET, DELETE, OPTIONS on one endpoint, 405 with Allow
  • โœ… Accept and Content-Type checks
  • โœ… JSON and SSE answers, lazy upgrade to SSE, priming event
  • โœ… 202 for notifications and for answers of the client
  • โœ… Mcp-Session-Id: visible ASCII, 400 when missing, 404 when unknown or foreign
  • โœ… MCP-Protocol-Version: 400 for an unsupported value
  • โœ… Origin check (403), Host allow-list (DNS rebinding protection)
  • โœ… Limits: sessions, streams, subscriptions, body, numbers, tokens
  • โœ… Session limit with reclaim of the oldest idle session; 429 only when no session is idle
  • โœ… GET SSE: retry:, heartbeats, poll close, several streams per session
  • โœ… Resumability with Last-Event-ID
  • ๐ŸŸก The resume of an unknown or ended POST stream gets 204 (on purpose, to stop reconnect loops)
  • โœ… Server-initiated close of a POST stream with retry: (SEP-1699); the callback goes on
  • โœ… A disconnect is not a cancel, on Bandit and on Cowboy

Authorization (resource server)

See Authorization.

  • โœ… Protected Resource Metadata (RFC 9728), WWW-Authenticate with resource_metadata and scope
  • โœ… Bearer token in the header only, strict parsing, size limit, checked before the body is read
  • โœ… Audience check (RFC 8707), fails closed
  • โœ… Step-up with insufficient_scope
  • โœ… Pluggable authenticate/2 and authorize/3, both fail closed
  • โœ… required_scopes per entity, filtered lists
  • โœ… Session bound to {issuer, subject}; a foreign session gets 404
  • โœ… Local revocation, token expiry during a stream
  • โœ… No authorization on stdio, as the specification expects
  • โŒ Authorization server, dynamic client registration (out of scope)

Tools

See Tools.

  • โœ… tools/list with pagination; a cursor of a wrong type, an unknown cursor and an empty cursor give -32602
  • โœ… tools/call; an unknown tool gives -32602; input errors are tool errors (isError: true)
  • โœ… inputSchema check with defaults; outputSchema and structuredContent checked
  • โœ… title, annotations, icons, _meta, execution.taskSupport
  • โŒ notifications/tools/list_changed (by design: the list is fixed at boot)
  • โœ… All content types, resource links, embedded resources
  • โœ… Tool name format (SEP-986)

Resources

See Resources and Templates.

  • โœ… resources/list, resources/templates/list, resources/read; an unknown URI gives -32002
  • โœ… resources/subscribe (an unknown resource gives -32002), resources/unsubscribe, notifications/resources/updated
  • โŒ notifications/resources/list_changed (by design: the lists are fixed at boot)
  • โœ… URI templates, RFC 6570 levels 1 to 3
  • ๐ŸŸก RFC 6570 level 4 modifiers: refused at compile time (by design: never implemented)
  • โœ… Annotations, size, text and binary contents

Prompts

See Prompts.

  • โœ… prompts/list, prompts/get
  • โŒ notifications/prompts/list_changed (by design: the list is fixed at boot)
  • โœ… Argument checks: a missing required argument, a value that is not a string and an unknown argument give -32602
  • โœ… All content types in messages

Utilities

See Completions and Notifications.

  • โœ… completion/complete with prompt and resource references and context.arguments
  • โœ… logging/setLevel (an unknown level gives -32602), notifications/message, level filter, log rate limit per session
  • โœ… Pagination with opaque cursors
  • โœ… Incoming notifications/cancelled with a two-step stop; an unknown id is ignored
  • โœ… notifications/progress, increasing values only

Client features (requests of the server)

See Client requests.

  • โœ… sampling/createMessage with tools, toolChoice, includeContext
  • โœ… elicitation/create in form mode and in URL mode, with notifications/elicitation/complete
  • โœ… roots/list, notifications/roots/list_changed
  • โœ… Capability check before sending; timeouts per method; cancel on timeout
  • โœ… An answer of the client with a result and an error, a result that is not an object, or a malformed error is refused
  • ๐ŸŸก A request of the server tied to a client request that has no open stream falls back to the GET stream (kept on purpose)

Tasks (experimental)

See Tasks.

  • โœ… tasks capability and taskSupport gating
  • โœ… Task metadata check: ttl type and ceiling
  • โœ… tasks/get, tasks/list, tasks/result, tasks/cancel; an unknown taskId gives -32602
  • โœ… A running task holds its session with tasks_follow_session
  • โœ… A task process that dies with no untrack_task frees its session
  • โœ… Owner isolation and scope checks
  • โœ… notifications/tasks/status, ttl, pollInterval, timestamps, statusMessage
  • โœ… input_required with held requests; related-task _meta
  • โœ… Limits per owner
  • โœ… Server as requestor (option client_tasks, off by default)

Many nodes (outside the specification)

See Cluster.

  • โœ… Broadcast across nodes with OzMcp.PubSub.PG, at most once
  • โœ… Sticky routing and failover guide
  • โœ… A request that arrives right after a session crash restores the session from the snapshot
  • ๐ŸŸก Failover through a snapshot store: the event log and the open requests to the client are lost (documented)
  • โŒ Limits, revocation and the task store across the cluster (out of scope)