mailkite_verify_webhook
Verify inbound webhook authenticity by validating the HMAC-SHA256 signature and timestamp freshness, blocking forged or replayed events.
Instructions
Verify the x-mailkite-signature header on an inbound webhook delivery. Runs entirely locally (HMAC-SHA256 over ${t}.${payload}) — no network call. Returns true only when the signature matches and the event is within the freshness window. Runs locally (no API call) — no credentials needed.
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": {
"payload": "<payload>",
"signature": "<signature>",
"secret": "<secret>"
},
"name": "mailkite_verify_webhook"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| secret | Yes | Your webhook signing secret (from the dashboard). | |
| payload | Yes | The raw, unparsed webhook request body — the exact bytes you received. | |
| signature | Yes | The `x-mailkite-signature` header value, e.g. `t=1750000000000,v1=4f1a9c…`. | |
| toleranceMs | No | Reject events whose timestamp is more than this many milliseconds old, to block replays. Defaults to 300000 (5 minutes). Pass 0 to disable the freshness check. |