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.