verify_webhook
Verify webhook signatures using timing-safe comparison and replay protection. Returns valid:true or precise failure reasons (signature_mismatch, timestamp_out_of_range, malformed_signature) so you can act only after confirming authenticity.
Instructions
Verify a webhook signature with a timing-safe comparison and, where the provider signs a timestamp, replay protection. Returns valid:true or the precise reason it failed (signature_mismatch, timestamp_out_of_range, malformed_signature). Never parse or act on a webhook body before this returns valid.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"provider": "<provider>",
"secret": "<secret>",
"signature": "<signature>"
},
"name": "verify_webhook"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| url | No | Required for twilio: the full request URL. | |
| body | No | The RAW request body, byte-identical to what was received. | |
| params | No | Required for twilio: the POST form parameters. | |
| secret | Yes | Signing secret or auth token. | |
| provider | Yes | ||
| signature | Yes | The provider's signature header value. | |
| timestamp | No | Required for slack (X-Slack-Request-Timestamp). | |
| tolerance_seconds | No | Replay window for providers that sign a timestamp. |