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.

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 11 tools your AI agent can call:

For provider templates in send_webhook, secret is required. The MCP server does not inject a default secret.

create_endpoint

Create a new webhook endpoint

Try: "Create a webhook endpoint called stripe-test"

list_endpoints

List all your endpoints

Try: "Show me my webhook endpoints"

get_endpoint

Get details for an endpoint by slug

Try: "What's the URL for my stripe-test endpoint?"

update_endpoint

Update an endpoint name or mock response

Try: "Set stripe-test to return a 201 with {"ok":true}"

delete_endpoint

Delete an endpoint and its requests

Try: "Delete the stripe-test endpoint"

list_requests

List captured requests for an endpoint

Try: "Show me the last 10 requests on stripe-test"

get_request

Get full details of a captured request

Try: "Show me the body of request abc123"

send_webhook

Send a test webhook (manual or provider template) to an endpoint

Try: "Send a Stripe checkout.session.completed template to stripe-test using secret whsec_test"

wait_for_request

Wait for an incoming request (polling)

Try: "Wait for a POST on stripe-test for 30 seconds"

replay_request

Replay a captured request to a target URL

Try: "Replay request abc123 to http://localhost:3000/webhooks"

describe

Describe all available SDK operations

Try: "What can you do with webhooks.cc?"

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