mcp-webhook-tools

Webhook management and testing tools for AI agents, built on the Model Context Protocol.

Tools

webhook_send

Send a webhook payload to any URL with custom headers, body, and content-type. Supports automatic retry with exponential backoff and jitter. Returns detailed attempt records including status codes, timing, and errors.

webhook_validate

Validate webhook signatures using HMAC-SHA256 or HMAC-SHA1. Includes built-in patterns for:

• Stripe — t=TIMESTAMP,v1=SIGNATURE format with timestamp tolerance

• GitHub — sha256=SIGNATURE or sha1=SIGNATURE format

• Slack — v0=SIGNATURE with v0:timestamp:body signing scheme

Uses timing-safe comparison to prevent timing attacks.

webhook_generate_payload

Generate realistic webhook payloads for testing. Supported events:

Each payload includes randomized IDs, current timestamps, and suggested headers. Use the overrides parameter to customize specific fields.

webhook_debug

Analyze a webhook request end-to-end:

• Parse and categorize headers (content-type, signature, timestamp, delivery ID, custom)

• Validate the request body (size, JSON validity, encoding)

• Auto-detect the provider (Stripe, GitHub, Slack)

• Verify the signature if a secret is provided

• Check timestamp freshness (default 300s threshold)

• Report all issues found

webhook_retry_schedule

Calculate a retry schedule with exponential backoff. Shows each attempt's delay, cumulative elapsed time, and scheduled ISO timestamp. Configurable base delay, max delay cap, multiplier, and jitter.

Related MCP server: Webhook.site MCP Server

Setup

npm install
npm run build

MCP Configuration

Add to your MCP client config:

{
  "mcpServers": {
    "webhook-tools": {
      "command": "node",
      "args": ["path/to/mcp-webhook-tools/dist/index.js"]
    }
  }
}

License

MIT