Skip to main content

Handler

CI A2A Protocol PyPI version PyPI - Status Pepy total downloads GitHub stars

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, mTLS, and OAuth2 client credentials auth.

Handler TUI connected to an A2A agent, showing the agent card and a completed assistant response

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"

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.

Release files for a2a-handler 0.2.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for a2a-handler 0.2.0
File Size Uploaded
a2a_handler-0.2.0.tar.gz 94.3 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for a2a-handler 0.2.0
File Interpreter ABI Platform
a2a_handler-0.2.0-py3-none-any.whl Python 3 none any Details

Total release size: 210.3 kB

Release files / a2a_handler-0.2.0.tar.gz

Download URL a2a_handler-0.2.0.tar.gz
Size 94.3 kB
Tags Source
SHA-256 checksum
How to use checksums
c71d586ac4126547fb0734680feee4284c6024088c0d0dd8adbde7f772899b7a
BLAKE2b-256 checksum
How to use checksums
3d533c8b1c1eb929d1810ee914cb6e269917bd8fe3639a07d7b2dd90b7d6b38d
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via uv/0.12.5 {"installer":{"name":"uv","version":"0.12.5","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

Release files / a2a_handler-0.2.0-py3-none-any.whl

Download URL a2a_handler-0.2.0-py3-none-any.whl
Size 116.0 kB
Tags Python 3
SHA-256 checksum
How to use checksums
bd0c61592d89ec6e5ba9b41705ed8a9e8d048f4b58ab3bc15b731a5331b8168a
BLAKE2b-256 checksum
How to use checksums
078697d5ba55da568e95f716bdd2aa988286a4f18fc1d784b261b2928f782cd6
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via uv/0.12.5 {"installer":{"name":"uv","version":"0.12.5","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

Release history Release notifications | RSS feed

This release

0.2.0 This release

2 release files

0.1.26

2 release files

0.1.25

2 release files

0.1.24

2 release files

0.1.23

2 release files

0.1.22

2 release files

0.1.21

2 release files

0.1.20

2 release files

0.1.19

2 release files

0.1.16

2 release files

0.1.15

2 release files

0.1.13

2 release files

0.1.12

2 release files

0.1.11

2 release files

0.1.10

2 release files

0.1.9

2 release files

0.1.8

2 release files

0.1.7

2 release files

0.1.6

2 release files

0.1.4

2 release files

0.1.3

2 release files

0.1.2

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page