# Hooklistener

> Hooklistener is a freemium MCP server for developer tools. Hosted webhook, email, WebSocket and tunnel testing with 67 tools for coding agents. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Starting price:** $12 a month
- **Platforms:** Web, API, CLI
- **Website:** https://www.hooklistener.com/mcp
- **Repository:** https://github.com/hooklistener/mcp
- **MCP Registry name:** com.hooklistener/mcp
- **Categories:** developer tools
- **Listing updated:** 2026-11-16

## About

Hooklistener is a webhook debugger, and its hosted MCP server lets an agent run the whole test loop: create a public endpoint, wait for the next matching webhook as a durable task, verify its signature, diagnose it and replay it to localhost with an edited body. Signature checks cover Stripe, GitHub and Slack. Response rules can return custom status codes or bodies to simulate failures, and an anomaly tool reports new event types, missing fields and volume drops.

The 67 tools come in seven toolsets: webhooks, rules and threads, replay cases and suites, real-time endpoints for WebSocket, Socket.IO, MQTT and SSE, email inboxes, tunnels and monitors. A new workspace lists 26 of them and the rest appear as you start using each product, unless you send a header to list them all. Saved requests can become regression suites replayed against localhost, staging or production.

Authentication is OAuth 2.1 with a choice of full access or read only, or an API key as a Bearer token. MCP access is included on every plan, including Free. Going over a monthly request allowance never drops a webhook.

## Features

- **Wait and verify:** Wait for a matching webhook and check its Stripe, GitHub or Slack signature.
- **Replay to localhost:** Forward or replay captured requests with edited bodies and re-signing.
- **Response rules:** Mock failures and retries with custom statuses, headers or bodies.
- **Regression suites:** Turn real webhooks into replayable cases with pass/fail reports.
- **Real-time endpoints:** Hosted WebSocket, Socket.IO, MQTT and SSE endpoints an agent can drive.
- **Email inboxes:** Test email flows alongside webhooks.

## Good for

- Test a Stripe or GitHub webhook handler end to end
- Replay a captured production webhook to local code
- Simulate a failing endpoint to check retry behaviour
- Build a regression suite from real webhook payloads
- Test a WebSocket client without writing a server

## Install

### Claude Code (Terminal)

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

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://app.hooklistener.com/api/mcp
```

### Cursor (~/.cursor/mcp.json)

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

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

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

## Tools

- `create_endpoint`: Create a debug endpoint and get a unique webhook URL.
- `wait_for_request`: Wait for a matching webhook as a durable task or hold the call open up to 60 seconds.
- `list_requests`: List or search captured webhooks by text, event type, status or time.
- `verify_request_signature`: Check Stripe, GitHub or Slack signatures against a stored secret.
- `replay_request`: Replay or forward a webhook to a URL or local tunnel with an edited body and optional re-signing.
- `diagnose_request`: A health verdict for one request covering response, body, rules and forwarding attempts.
- `create_response_rule`: Return a different status, headers or body when a request matches conditions.
- `test_response_rules`: Evaluate ordered rules against a synthetic request.
- `set_thread_rule`: Correlate requests by a field such as an order or payment ID.
- `list_endpoint_anomalies`: Show new event types, missing fields, type changes and volume drops.
- `save_request_case`: Save a captured request as a replayable case with assertions.
- `run_endpoint_cases`: Replay a case or suite against localhost, staging or production.
- `wait_for_case_run`: Wait for a run to finish and read a per-case pass/fail report.
- `create_realtime_endpoint`: Create a hosted WebSocket, Socket.IO, MQTT-over-WebSocket or SSE endpoint.
- `wait_for_realtime_message`: Wait until a client sends or receives a message containing expected text.
- `send_realtime_message`: Push a message or event to connected clients.

## FAQ

### Is MCP access free?

Yes, MCP access is included on every plan including Free, though tools follow the plan's limits.

### How does authentication work?

OAuth 2.1 with PKCE, with full_access or read_only scopes, or an API key as a Bearer token.

### What happens if I exceed my request allowance?

Requests are still captured and never dropped; the organisation gets emails at 80% and 100%.

### How many tools are there?

67 in seven toolsets, with 26 listed in a new workspace by default.

### Is Hooklistener free?

Hooklistener has a free plan, with paid plans for more usage or features. Paid plans start at $12 a month.

### How do I add Hooklistener to Claude Code?

Run this command in your terminal: claude mcp add --transport http mcp https://app.hooklistener.com/api/mcp

### What are the best alternatives to Hooklistener?

The closest alternatives to Hooklistener are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/hooklistener
