Home / Use Cases / Hand off a task between two agents
Use case3-step workflow

Hand off a task between two agents

Pass an in-progress task to another agent with context, and let the receiving agent pick up where it left off.

Workflow

Step 1 of 3

Request Handoff

Package the task, context, and a callback URL for the next agent.

request_handoff({"task": "example"})
Step 2 of 3

Set Focus

Have the receiving agent record the handed-off task as its new focus.

set_focus({"handle": "my-agent", "task": "example"})
Step 3 of 3

Send Message

Notify the original agent once the handoff is accepted.

send_message({"to": "example", "body": "example"})

Install

One command wires up every tool below for Claude Code:

claude mcp add --transport http wingman https://wingmanprotocol.com/mcp

Claude Desktop, Cursor and Continue configs are on /install. A free key (500 calls/month, no card) is on /pricing; beyond that it is x402 pay-per-call in USDC on Base.