Hooklistener

com.hooklistener由 hooklistener.com 发布官方发布者v1.0.1更新于 Oct 24, 2026

Webhook, email, WebSocket and tunnel testing for AI agents: capture, wait, verify, replay.

已验证Streamable HTTP可网页运行开发者工具安全与监控

概览

AI 生成的概览

托管型 MCP 服务器，让 AI 代理创建 webhook 地址、等待并校验传入请求，并可将请求重放到本地服务。

可以做什么
创建和管理 webhook 端点、告警与异常检查，以及模拟响应规则和请求线程。等待、列出、搜索、查看和诊断捕获的请求，包括重试排查。校验签名（Stripe、GitHub、Slack）、按 JSON Schema 校验载荷、比较请求差异，并编辑后重新签名再重放或转发到本地。将请求保存为重放用例和套件并对端点运行。创建实时端点（WebSocket、Socket.IO、MQTT、SSE）并等待或发送消息。创建邮箱并等待和读取邮件，规划本地隧道，运行可用性监控，并管理密钥和任务。
适用场景
适合代理在开发或调试接收 webhook、邮件或实时消息的集成时使用，需要公网地址、捕获流量、校验签名并重放到本地服务器。也适用于测试注册验证邮件流程和监控端点可用性。
运行要求
远程 Streamable HTTP 端点，无需本地安装。使用 OAuth 2.1（PKCE 与动态客户端注册），申请 full_access 或 read_only 权限范围；不支持 OAuth 的客户端可用 Hooklistener API 密钥作为 Bearer 令牌。所有套餐（含免费版）均可用，且无需账号即可创建临时 webhook 地址。
安装前请注意
完整权限允许代理创建、编辑、删除、重放、转发和发送数据；如需限制请申请 read_only 权限。重放和转发会发送真实 webhook 流量，删除为两步操作并需 dry_run 预览。服务器会存储捕获的流量（含请求头、Cookie 和请求体），数据按组织隔离并托管在欧洲；结果中凭据会被遮蔽，但仍会经过该服务。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Hooklistener，将其添加到工作区。
  2. 连接 所需的 凭据。它们会被私密存储，绝不会在公开页面上展示。
  3. 为需要使用其工具的对话启用该服务。

Web executable，通过 Streamable HTTP。 远程服务在工作区中配置后即可从网页运行时运行。

交给智能体安装

把这段提示词粘贴到 Claude Code、Codex、Cursor 等智能体，或 SourceWeft 对话中。智能体会读取该服务器的安装指南，先向你展示发布者、端点和登录方式，经你同意后再把它添加到你的客户端。密钥不会写进任何命令。

阅读 https://sourceweft.com/mcp/com.hooklistener%2Fmcp/install.md，并按其中说明把这个 MCP 服务器接入我的客户端。修改任何配置之前，先告诉我它的发布者、端点和登录方式，等我确认。不要把 API 密钥写进命令或我会提交的文件；问我密钥应从哪里获取。

查看智能体所依据的安装指南

其他 MCP 客户端

把它添加到你客户端的 mcpServers 配置中。 客户端会在首次连接时完成 OAuth 登录。

{
  "mcpServers": {
    "hooklistener": {
      "type": "http",
      "url": "https://app.hooklistener.com/api/mcp"
    }
  }
}

README

[Hooklistener]

Hooklistener MCP Server

Hosted MCP server that lets AI coding agents test webhooks end to end: create a public webhook URL, wait for the webhook to arrive, verify its signature, and replay it to localhost. The same server also covers email inboxes, WebSocket/Socket.IO/MQTT/SSE endpoints, localhost tunnels and uptime monitors.

  • Endpoint: https://app.hooklistener.com/api/mcp
  • Transport: Streamable HTTP. Nothing to install or run locally.
  • Auth: OAuth 2.1 with PKCE and dynamic client registration. Clients request full_access or read_only. A Hooklistener API key (hklst_…) also works as a Bearer token for clients without OAuth.
  • Tools: 67, in 7 toolsets. A new workspace lists 26 of them (every webhook tool plus the tool that starts each other product); a toolset appears once you use that product. Send x-hooklistener-toolsets: all to list everything.
  • Plans: works on every plan, including Free.

This repository holds the setup instructions and the MCP Registry entry (server.json). The server itself is operated by Hooklistener.

Connect your client

Claude Code

bash
claude mcp add --transport http hooklistener https://app.hooklistener.com/api/mcp

