Handler MCP server
Commit Nov 9, 2026Lets AI clients and engineers connect to, message, and manage A2A agents from a terminal or CLI.
Also known as alDuncanson/Handler
- Stars
- 47
- Tools
- —
- Downloads, 30 days
- —
- Latest version
- —
- Last commit
- Nov 9, 2026
- License
- MIT
What is Handler MCP?
Handler lets AI clients and engineers connect to, message, and manage A2A agents from a terminal or CLI.
Summary generated from the project's README
About Handler MCP server
Connecting to and managing A2A agents from a terminal is what Handler enables for software engineers building agentic systems. It provides a way to communicate with agents through an interactive TUI, a scriptable CLI with structured output, or as an MCP server that allows other agents to integrate with A2A services. This tool supports various authentication methods including bearer tokens, API keys, HTTP Basic, mTLS, OAuth2 client credentials, and OpenID Connect.
Users can interact with agents by sending text, files via URL or inline, and structured data. The server handles streaming replies, stopping running tasks, and answering agents that pause for input. It also manages task lifecycles by allowing users to list, inspect, cancel, and resubscribe to tasks. For developers needing to manage notifications, it includes a bundled local webhook receiver to handle push notification configurations.
What you can do with it
- 1Manage agent tasks via terminalAsk an AI client to list or cancel active tasks running on an A2A server.
Written from the project's README. Every use case is checked against a quote from it.
Automated checks
Ran Nov 14, 2026Full report →Not verified yet. A server needs a score of 80, no serious finding, and enough data for us to check. How checks work · What to fix for more points
- Source repository linked and reachablealduncanson/handler is public and reachablegithub.com/alduncanson/handler ↗Pass
- Package names this repository as its sourceNot checked
- Build provenance (Sigstore attestation)Not checked
- Open source license (OSI)MITspdx.org/licenses/MIT.html ↗Pass
- Commit or release in the last yearLast commit or release 2026-11-09github.com/alduncanson/handler ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNot checked
- No critical advisory in the package or its dependenciesNot checked
- No hidden instructions to the model0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNot checked
- Remote endpoint answers the MCP handshakeNot checked
README
View on 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.
Handler MCP questions
What is Handler?
Handler is an open-source A2A protocol client with an interactive TUI, a scriptable CLI, and an MCP server.
Which authentication methods does Handler support?
It supports bearer tokens, API keys, HTTP Basic, mTLS, OAuth2 client credentials, and OpenID Connect.
How do I install Handler?
Install it from PyPI as a uv tool, with pipx, or with pip.
How do I inspect an A2A server's agent card?
Run the card get command with the server URL.
Which transports does Handler support?
It speaks JSON-RPC and HTTP+JSON by default, gRPC with the grpc extra, and can let the agent card choose.