MCP Server
The @webhooks-cc/mcp package lets AI coding agents create endpoints, inspect webhooks, send test payloads, and replay captured requests — all through natural language.
Updated May 2026
Your API key
Paste your API key to fill it into every command below. It stays in your browser only — nothing is sent or stored.
Get your key from your account page.
One-click install
Paste your key above first — it gets baked into the install link.
VS Code prompts you for your key during install.
Claude Code
claude mcp add -s user webhooks-cc -e WHK_API_KEY=whcc_... -- npx -y @webhooks-cc/mcp
Cursor (CLI)
npx @webhooks-cc/mcp setup cursor --api-key whcc_...
VS Code (CLI)
npx @webhooks-cc/mcp setup vscode --api-key whcc_...
OpenAI Codex
codex mcp add webhooks-cc -e WHK_API_KEY=whcc_... -- npx -y @webhooks-cc/mcp
Windsurf
npx @webhooks-cc/mcp setup windsurf --api-key whcc_...
Claude Desktop
npx @webhooks-cc/mcp setup claude-desktop --api-key whcc_...
Manual config
For any tool that reads an MCP config JSON file:
{
"mcpServers": {
"webhooks-cc": {
"command": "npx",
"args": ["-y", "@webhooks-cc/mcp"],
"env": {
"WHK_API_KEY": "whcc_..."
}
}
}
}Available tools
The MCP server exposes 25 tools your AI agent can call:
For provider templates in send_webhook, secret is required for every signed provider — only sendgrid, discord, and plaid templates are unsigned and need no secret. The MCP server does not inject a default secret.
Provider-aware testing
Agents can inspect provider metadata, send realistic templates, then read the captured request with the provider and event visible in the dashboard.
You: "List the Typeform webhook templates and send a form_response to my endpoint"
Agent: [calls list_provider_templates with provider: "typeform"]
Agent: [calls send_webhook with provider: "typeform", template: "form_response", secret: "..."]
Agent: Captured POST request detected as Typeform / form_responseThe same flow works for Stripe, GitHub, Shopify, Twilio, Slack, Paddle, Linear, SendGrid templates, Clerk, Discord templates, Vercel, GitLab, Typeform, Standard Webhooks, DocuSign, Adyen, PayPal templates, and Plaid templates.
Endpoint management
| Tool | Description |
|---|---|
create_endpoint | Create a new webhook endpoint |
list_endpoints | List all your endpoints |
get_endpoint | Get details for an endpoint by slug |
update_endpoint | Update an endpoint name or mock response |
delete_endpoint | Delete an endpoint and its requests |
create_endpoints | Create multiple endpoints in one call (1-20) |
delete_endpoints | Delete multiple endpoints in one call (1-100) |
Sending and testing
| Tool | Description |
|---|---|
send_webhook | Send a test webhook (manual or provider template) to an endpoint |
send_to | Send a signed webhook directly to any URL (localhost, staging, etc.) |
preview_webhook | Preview a webhook request without sending it |
test_webhook_flow | Run a full test flow: create, mock, send, wait, verify, replay, cleanup |
Request management
| Tool | Description |
|---|---|
list_requests | List captured requests for an endpoint |
get_request | Get full details of a captured request |
wait_for_request | Wait for an incoming request (polling) |
wait_for_requests | Wait for multiple incoming requests |
search_requests | Search requests across endpoints with full-text search |
count_requests | Count requests matching filters |
clear_requests | Delete requests for an endpoint without deleting the endpoint |
Request analysis
| Tool | Description |
|---|---|
replay_request | Replay a captured request to a target URL |
compare_requests | Compare two requests and show structured differences |
extract_from_request | Extract specific JSON fields from a request body |
verify_signature | Verify the webhook signature on a captured request |
Utilities
| Tool | Description |
|---|---|
list_provider_templates | List supported providers, templates, and signing metadata |
get_usage | Check current request usage, quota, and plan |
describe | Describe all available SDK operations |
Prompts
The MCP server provides 3 prompt templates for common workflows:
- debug_webhook_delivery — diagnose why webhook delivery is failing or missing
- setup_provider_testing — set up webhook testing for a specific provider
- compare_webhook_attempts — compare two webhook deliveries or retries
Resources
Three resources provide read-only access to your webhook data:
- endpoints-overview (
webhooks://endpoints) — all endpoints with recent activity - endpoint-recent-requests (
webhooks://endpoint/{slug}/recent) — last 10 requests at an endpoint - request-details (
webhooks://request/{id}) — full details of a specific request
Example conversation
With the MCP server connected, you can talk to your AI agent naturally:
You: "Create a webhook endpoint for testing Stripe"
Agent: Created endpoint "stripe-test" at https://go.webhooks.cc/w/abc123
You: "Set it to return 201 with {"received": true}"
Agent: Updated mock response for stripe-test
You: "Send a Stripe checkout.session.completed template webhook to stripe-test"
Agent: Sent signed Stripe template to stripe-test
You: "Show me what was captured"
Agent: 1 request captured:
POST /w/abc123 — stripe-signature + checkout.session.completed payload
You: "Replay that to my local server"
Agent: Replayed to http://localhost:3000/webhooks — got 200 OK
Learn more
SDK Overview
The TypeScript SDK that powers the MCP server.
API Reference
All methods, matchers, and types.
Testing patterns
CI/CD integration examples.