Then run /mcp in Claude Code, select hooklistener and sign in with your browser. Full guide

Codex

bash
codex mcp add hooklistener \  --url https://app.hooklistener.com/api/mcp \  --oauth-resource https://app.hooklistener.com/api/mcpcodex mcp login hooklistener --scopes full_access   # or read_only

Full guide

Cursor

.cursor/mcp.json:

json
{  "mcpServers": {    "hooklistener": { "url": "https://app.hooklistener.com/api/mcp" }  }}

Full guide

VS Code (GitHub Copilot)

.vscode/mcp.json:

json
{  "servers": {    "hooklistener": { "type": "http", "url": "https://app.hooklistener.com/api/mcp" }  }}

Full guide

Claude.ai and Claude Desktop

Customize → Connectors → + → Add custom connector → paste https://app.hooklistener.com/api/mcp → Add → Connect. Full guide

Cline

Cline documents bearer-token headers for remote servers, so use a Hooklistener API key (paid plans, created at Organization Settings → API Keys). In cline_mcp_settings.json:

json
{  "mcpServers": {    "hooklistener": {      "type": "streamableHttp",      "url": "https://app.hooklistener.com/api/mcp",      "headers": { "Authorization": "Bearer hklst_your_api_key" }    }  }}

Agents installing the server for you can follow llms-install.md.

Other clients

Step-by-step guides: ChatGPT · Gemini CLI · Windsurf · Zed · OpenCode · Grok (xAI API)

Any MCP client that supports Streamable HTTP can connect with the endpoint above.

What your agent can do

CategoryExamples
Debug endpointscreate_endpoint, get_endpoint, list_endpoint_anomalies, set_endpoint_alerts
Captured requestswait_for_request, list_requests (list or search), get_request, diagnose_request, investigate_request_retries
Verify, compare and replayverify_request_signature (Stripe, GitHub, Slack), validate_request (JSON Schema), diff_requests, replay_request (replay or forward, edit the body and re-sign)
Mock responsescreate_response_rule, test_response_rules
Request threadsset_thread_rule, list_request_threads
Replay cases and suitessave_request_case, run_endpoint_cases, wait_for_case_run
Real-time endpointscreate_realtime_endpoint (WebSocket, Socket.IO, MQTT, SSE), wait_for_realtime_message, send_realtime_message
Email inboxescreate_inbox, wait_for_email, get_email
Localhost tunnelsplan_tunnel_action, replay_tunnel_capture
Uptime monitorscreate_monitor, get_monitor_status
Secrets and taskscreate_secret, cancel_task

Every tool has a title and read-only/destructive annotations. Full reference: docs.hooklistener.com/mcp/available-tools

Example prompts

  • "Create a Hooklistener endpoint for Stripe, trigger a test checkout, and wait for checkout.session.completed."
  • "Verify that webhook's signature with my Stripe secret, then replay it to http://localhost:3000/webhooks, re-signed."
  • "Create an inbox, sign up with it on staging, and read me the verification code from the email."
  • "Save the last three webhooks as a replay suite and run it against localhost after my fix."

Safety

  • Read-only access: request the read_only scope and the agent can search, wait for, diff, validate and diagnose traffic, but can't create, edit, delete, replay, forward or send anything.
  • Deletes are two-step: preview with dry_run, then confirm.
  • Replays and forwards need an idempotency key, so a retried call never sends a webhook twice.
  • Credentials are masked in tool results: common secrets in headers, cookies, query strings and JSON bodies.
  • Data is scoped to your organization and hosted in Europe.

No account yet?

Agents can create a temporary webhook URL without an account, which the user can claim later. See app.hooklistener.com/llms.txt.

Links

来源：README.md，提交 d0b5ef0

工具

0
该服务器需要登录，因此 SourceWeft 无法在没有账号的情况下读取其工具，也未收录。已连接账号所能看到的内容可能因账号及其权限而异。

版本历史

2
  1. v1.0.1最新Sep 27, 2026
  2. v1.0.0Sep 26, 2026

评分

已满足适用检查项的 75%

该评分衡量此收录条目的完整程度，依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价，也不表示服务器安全或当前可用：可连通性是带日期的检查结果，评分也不包含安装量或用户评价。

  • 近 30 天内可连通必需25 分
  • 已声明认证方式必需10 分
  • 已列出工具15 分

    请让服务器在无凭据时响应 tools/list，或发布可在沙箱中无凭据启动的软件包。

  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分

    请在仓库或注册中心条目中声明许可证。