Troubleshooting guides

Each guide explains one failure, evidence to check and the limits of a free diagnostic.

MCP server not responding: locate the timeout

Separate a server startup failure from an initialization failure and a slow tool call before changing timeouts.

MCP tool schema invalid: check the input contract

Find whether a tool definition is rejected or the arguments fail validation. These are different failures with different fixes.

Webhook signature mismatch: preserve the signed bytes

A present signature can still fail when the receiver verifies a different byte sequence, secret version or timestamp from the sender.

JSON trailing comma: validate a minimal repair

A trailing comma before a closing brace or bracket is invalid JSON. Repair the syntax while preserving the intended data.