Installation
Install the CLI, the SDKs for TypeScript, Python and Go, or the MCP server for your AI coding agent.
Homebrew (macOS / Linux)
brew install kroqdotdev/tap/whk
Shell script (macOS / Linux)
curl -fsSL https://webhooks.cc/install.sh | sh
Downloads the latest binary for your platform, verifies its checksum, and installs it to /usr/local/bin, with sudo when needed. Without root, for example in CI or an agent's sandbox, pick a directory you can write to; it is created when missing:
curl -fsSL https://webhooks.cc/install.sh | WHK_INSTALL_DIR="$HOME/.local/bin" sh
GitHub Releases
Download pre-built binaries for macOS, Linux, and Windows from GitHub Releases.
Verify
whk --version
Get started
Run whk to open the interactive TUI with tunneling, live request streaming, and endpoint management:
whk
Or use subcommands directly:
whk auth login # authenticate via browser whk tunnel 3000 # forward webhooks to localhost:3000
See the CLI docs for the full command reference.
npm
npm install @webhooks-cc/sdk
pnpm
pnpm add @webhooks-cc/sdk
bun
bun add @webhooks-cc/sdk
yarn
yarn add @webhooks-cc/sdk
Quick start
import { WebhooksCC } from "@webhooks-cc/sdk";
const client = new WebhooksCC({
apiKey: process.env.WHK_API_KEY,
});
const endpoint = await client.endpoints.create({
name: "my-endpoint",
});
console.log(endpoint.url);Generate an API key from your API keys page. See the SDK docs for the full API reference.
Python
pip install webhooks-cc
The same testing tools for Python, with pytest fixtures. See the Python SDK docs.
Go
go get webhooks.cc/go
The same testing tools for Go, with helpers for testing.TB. See the Go SDK docs.
Remote server (recommended)
No key to paste and nothing to install. Add https://webhooks.cc/mcp to your client. The first time it connects, webhooks.cc opens in your browser: sign in, or sign up, and click Connect. There is no code to type.
Claude Code
claude mcp add -s user --transport http webhooks-cc https://webhooks.cc/mcp
Then run /mcp in Claude Code and pick webhooks-cc to sign in.
OpenAI Codex
codex mcp add webhooks-cc --url https://webhooks.cc/mcp
Codex opens your browser to sign in. If it does not, run codex mcp login webhooks-cc.
Cursor
In .cursor/mcp.json:
{ "mcpServers": { "webhooks-cc": { "url": "https://webhooks.cc/mcp" } } }VS Code
In .vscode/mcp.json:
{ "servers": { "webhooks-cc": { "type": "http", "url": "https://webhooks.cc/mcp" } } }claude.ai and Claude Desktop
In Settings, Connectors, add a custom connector with this URL. ChatGPT takes the same URL as a custom connector, in developer mode.
https://webhooks.cc/mcp
Disconnect it at any time under Connected agents. The remote server docs cover other clients and what differs from the local server.
Local server
Runs @webhooks-cc/mcp on your machine. Use it when your agent must send to localhost (send_to, replay_request) or share a local site (share_port), to start in the agent sandbox without an account, or in CI with an API key.
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 API keys page.
Claude Code plugin
Installs the MCP server together with the webhooks.cc skill, which tells Claude what webhooks.cc can do and when to reach for it: signed test sends to your local handler, email codes in tests, forwarding, tunnels and preview links. It runs the local server: Claude Code asks for your API key when you enable it; leave it empty to start in the keyless sandbox.
/plugin install webhooks-cc --marketplace kroqdotdev/webhooks-cc
Agent skill for Cursor, Codex, Copilot and others
The same skill for every agent that reads SKILL.md. Add the MCP server as well: the remote server above, or a local one below.
npx skills add kroqdotdev/webhooks-cc
More on what the skill does: Agent skill docs.
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
Devin Desktop (formerly Windsurf)
npx @webhooks-cc/mcp setup devin --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_..."
}
}
}
}See the MCP docs for the full tool reference.