Pipehero

Pipehero tunela tu localhost a una URL pública y captura cada webhook, para que puedas inspeccionarlos, reproducirlos y depurarlos, incluso desde tu agente de IA mediante MCP.

Documentación

Pipehero — servidor MCP + skill

Pipehero tuneliza tu localhost a una URL pública y captura cada webhook, para que puedas inspeccionar, reproducir y depurar — incluso desde tu agente de IA mediante MCP.

Este repositorio se publica automáticamente desde el código fuente de Pipehero. Contiene el manifiesto público de MCP y el skill del agente. Issues/PRs bienvenidos.

Conecta el servidor MCP

Permite que un agente (Claude Code, Cursor, Copilot, Windsurf, Zed, …) liste tus túneles, lea webhooks capturados y los reproduzca en localhost.

Remoto — recomendado (sin instalación, OAuth)

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

Tu cliente abre el navegador para iniciar sesión y aprobar — sin necesidad de pegar tokens.

Para CI/headless, pasa un token desde https://pipehero.app/dashboard/settings:

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

Local — mediante la CLI

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

Cualquier cliente MCP funciona — agrégalo a .cursor/mcp.json, claude_desktop_config.json, etc.:

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

Herramientas

HerramientaQué hace
list_tunnelsTus túneles y si cada uno está en línea.
list_requests(subdomain)Webhooks capturados recientes para un túnel.
get_request(subdomain, id)Solicitud + respuesta completas (encabezados + cuerpo).
replay_request(subdomain, id)Reproduce un webhook en tu localhost.
start_tunnel(name, port)Expone un puerto local en una URL pública (solo MCP local).
stop_tunnel(name)Detiene un túnel iniciado con start_tunnel (solo MCP local).
list_api_collections, get_api_collection(collection_id)Tus documentos de API guardados: carpetas, endpoints, entornos (MCP remoto, y local desde 0.1.14).
get_api_endpoint(collection_id, method + path)Un endpoint completo, con su versión y ejemplos de respuesta.
upsert_api_endpoint(collection_id, method, path, …)Crea o actualiza un endpoint por ruta, para que los documentos sigan tu código.
add_api_example(collection_id, method + path, name, status, …)Guarda un ejemplo de respuesta.
delete_api_endpoint(collection_id, method + path)Elimina un endpoint cuya ruta ya no existe.
import_api_spec(format, content) / export_api_collection(collection_id)OpenAPI, Postman y curl, en ambos sentidos.
run_api_endpoint(collection_id, method + path, environment)Envíalo y lee la respuesta real.
save_captured_request(collection_id, tunnel, request_id)Convierte una solicitud real capturada en documentación, sin credenciales.
check_api_drift(collection_id, tunnel)Compara la documentación con el tráfico real (Pro/Team).
list_api_monitors(collection_id)Qué endpoints están monitoreados y cuáles fallan, con el último error (Pro/Team).
list_api_proposalsQué pasó con tus cambios propuestos, en espacios de trabajo que revisan cambios de IA.

Como tu agente tiene tanto el webhook capturado como tu código, puede explicar por qué falló un handler — y luego corregirlo y reproducirlo para confirmar.

Skill

Instala el skill para que tu agente sepa cuándo y cómo usar Pipehero:

pipehero skill install

o copia SKILL.md en ~/.claude/skills/pipehero/SKILL.md.

Licencia

MIT