io.github.rog0x/webhook
Send, validate, debug webhooks for AI agents
Open source Open in the app JSON README (API)
About
Send, validate, debug webhooks for AI agents
Details
- Kind
- MCP servers
- Topic
- No topic detected
- Publisher
- rog0x
- Origin
- official
- Category
- ferramentas
- Transport
- local
- Version
- 1.0.2
- Last push
- 2026-03-21T20:21:19Z
- Repository state
- ativo
- Language
- TypeScript
- License
- NOASSERTION
- Added
- 2026-08-29 04:01:19
- Updated
- 2026-08-29 04:01:19
- Origin id
io.github.rog0x/webhook
README
# mcp-webhook-tools
Webhook management and testing tools for AI agents, built on the [Model Context Protocol](https://modelcontextprotocol.io/).
## 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:
| Service | Events |
| ------- | ----------------------------------- |
| Stripe | `payment_intent.succeeded` |
| GitHub | `push`, `pull_request` |
| Slack | `message` |
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
```bash
npm install
npm run build
```
## MCP Configuration
Add to your MCP client config:
```json
{
"mcpServers": {
"webhook-tools": {
"command": "node",
"args": ["path/to/mcp-webhook-tools/dist/index.js"]
}
}
}
```
## License
MIT