webhooks.cc

@webhooks-cc/mcp

适用于 webhooks.cc 的 MCP 服务。它让编码 Agent 能直接使用 Webhook 测试工作流：创建端点、发送带签名的测试 Webhook、检查捕获记录、比较请求尝试、验证签名，并通过 MCP 资源读取近期 Webhook 上下文。

它支持 Claude Code、Cursor、VS Code、Codex、Windsurf 和 Claude Desktop。

安装

该服务从环境中读取 WHK_API_KEY。它还支持：

• 用于自定义 API 基础 URL 的 WHK_BASE_URL
• 用于自定义接收端基础 URL 的 WHK_WEBHOOK_URL

Claude Code 插件

该插件会一并安装服务和 Webhook 测试技能，告知 Claude 何时使用该服务：

/plugin install webhooks-cc --marketplace kroqdotdev/webhooks-cc

对于其他 Agent，运行 npx skills add kroqdotdev/webhooks-cc 即可安装相同的技能。请参阅Agent 技能。

一键安装

• Cursor：添加到 Cursor
• VS Code：添加到 VS Code

命令行

# Claude Code
claude mcp add -s user --transport stdio webhooks-cc -e WHK_API_KEY=whcc_... -- npx -y @webhooks-cc/mcp

# OpenAI Codex
codex mcp add webhooks-cc -e WHK_API_KEY=whcc_... -- npx -y @webhooks-cc/mcp

# Cursor
npx @webhooks-cc/mcp setup cursor --api-key whcc_...

# VS Code
npx @webhooks-cc/mcp setup vscode --api-key whcc_...

# Windsurf
npx @webhooks-cc/mcp setup windsurf --api-key whcc_...

# Claude Desktop
npx @webhooks-cc/mcp setup claude-desktop --api-key whcc_...

手动配置

{
  "mcpServers": {
    "webhooks-cc": {
      "command": "npx",
      "args": ["-y", "@webhooks-cc/mcp"],
      "env": {
        "WHK_API_KEY": "whcc_..."
      }
    }
  }
}

请在 webhooks.cc/account/api-keys 获取 API 密钥。

提供的功能

使用 API 密钥时，该服务提供 39 个工具、3 个提示词和 3 个资源接口；无需密钥时则提供 11 个沙盒工具。

端点工具

• create_endpoint
• list_endpoints
• get_endpoint
• update_endpoint
• delete_endpoint
• create_endpoints
• delete_endpoints

请求工具

• list_requests
• search_requests
• count_requests
• get_request
• wait_for_request
• wait_for_requests
• replay_request
• compare_requests
• generate_payload_schema（根据捕获的请求体生成 TypeScript、Zod、Pydantic 或 JSON Schema）
• extract_from_request
• verify_signature
• clear_requests

邮件工具

账户上的每个端点都会接收发送至 {slug}@mailhooks.cc（以及 {slug}+{tag}@mailhooks.cc）的邮件。除非端点所有者关闭此功能，否则这些工具会读取邮件，并提取其中的一次性代码和主要链接：

• list_emails
• get_email
• wait_for_email
• send_test_email

请求工具和资源也会返回邮件（使用 kind 进行筛选），但不包含原始邮件或 HTML 部分，且文本会截断至 8,000 个字符；get_email 会返回 HTML。

转发工具

将每个捕获到的 HTTP 请求和邮件转发到 URL 或 Slack、Discord 频道，按接收时的原样转发、 作为带签名的 JSON 或聊天消息转发，并进行重试和记录（仅限所有者）：

• configure_forwarding（URL、启用/关闭、类型、格式、自定义标头、路径、重试次数、顺序、发送时间字段）
• get_forwarding_secret（返回 whsec_ 密钥；设置 rotate: true 可替换该密钥）
• test_forwarding
• list_deliveries（查看包含数量的投递日志，或查看某个请求的每次投递尝试）
• redeliver（重新投递单个请求，或重新投递某个端点的所有失败投递）

发送与测试工具

• send_webhook
• send_to
• preview_webhook
• test_webhook_flow

