Skip to content

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

Add to Cursor

Paste your key above first — it gets baked into the install link.

Add to VS Code

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_response

The 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

ToolDescription
create_endpointCreate a new webhook endpoint
list_endpointsList all your endpoints
get_endpointGet details for an endpoint by slug
update_endpointUpdate an endpoint name or mock response
delete_endpointDelete an endpoint and its requests
create_endpointsCreate multiple endpoints in one call (1-20)
delete_endpointsDelete multiple endpoints in one call (1-100)

Sending and testing

ToolDescription
send_webhookSend a test webhook (manual or provider template) to an endpoint
send_toSend a signed webhook directly to any URL (localhost, staging, etc.)
preview_webhookPreview a webhook request without sending it
test_webhook_flowRun a full test flow: create, mock, send, wait, verify, replay, cleanup

Request management

ToolDescription
list_requestsList captured requests for an endpoint
get_requestGet full details of a captured request
wait_for_requestWait for an incoming request (polling)
wait_for_requestsWait for multiple incoming requests
search_requestsSearch requests across endpoints with full-text search
count_requestsCount requests matching filters
clear_requestsDelete requests for an endpoint without deleting the endpoint

Request analysis

ToolDescription
replay_requestReplay a captured request to a target URL
compare_requestsCompare two requests and show structured differences
extract_from_requestExtract specific JSON fields from a request body
verify_signatureVerify the webhook signature on a captured request

Utilities

ToolDescription
list_provider_templatesList supported providers, templates, and signing metadata
get_usageCheck current request usage, quota, and plan
describeDescribe 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.