ModelContextPro.dev / Errors
DIAGNOSTICS · ERROR REFERENCE

MCP 2026-07-28 Error Codes & Linter Diagnostics

Deterministic troubleshooting table mapping JSON-RPC error codes, HTTP status codes, and security linter findings to exact server fixes.

Protocol & Linter Error Table

Code / RuleLayerMeaningFix
-32700JSON-RPCParse error — malformed JSON bodyEnsure UTF-8 JSON without trailing commas or HTML proxy fallback pages.
-32602JSON-RPCInvalid params — schema mismatchValidate caller payload against inputSchema before handler invocation.
HTTP 403TransportOrigin header rejected (DNS rebinding guard)Send exact allowlisted Origin or run server-to-server without spoofed origin headers.
MCP-SEC-01LinterInstruction-override phrase detected in tool descriptionRemove imperative prompts, hidden tags, and cross-tool steering language.
MCP-STATELESS-02LinterImplicit session parameter or mutable global cursorRequire explicit idempotency key and caller-supplied state token.
MCP-SCHEMA-03LinterUnbounded object or missing required arrayDefine concrete properties, primitive types, and additionalProperties: false.

Interoperability Cluster

Compile validated MCP tools to A2A v1.0.1 on a2amcp.dev →