io.github.rog0x/webhook

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.

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