Handler MCP server
Commit 9. Nov. 2026Ermöglicht es AI-Clients und Engineers, A2A-Agents über ein Terminal oder eine CLI zu verbinden, zu kontaktieren und zu verwalten.
Auch bekannt als alDuncanson/Handler
- Stars
- 47
- Tools
- —
- Downloads, 30 Tage
- —
- Neueste Version
- —
- Letzter Commit
- 9. Nov. 2026
- Lizenz
- MIT
Was ist Handler MCP?
Handler ist ein MCP server. Ermöglicht es AI-Clients und Engineers, A2A-Agents über ein Terminal oder eine CLI zu verbinden, zu kontaktieren und zu verwalten.
Zusammenfassung generiert aus dem README des Projekts
Über Handler MCP server
Handler ermöglicht es Software Engineers, die agentische Systeme bauen, sich mit A2A-Agents zu verbinden und diese direkt aus dem Terminal heraus zu verwalten. Es bietet die Möglichkeit, über ein interaktives TUI, eine skriptbare CLI mit strukturiertem Output oder als MCP server zu kommunizieren, der es anderen Agents erlaubt, sich in A2A-Services zu integrieren. Das Tool unterstützt verschiedene Authentifizierungsmethoden wie Bearer Tokens, API Keys, HTTP Basic, mTLS, OAuth2 Client Credentials und OpenID Connect.
User können mit Agents interagieren, indem sie Text, Dateien (via URL oder inline) und strukturierte Daten senden. Der Server übernimmt das Streaming von Antworten, das Stoppen laufender Tasks und das Antworten auf Agents, die auf Input warten. Er verwaltet zudem den Task-Lifecycle, indem er es Usern erlaubt, Tasks aufzulisten, zu inspizieren, abzubrechen oder neu zu abonnieren. Für Entwickler, die Notifications verwalten müssen, ist ein lokaler Webhook-Receiver enthalten, um Push-Notification-Konfigurationen zu handhaben.
Was du damit machen kannst
- 1Agent-Tasks via Terminal verwaltenFordere einen AI-Client auf, aktive Tasks auf einem A2A-Server aufzulisten oder abzubrechen.
Geschrieben aus dem README des Projekts. Jeder Use Case wurde gegen ein Zitat daraus geprüft.
Automatisierte Checks
Geluften am 14. Nov. 2026Vollständiger Bericht →Noch nicht verifiziert. Ein Server benötigt einen Score von 80, keine kritischen Befunde und genug Daten für unsere Prüfung. Wie die Checks funktionieren · Was du für mehr Punkte verbessern kannst
- Source Repository verknüpft und erreichbaralduncanson/handler is public and reachablegithub.com/alduncanson/handler ↗Bestanden
- Paket nennt dieses Repository als QuelleNicht geprüft
- Build-Provenienz (Sigstore-Attestierung)Nicht geprüft
- Open Source Lizenz (OSI)MITspdx.org/licenses/MIT.html ↗Bestanden
- Commit oder Release im letzten JahrLast commit or release 2026-11-09github.com/alduncanson/handler ↗Bestanden
- OpenSSF ScorecardNicht geprüft
- Package-Name ähnelt keinem populären PackageNicht geprüft
- Keine kritischen Advisories im Paket oder seinen AbhängigkeitenNicht geprüft
- Keine versteckten Anweisungen an das Modell0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersBestanden
- Destruktive Tools sind markiertNicht geprüft
- Remote-Endpoint beantwortet den MCP-HandshakeNicht geprüft
README
Auf GitHub ansehenHandler
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.
Handler MCP Fragen
Was ist Handler?
Handler ist ein Open-Source A2A-Protokoll-Client mit einem interaktiven TUI, einer skriptbaren CLI und einem MCP server.
Welche Authentifizierungsmethoden unterstützt Handler?
Es unterstützt Bearer Tokens, API Keys, HTTP Basic, mTLS, OAuth2 Client Credentials und OpenID Connect.
Wie installiere ich Handler?
Installiere es über PyPI als uv tool, mit pipx oder mit pip.
Wie kann ich die Agent Card eines A2A-Servers einsehen?
Führe den Befehl card get mit der Server-URL aus.
Welche Transports unterstützt Handler?
Standardmäßig nutzt es JSON-RPC und HTTP+JSON, gRPC mit dem grpc extra, und kann die Agent Card die Wahl lassen.