Webhook Studio

Webhook Studio

Agent 可驱动的 Webhook 流水线，无需密钥。 创建真实端点，等待服务商事件，将事件重放到 localhost，转发到你的应用，并根据你实际捕获的载荷生成类型。既适合排查 Webhook 问题的开发者，也适合构建集成的 AI Agent。

→ 应用： https://webhook-studio.com  ·  文档： https://webhook-studio.com/docs  ·  Agent 规范（llms.txt）： https://webhook-studio.com/llms.txt

---

三项工作，一个 URL

• 调试 — 无需注册的端点、包含完整标头和原始正文的实时收件箱，以及每个请求的签名验证结果。
• 路由 — 使用 AND/OR 条件将匹配的事件转发到你的后端，并支持持久化重试：因崩溃或部署而中断的投递会从持久化记录中重新驱动，而不会被悄然丢弃。
• 了解 — 每个事件都会更新持久化模型，准确反映服务商实际发送给你的账户的内容。请求 TypeScript / Zod / JSON-Schema 类型时，可选字段会基于你的流量中确实有时缺失的字段；询问两个版本之间有哪些变化，即可获得破坏性变更差异。没有其他 Webhook 工具能做到这一点。 客观比较：https://webhook-studio.com/compare

在你的 AI 工具中使用（MCP）

Webhook Studio 是一个远程 MCP 服务（Streamable HTTP，无状态）。只需添加一个 URL：

claude mcp add --transport http webhook-studio https://webhook-studio.com/mcp \
  --header "Authorization: Bearer $(curl -s -X POST https://webhook-studio.com/api/start | jq -r .api_token)"

该 curl 命令会生成一个无需密钥的读取与重放令牌（无需注册），并绑定到一个全新的 3 天端点。若要获得完整访问权限 — 创建端点、配置验证、搭建转发 — 请使用控制面板中的 ws_live_… 密钥。

也可以将其添加到客户端的 MCP 配置中（~/.cursor/mcp.json、.vscode/mcp.json、 claude_desktop_config.json）— 每个客户端的完整设置指南：https://webhook-studio.com/mcp/setup：

{
  "mcpServers": {
    "webhook-studio": {
      "url": "https://webhook-studio.com/mcp",
      "headers": { "Authorization": "Bearer ws_live_your_key_here" }
    }
  }
}

Authorization 标头为可选 — 可省略以建立公共连接（使用接受 ws_anon_… 令牌的读取/重放工具），也可设置 ws_live_… 密钥以使用完整工具集。

已列入官方 MCP Registry，名称为 com.webhook-studio/webhooks。 清单文件位于此仓库的 server.json。

工具

按任务划分，而非按资源划分 — 根据目的选择：

create_bucket · list_buckets · get_bucket · delete_bucket	创建和管理端点
latest_event · list_events · get_event · wait_for_event	读取事件；阻塞等待事件到达
replay_event · forward_bucket · list_deliveries	重放到 localhost、转发、检查结果
configure_verification	使用服务商的真实密钥启用 HMAC
list_schemas · get_schema · diff_schema · generate_types · find_correlation_keys	知识层

每个工具都与一个 /v1 REST 路由一一对应，因此 REST 参考也可作为工具参考。

一次调用即可免密使用（无需 MCP 客户端）

curl -X POST https://webhook-studio.com/api/start
# → { ingest_url, inbox_url, api_token: "ws_anon_…", expires_in_days: 3, ... }

将 ingest_url 提供给服务商，将 inbox_url 提供给用户，并使用 api_token 通过 /v1 或 /mcp 读取和重放。完整 Agent 指南：https://webhook-studio.com/llms.txt

服务商指南

每个服务商都提供一键测试 URL 和正确的签名验证代码片段：

• Stripe
• GitHub

许可证

此仓库中的文档和示例采用 MIT 许可证。托管产品为专有软件。