Pipehero

O Pipehero cria um túnel do seu localhost para uma URL pública e captura todos os webhooks, permitindo que você os inspecione, reproduza e depure — inclusive a partir do seu agente de IA via MCP.

Documentação

Pipehero — servidor MCP + skill

Pipehero cria um túnel do seu localhost para uma URL pública e captura cada webhook, para que você possa inspecionar, reproduzir e depurar — inclusive a partir do seu agente de IA via MCP.

Este repositório é publicado automaticamente a partir do código-fonte do Pipehero. Ele contém o manifesto público do MCP e a skill do agente. Issues/PRs são bem-vindos.

Conecte o servidor MCP

Permita que um agente (Claude Code, Cursor, Copilot, Windsurf, Zed, …) liste seus túneis, leia webhooks capturados e os reproduza em localhost.

Remoto — recomendado (sem instalação, OAuth)

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

Seu cliente abre o navegador para você entrar e aprovar — sem necessidade de colar token.

Para CI/headless, passe um token de https://pipehero.app/dashboard/settings:

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

Local — via CLI

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

Qualquer cliente MCP funciona — adicione-o ao .cursor/mcp.json, claude_desktop_config.json, etc.:

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

Ferramentas

FerramentaO que faz
list_tunnelsSeus túneis e se cada um está online.
list_requests(subdomain)Webhooks capturados recentemente para um túnel.
get_request(subdomain, id)Requisição + resposta completas (cabeçalhos + corpo).
replay_request(subdomain, id)Reproduz um webhook no seu localhost.
start_tunnel(name, port)Expõe uma porta local em uma URL pública (somente MCP local).
stop_tunnel(name)Interrompe um túnel iniciado com start_tunnel (somente MCP local).
list_api_collections, get_api_collection(collection_id)Suas documentações de API salvas: pastas, endpoints, ambientes (MCP remoto, e local a partir da 0.1.14).
get_api_endpoint(collection_id, method + path)Um endpoint completo, com sua versão e exemplos de resposta.
upsert_api_endpoint(collection_id, method, path, …)Cria ou atualiza um endpoint por rota, para que a documentação acompanhe seu código.
add_api_example(collection_id, method + path, name, status, …)Salva um exemplo de resposta.
delete_api_endpoint(collection_id, method + path)Remove um endpoint cuja rota não existe mais.
import_api_spec(format, content) / export_api_collection(collection_id)OpenAPI, Postman e curl, nos dois sentidos.
run_api_endpoint(collection_id, method + path, environment)Envia e lê a resposta real.
save_captured_request(collection_id, tunnel, request_id)Transforma uma requisição real capturada em documentação, sem credenciais.
check_api_drift(collection_id, tunnel)Compara a documentação com o tráfego real (Pro/Team).
list_api_monitors(collection_id)Quais endpoints estão monitorados e quais estão falhando, com o último erro (Pro/Team).
list_api_proposalsO que aconteceu com suas alterações propostas, em workspaces que revisam alterações de IA.

Como seu agente tem tanto o webhook capturado quanto seu código-fonte, ele pode explicar por que um handler falhou — e então corrigi-lo e reproduzir para confirmar.

Skill

Instale a skill para que seu agente saiba quando e como usar o Pipehero:

pipehero skill install

ou copie SKILL.md para ~/.claude/skills/pipehero/SKILL.md.

Licença

MIT