团队工具

• list_teams
• list_team_members
• share_endpoint
• unshare_endpoint

与你共享的端点会自动显示在 list_endpoints 中（带有 fromTeam），并可使用除 clear_requests 外的所有请求工具；clear_requests 仍仅限所有者使用。不会提供邀请功能：接受邀请即会占用一个付费席位。

发现与账户工具

• list_provider_templates
• get_usage（个人套餐以及每个已订阅团队的额度池）
• describe

无需 API 密钥：Agent 沙盒

在未设置 WHK_API_KEY 的情况下启动时，服务会注册沙盒工具 (auth.md)：

• create_endpoint、list_endpoints、get_endpoint、delete_endpoint、list_requests、get_request、wait_for_request、generate_payload_schema：名称和参数与完整工具相同，可在沙盒中使用，最多支持 3 个端点、每个端点捕获 25 个请求、总计 100 个请求，有效期为 24 小时。首次调用 create_endpoint 时会注册端点（需要几秒钟进行工作量证明）。
• connect_account：返回一个链接和 6 位代码，供用户将 Agent 连接到自己的账户。
• wait_for_connection：等待用户完成操作，然后将沙盒工具替换为该账户的完整工具（notifications/tools/list_changed）。
• about_sandbox：介绍限制和连接方式，无需网络调用。

提示词

服务提供适用于常见工作流的 MCP 提示词：

• debug_webhook_delivery
• setup_provider_testing
• compare_webhook_attempts

这些提示词不会自行执行任何操作，而是为客户端提供结构化的起点，以便 Agent 完成多步骤工作。

资源

服务提供近期 Webhook 上下文的 MCP 资源：

• webhooks://endpoints
• webhooks://endpoint/{slug}/recent
• webhooks://request/{id}

当客户端支持浏览资源或附加提示词／资源时，这些资源会很有用。

提供商支持

提供商模板和签名支持包括：

• stripe
• github
• shopify
• twilio
• slack
• paddle
• linear
• sendgrid
• clerk
• discord
• vercel
• gitlab
• typeform
• standard-webhooks
• meta
• lemonsqueezy
• coinbase-commerce
• razorpay
• cal
• intercom
• telegram
• square
• hubspot
• mailgun
• calendly
• mux
• sentry
• bitbucket
• docusign
• adyen
• paypal
• plaid
• resend
• workos

签名验证还支持：

• 除 sendgrid（IP 允许列表）和 plaid（JWT/JWK 验证需要 Plaid API 凭据）外的所有模板提供商

使用 list_provider_templates，即可从 Agent 检查模板、默认事件、签名标头和签名要求。

工作流示例

常见的 Agent 工作流：

• 创建临时端点，发送由提供商签名的 Webhook，并等待捕获请求
• 使用全文筛选器搜索各端点中保留的请求
• 比较两次 Webhook 尝试，并仅提取所需的 JSON 字段
• 使用已知密钥验证捕获请求的签名
• 运行 test_webhook_flow，通过一次工具调用完成创建、发送、捕获、验证、重放和清理

编程使用

如果要自行嵌入服务，软件包还导出了 createServer()、registerTools()、registerPrompts() 和 registerResources()。

import { createServer } from "@webhooks-cc/mcp";
import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";

const server = createServer({
  apiKey: process.env.WHK_API_KEY!,
  baseUrl: process.env.WHK_BASE_URL,
  webhookUrl: process.env.WHK_WEBHOOK_URL,
});

await server.connect(new StdioServerTransport());

对话示例

You: Create an ephemeral endpoint for GitHub webhook testing.

Agent: Created endpoint https://go.webhooks.cc/w/abc123 and marked it ephemeral.

You: Preview the signed request for a push event before sending it.

Agent: Here is the exact method, headers, and JSON body that would be sent.

You: Send it, wait for two requests, and compare them.

Agent: Sent the webhook, captured two requests, and here are the header and body differences.

文档

完整文档：webhooks.cc/docs/mcp

许可证

MIT