Skip to main content

Documentation Index

Fetch the complete documentation index at: https://handler.alduncanson.com/llms.txt

Use this file to discover all available pages before exploring further.

​
Quickstart

​
Install Handler

uv tool install a2a-handler
If you prefer not to install it globally, you can run it directly: 
uvx --from a2a-handler handler --help

​
Start with the TUI

handler tui
The TUI is the easiest place to browse cards, inspect tasks, and manage auth for a connection interactively.

​
Try the CLI

handler card get http://localhost:8000
handler message send http://localhost:8000 "hello"

​
Save a named server

Named servers let you reuse a URL and auth configuration instead of typing them on every command. 
handler server add demo --url http://localhost:8000
To store a server in the repository instead of your global config: 
handler server add demo --url http://localhost:8000 --repository
That creates or updates a .handler/servers.toml file at the git root.

​
Inspect configured servers

handler server list
handler server show demo
handler server validate

​
Keep the conversation going

Once you have a live task or saved conversation, you can keep using the same context from the CLI: 
handler message send --server demo --text "Hello"
handler message send --server demo --text "Follow up" --continue
handler session show --server demo
See Messages, tasks, and sessions for the full flow.

​
Bridge Handler into MCP clients

If you want Claude Desktop, Cursor, or another MCP client to use Handler’s A2A tools, start the MCP server: 
handler mcp
See MCP server for transport options and client setup.

​
Preview these docs locally

Install the Mintlify CLI, then run the preview server from the docs/ directory where docs.json lives: 
npm i -g mint
cd docs
mint dev
Once the Mintlify GitHub app is connected to this repository, pushes to main deploy documentation changes automatically.