MCP server de Handler
Commit 9 nov 2026Permite que ingenieros y clientes de IA se conecten, envíen mensajes y gestionen agentes A2A desde una terminal o CLI.
También conocido como alDuncanson/Handler
- Stars
- 47
- Herramientas
- —
- Descargas, 30 días
- —
- Última versión
- —
- Último commit
- 9 nov 2026
- Licencia
- MIT
¿Qué es Handler MCP?
Handler es un MCP server. Permite que ingenieros y clientes de IA se conecten, envíen mensajes y gestionen agentes A2A desde una terminal o CLI.
Resumen generado a partir del README del proyecto
Acerca del MCP server de Handler
Handler permite a los ingenieros de software que construyen sistemas agénticos conectarse y gestionar agentes A2A desde una terminal. Proporciona una forma de comunicarse con los agentes a través de una TUI interactiva, una CLI programable con salida estructurada, o como un MCP server que permite a otros agentes integrarse con servicios A2A. Esta herramienta admite varios métodos de autenticación, incluyendo bearer tokens, API keys, HTTP Basic, mTLS, OAuth2 client credentials y OpenID Connect.
Los usuarios pueden interactuar con los agentes enviando texto, archivos mediante URL o inline, y datos estructurados. El servidor gestiona respuestas en streaming, la detención de tareas en ejecución y la respuesta a agentes que se pausaron esperando una entrada. También gestiona el ciclo de vida de las tareas permitiendo a los usuarios listarlas, inspeccionarlas, cancelarlas y volver a suscribirse a ellas. Para los desarrolladores que necesitan gestionar notificaciones, incluye un receptor de webhook local integrado para manejar configuraciones de notificaciones push.
Qué puedes hacer con él
- 1Gestionar tareas de agentes vía terminalPide a un cliente de IA que liste o cancele tareas activas que se estén ejecutando en un servidor A2A.
Escrito a partir del README del proyecto. Cada caso de uso se verifica con una cita del mismo.
Verificaciones automáticas
Ejecutado 14 nov 2026Informe completo →Aún no verificado. Un servidor necesita una puntuación de 80, ningún hallazgo grave y suficientes datos para que podamos revisarlo. Cómo funcionan las verificaciones · Qué corregir para obtener más puntos
- Repositorio de origen vinculado y accesiblealduncanson/handler is public and reachablegithub.com/alduncanson/handler ↗Aprobado
- El paquete indica este repositorio como su origenNo verificado
- Procedencia de la compilación (atestación de Sigstore)No verificado
- Licencia de código abierto (OSI)MITspdx.org/licenses/MIT.html ↗Aprobado
- Commit o lanzamiento en el último añoLast commit or release 2026-11-09github.com/alduncanson/handler ↗Aprobado
- OpenSSF ScorecardNo verificado
- El nombre del paquete no es similar a un paquete popularNo verificado
- No hay avisos críticos en el paquete ni en sus dependenciasNo verificado
- Sin instrucciones ocultas para el modelo0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersAprobado
- Las herramientas destructivas están etiquetadasNo verificado
- El endpoint remoto responde al handshake de MCPNo verificado
README
Ver en GitHubHandler
Handler is an open-source A2A protocol client for software engineers building, testing, and operating agentic systems. It provides an interactive TUI, a scriptable CLI with structured output, and an MCP server that lets other agents integrate with A2A services directly. Handler also supports global and repo-scoped A2A server configuration with bearer, API key, HTTP Basic, mTLS, OAuth2 client credentials, and OpenID Connect auth.

Features
- Streams replies as they arrive, in the TUI and the CLI, and can stop a running task or answer an agent that pauses for input
- Sends text, files (inline or by URL), and structured data, and shows the file and data parts agents send back
- Lists, inspects, cancels, and resubscribes to tasks, and manages push notification configs with a bundled local webhook receiver
- Speaks JSON-RPC and HTTP+JSON out of the box, gRPC with the
grpcextra, and lets the agent card pick the transport - Requests A2A extensions and fetches the extended card an agent offers to authenticated clients
- Keeps credentials on the origin you configured, never on a host an agent card happens to name
Install
Install Handler from the PyPI package as a uv tool:
uv tool install a2a-handler
Or with pipx:
pipx install a2a-handler
Or with pip:
pip install a2a-handler
Quick Start
Open the interactive terminal UI:
handler tui
Inspect an A2A server's agent card:
handler card get --url http://localhost:8000
Send a message from the CLI:
handler message send --url URL --text "hello"
Stream the reply, with a file attached:
handler message stream --url URL --text "Review this" --file ./report.pdf
List the agent's tasks:
handler task list --url URL
Open the full documentation:
handler docs
Run Without Installing
Run Handler with uvx:
uvx --from a2a-handler handler
Run Handler with pipx:
pipx run a2a-handler
Documentation
Read the documentation at https://handler.alduncanson.com.
For coding agents
The docs ship as an agent skill, regenerated on every deploy. Install it into
Claude Code, Cursor, Windsurf, or any agent that reads the SKILL.md format:
npx skills add https://handler.alduncanson.com
Or fetch it by hand from https://handler.alduncanson.com/skill.md. For live lookups, agents can also use the hosted documentation MCP server at https://handler.alduncanson.com/mcp or the page index at https://handler.alduncanson.com/llms.txt. See the agent skill guide.
Preguntas sobre Handler MCP
¿Qué es Handler?
Handler es un cliente de protocolo A2A de código abierto con una TUI interactiva, una CLI programable y un MCP server.
¿Qué métodos de autenticación admite Handler?
Soporta bearer tokens, API keys, HTTP Basic, mTLS, OAuth2 client credentials y OpenID Connect.
¿Cómo instalo Handler?
Instálalo desde PyPI como una herramienta uv, con pipx o con pip.
¿Cómo puedo inspeccionar la agent card de un servidor A2A?
Ejecuta el comando card get con la URL del servidor.
¿Qué transportes admite Handler?
Utiliza JSON-RPC y HTTP+JSON por defecto, gRPC con el extra de grpc, y permite que la agent card elija el método.