Pipehero

Official4 toolsLive

by pipehero

Debug webhooks from your AI agent: inspect and replay captured webhooks on localhost.

Topics

agentmcpskillstunneling

Captured live from the server via tools/list.

list_tunnels

List the user's Pipehero tunnels and whether each is currently online.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {}
}

list_requests

List recent webhooks/requests captured for a tunnel. Returns id, method, path, status and bodies.

Parameters1

subdomain

string

required

Raw schema

{
  "type": "object",
  "properties": {
    "subdomain": {
      "type": "string"
    }
  },
  "required": [
    "subdomain"
  ]
}

get_request

Get the full request and response (headers + body) of one captured webhook by id.

Parameters2

id	string	required
subdomain	string	required

Raw schema

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string"
    },
    "subdomain": {
      "type": "string"
    }
  },
  "required": [
    "subdomain",
    "id"
  ]
}

replay_request

Replay a captured webhook to the user's localhost (the tunnel CLI must be running).

Parameters2

id	string	required
subdomain	string	required

Raw schema

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string"
    },
    "subdomain": {
      "type": "string"
    }
  },
  "required": [
    "subdomain",
    "id"
  ]
}

README.md2 KBView on GitHub

Pipehero — MCP server + skill

Pipehero tunnels your localhost to a public URL and captures every webhook, so you can inspect, replay, and debug them — including from your AI agent via MCP.

This repo is auto-published from Pipehero's source. It holds the public MCP manifest and the agent skill. Issues/PRs welcome.

🌐 Website: https://pipehero.app
📚 Docs: https://pipehero.app/docs

Connect the MCP server

Let an agent (Claude Code, Cursor, Copilot, Windsurf, Zed, …) list your tunnels, read captured webhooks, and replay them to localhost.

Remote — recommended (no install, OAuth)

bash

claude mcp add --transport http pipehero https://mcp.pipehero.app/mcp

Your client opens the browser to sign in and approve — no token to paste.

For CI/headless, pass a token from https://pipehero.app/dashboard/settings:

bash

claude mcp add --transport http pipehero https://mcp.pipehero.app/mcp \
  --header "Authorization: Bearer <token>"

Local — via the CLI

bash

curl -fsSL https://pipehero.app/install | sh
pipehero login
claude mcp add pipehero -- pipehero mcp

Any MCP client works — add it to .cursor/mcp.json, claude_desktop_config.json, etc.:

json

{ "mcpServers": { "pipehero": { "command": "pipehero", "args": ["mcp"] } } }

Tools

Tool	What it does
`list_tunnels`	Your tunnels and whether each is online.
`list_requests(subdomain)`	Recent captured webhooks for a tunnel.
`get_request(subdomain, id)`	Full request + response (headers + body).
`replay_request(subdomain, id)`	Replay a webhook to your localhost.
`start_tunnel(name, port)`	Expose a local port on a public URL (local MCP only).
`stop_tunnel(name)`	Stop a tunnel started with `start_tunnel` (local MCP only).

Because your agent has both the captured webhook and your codebase, it can explain why a handler failed — then fix it and replay to confirm.

Skill

Install the skill so your agent knows when and how to use Pipehero:

bash

pipehero skill install

or copy SKILL.md into ~/.claude/skills/pipehero/SKILL.md.

License

MIT

Install

Tools (4)

list_tunnelslist_requestsget_requestreplay_request

Remote endpoint

Streamable HTTP

Hosted server - connect over the network, no local install.

url

https://mcp.pipehero.app/mcp

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "pipehero": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.pipehero.app/mcp"
      ]
    }
  }
}

Desktop config is stdio-only; this bridges via mcp-remote. Native remote: Settings > Connectors.