ModelContextPro.dev / Errors
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 / Rule | Layer | Meaning | Fix |
|---|---|---|---|
-32700 | JSON-RPC | Parse error — malformed JSON body | Ensure UTF-8 JSON without trailing commas or HTML proxy fallback pages. |
-32602 | JSON-RPC | Invalid params — schema mismatch | Validate caller payload against inputSchema before handler invocation. |
HTTP 403 | Transport | Origin header rejected (DNS rebinding guard) | Send exact allowlisted Origin or run server-to-server without spoofed origin headers. |
MCP-SEC-01 | Linter | Instruction-override phrase detected in tool description | Remove imperative prompts, hidden tags, and cross-tool steering language. |
MCP-STATELESS-02 | Linter | Implicit session parameter or mutable global cursor | Require explicit idempotency key and caller-supplied state token. |
MCP-SCHEMA-03 | Linter | Unbounded object or missing required array | Define concrete properties, primitive types, and additionalProperties: false. |