webhooks-cc MCP server
Commit 15 Nov 2026Biarkan AI agent mengelola webhook endpoint, memeriksa incoming request, melakukan replay payload, dan membagikan situs lokal melalui bahasa alami.
Juga dikenal sebagai kroqdotdev/webhooks-cc, @webhooks-cc/mcp
- Stars
- 3
- Tools
- —
- Unduhan, 30 hari
- —
- Versi terbaru
- —
- Commit terakhir
- 15 Nov 2026
- Lisensi
- AGPL-3.0
Apa itu webhooks-cc MCP?
Biarkan AI agent mengelola webhook endpoint, memeriksa incoming request, melakukan replay payload, dan membagikan situs lokal melalui bahasa alami.
Ringkasan dibuat dari README proyek
Tentang webhooks-cc MCP server
Mengelola webhook endpoint dan memeriksa incoming request melalui bahasa alami adalah kemampuan yang ditawarkan MCP server ini bagi developer yang menggunakan AI coding agent. Dengan terhubung ke tool seperti Claude Code, Cursor, atau VS Code, seorang agent dapat membuat endpoint baru, mengirim test payload, dan melakukan replay request yang telah ditangkap ke server lokal Anda. Server ini menjadi jembatan antara asisten AI Anda dengan infrastruktur webhooks.cc, memungkinkan debugging secara real-time tanpa perlu navigasi dashboard secara manual.
User dapat menyiapkan server ini dengan menyediakan API key melalui environment variable WHK_API_KEY. Server ini menyediakan 57 tools yang memungkinkan agent untuk mengelola seluruh lifecycle webhook, mulai dari pembuatan awal hingga membagikan situs lokal melalui link publik. Setup ini sangat berguna untuk mengetes integrasi pembayaran atau hook CI/CD di mana Anda perlu melihat header, body, dan signature yang presisi dari provider seperti Stripe atau GitHub.
Apa yang bisa Anda lakukan dengannya
- 1Test integrasi pembayaranAI agent dapat membuat endpoint khusus untuk memeriksa struktur payload dari event Stripe.
- 2Debug workflow CI/CDAnda dapat meminta agent untuk memantau data apa saja yang dikirim oleh GitHub saat proses deployment atau pull request.
- 3Simulasi error handlingAgent dapat mengonfigurasi endpoint untuk mengembalikan error code tertentu guna mengetes bagaimana aplikasi Anda menangani proses retry.
- 4Replay request ke pengembangan lokalAnda dapat menginstruksikan AI untuk mengambil webhook yang telah ditangkap dan mengirimkannya langsung ke server lokal Anda untuk keperluan testing.
Ditulis berdasarkan README proyek. Setiap use case diperiksa terhadap kutipan dari README tersebut.
Cara menginstal webhooks-cc MCP
Format diverifikasi 10 Nov 2026Tambahkan ke CursorTambahkan ke GooseInstal webhooks-cc MCP di Claude Code
$ claude mcp add webhooks-cc -- npx -y @webhooks-cc/mcpInstal webhooks-cc MCP di Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"webhooks-cc": {
"command": "npx",
"args": [
"-y",
"@webhooks-cc/mcp"
]
}
}
}Instal webhooks-cc MCP di VS Code
.vscode/mcp.json
{
"servers": {
"webhooks-cc": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@webhooks-cc/mcp"
]
}
}
}Instal webhooks-cc MCP di VS Code CLI
$ code --add-mcp '{"name":"webhooks-cc","type":"stdio","command":"npx","args":["-y","@webhooks-cc/mcp"]}'Instal webhooks-cc MCP di Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"webhooks-cc": {
"command": "npx",
"args": [
"-y",
"@webhooks-cc/mcp"
]
}
}
}Instal webhooks-cc MCP di Codex
$ codex mcp add webhooks-cc -- npx -y @webhooks-cc/mcpInstal webhooks-cc MCP di Codex config.toml
~/.codex/config.toml
[mcp_servers.webhooks-cc] command = "npx" args = ["-y", "@webhooks-cc/mcp"]
Instal webhooks-cc MCP di Gemini CLI
$ gemini mcp add -s user webhooks-cc npx -- -y @webhooks-cc/mcpInstal webhooks-cc MCP di Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"webhooks-cc": {
"command": "npx",
"args": [
"-y",
"@webhooks-cc/mcp"
]
}
}
}Dijalankan oleh HostedMCP pada 16 Nov 2026
Kami menjalankan perintah ini untuk @webhooks-cc/mcp 2.5.0 di container terisolasi tanpa jaringan dan tanpa key. Server menjawab dan mendaftar 11 tool.
Pengecekan otomatis
Berjalan 14 Nov 2026Laporan lengkap →Belum diverifikasi. Sebuah server memerlukan skor 80, tidak ada temuan serius, dan data yang cukup untuk kami periksa. Cara kerja checks · Yang perlu diperbaiki untuk menambah poin
- Source repository terhubung dan dapat dijangkaukroqdotdev/webhooks-cc is public and reachablegithub.com/kroqdotdev/webhooks-cc ↗Lolos
- Nama paket mencantumkan repositori ini sebagai sumbernya@webhooks-cc/mcp names kroqdotdev/webhooks-cc as sourcenpmjs.com/package/@webhooks-cc/mcp ↗Lolos
- Provenance build (atestasi Sigstore)No build attestation published for this releaseTidak diperiksa
- Lisensi open source (OSI)AGPL-3.0spdx.org/licenses/AGPL-3.0.html ↗Lolos
- Ada commit atau release dalam satu tahun terakhirLast commit or release 2026-11-14github.com/kroqdotdev/webhooks-cc ↗Lolos
- OpenSSF ScorecardTidak diperiksa
- Nama package tidak mirip dengan package populerNo popular package one edit away from @webhooks-cc/mcpLolos
- Tidak ada advisory kritis pada paket atau dependensinyaTidak diperiksa
- Tidak ada instruksi tersembunyi untuk model0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersLolos
- Tools yang bersifat destruktif telah diberi labelTidak diperiksa
- Endpoint remote merespons handshake MCPTidak diperiksa
README
Lihat di GitHubwebhooks.cc
Inspect and debug webhooks and email without deploying to production.
Get a unique URL, point your webhook there, and see every request in real time. No signup required. Every endpoint also has an email address at mailhooks.cc that captures mail the same way.
Getting Started
- Visit webhooks.cc
- Copy your unique webhook URL
- Send a test request:
curl -X POST https://go.webhooks.cc/w/<slug> -d '{"test": true}' - Watch it appear in the dashboard
Features
- Capture requests: store incoming webhooks with headers, body, query parameters and metadata
- Capture email: every endpoint receives mail at
{slug}@mailhooks.cc, with parsed fields, attachments and authentication results - Inspect in real time: see requests the moment they arrive
- Configure responses: return custom status codes, headers and bodies, chosen by rules, to test error paths
- Verify signatures: check provider signatures (Stripe, GitHub, Shopify and more) on captured requests
- Forward: tunnel webhooks to localhost during development (with
--live, the sender gets your local app's answer), or forward them to other URLs, chat and file drops - Share localhost: put the site on your machine at a public link on sharehooks.cc with
whk share - CLI with interactive TUI: manage endpoints, tunnel and stream requests from your terminal
- SDKs for TypeScript, Python and Go: wait for and assert on webhooks in tests and CI, and share a local port from code
- MCP server: connect AI coding agents (Claude Code, Cursor, VS Code, Codex) to your webhooks
Use Cases
Testing payment integrations: point Stripe's test webhooks at your endpoint. Inspect the payload structure before writing handlers.
Debugging CI/CD hooks: see exactly what GitHub sends when a push, PR, or deployment occurs.
Developing locally: forward production-like webhooks to localhost without exposing your machine to the internet.
Mocking failure scenarios: configure your endpoint to return 500 errors and test your retry logic.
Pricing
Free: 50 requests a day, 7-day retention. Enough for development and testing.
Pro ($8/month): 100,000 requests a month, 31-day retention.
Business ($29/month): 250,000 requests a month, 90-day retention, attachment parsing, custom inbound domains and file drops.
Teams share endpoints under a per-seat subscription. See plans and limits for details.
Install
CLI
curl -fsSL https://webhooks.cc/install.sh | sh
# or
brew install kroqdotdev/tap/whk
# without root: any directory you can write to (created when missing)
curl -fsSL https://webhooks.cc/install.sh | WHK_INSTALL_DIR="$HOME/.local/bin" sh
With WHK_INSTALL_DIR, put that directory on your PATH (the installer prints the line to add) before running whk.
Then launch interactive terminal:
whk
SDK
npm install @webhooks-cc/sdk
MCP server
# Claude Code
claude mcp add -s user webhooks-cc -e WHK_API_KEY=whcc_... -- npx -y @webhooks-cc/mcp
# Cursor, VS Code, Devin Desktop (formerly Windsurf), Claude Desktop
npx @webhooks-cc/mcp setup cursor --api-key whcc_...
See webhooks.cc/installation for all install methods, one-click buttons, and setup guides.
CLI
Run whk to launch the interactive TUI:
$ whk
webhooks.cc
● Logged in as you@example.com
▸ Tunnel Forward webhooks to localhost
Listen Stream incoming requests
Create Create a new endpoint
Endpoints Manage your endpoints
Auth Login / logout
Update Check for updates
All commands also work directly from the command line:
whk tunnel 8080 # Forward webhooks to localhost:8080
whk share 3000 # Share localhost:3000 at https://<name>.sharehooks.cc
whk listen <slug> # Stream incoming requests
whk create my-endpoint # Create a new endpoint
whk list # List your endpoints
whk replay <request-id> --to :3000 # Replay a captured request
Pass --nogui or set WHK_NOGUI=1 to skip the TUI and print help.
SDK
import { WebhooksCC, matchMethod, matchHeader, matchAll } from "@webhooks-cc/sdk";
const client = new WebhooksCC({ apiKey: "whcc_..." });
const endpoint = await client.endpoints.create({ name: "my-webhook" });
console.log(endpoint.url);
// Wait for a matching request with human-readable timeout
const req = await client.requests.waitFor(endpoint.slug, {
timeout: "30s",
match: matchAll(matchMethod("POST"), matchHeader("stripe-signature")),
});
// Replay captured requests to your local server
await client.requests.replay(req.id, "http://localhost:3000/webhooks");
MCP server
The @webhooks-cc/mcp package exposes 57 tools (54 on the remote server) that let AI agents manage endpoints, inspect webhooks, send test payloads, replay requests, and share a local site at a public link through natural language.
You: "Create a webhook endpoint for testing Stripe"
Agent: Created endpoint "stripe-test" at https://go.webhooks.cc/w/abc123
You: "Send a test checkout.session.completed event"
Agent: Sent POST to stripe-test
You: "Replay that to my local server"
Agent: Replayed to http://localhost:3000/webhooks: 200 OK
See packages/mcp/README.md for full setup and tool reference.
Why the code is public
webhooks.cc holds other people's webhooks and email, so the code that handles them should be open to inspection. You can read exactly how a request is captured, stored, forwarded and deleted, and check that the service does what it says. The repository is also where security scanning, dependency updates and bug reports happen in the open.
webhooks.cc is built and run by one developer. The hosted service at webhooks.cc is the product; the repository is not a community project.
Issues and contributions
- Bugs and feature requests are welcome as issues.
- Questions about your account, billing or data go to webhooks.cc/support, never to a public issue.
- Security vulnerabilities are reported privately, see SECURITY.md.
- Pull requests are accepted only from people who have signed the Contributor License Agreement. Open an issue first: most changes are made in-house, and a pull request may be closed or reimplemented. See CONTRIBUTING.md.
License
This project uses a split license:
- AGPL-3.0: the web app, receiver, email-capture SMTP host, tunnel edge, attachment parser and database schema (
apps/web/,apps/receiver-rs/,apps/mx-rs/,apps/edge-rs/,apps/parser-rs/,supabase/). See LICENSE. - MIT: the CLI and its tunnel protocol crate, the TypeScript, Python and Go SDKs, the MCP server, the Zapier and Make apps, and the Claude Code plugin (
apps/cli-rs/,crates/tunnel/,packages/sdk/,packages/sdk-python/,packages/sdk-go/,packages/mcp/,packages/zapier-app/,packages/make-app/,plugins/). See theLICENSEfile in each directory.
The CLI, SDKs and MCP server are MIT so you can use them freely in your own projects, open or closed.
Pertanyaan tentang webhooks-cc MCP
Bagaimana cara menambahkan webhooks-cc MCP ke Claude Code?
Jalankan claude mcp add webhooks-cc -- npx -y @webhooks-cc/mcp di terminal Anda. Tambahkan --scope user agar tersedia di semua proyek.
Bagaimana cara menambahkan webhooks-cc MCP ke Cursor?
Buka ~/.cursor/mcp.json dan tambahkan server di bawah mcpServers, menggunakan config Cursor yang ditunjukkan di bagian instalasi di atas.
Apa yang bisa dilakukan oleh MCP server ini?
Server ini memungkinkan AI agent untuk mengelola endpoint, memeriksa webhook, mengirim test payload, melakukan replay request, dan membagikan situs lokal melalui bahasa alami.
Bisakah saya mengetes incoming request melalui email?
Ya, setiap endpoint memiliki alamat email terkait di mailhooks.cc yang dapat menangkap email lengkap dengan parsed fields dan attachment.
