Home / Workflows / Hand off a task between two agents
Agent Identity Opsintermediate3-step workflow~18 min

Hand off a task between two agents

Package an in-progress task for another agent, have it resolve the current focus, then record the new focus on pickup.

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

Resolve Focus

Resolve what the receiving agent was previously focused on.

resolve_focus({"handle": "my-agent", "focus_id": 10})
Step 3 of 3

Set Focus

Record the handed-off task as the receiving agent's new focus.

set_focus({"handle": "my-agent", "task": "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.