← Alle MCP-Tools

Hand off task

handoff_task
Schreiben

Was es tut

Pass a task you own to ANOTHER named agent on the roster, mid-flow — e.g. you built the lead list, now it's Instinct's outreach. The task moves to that agent's queue immediately: your claim is released, it returns to not_started so their next_task picks it up, and your note is posted to the thread. The whole task — notes, criteria, deliverables, comments — travels with it, so put in the note what's done, what's next and where your output is. agent_ok is reset to false on every handoff: trust a human granted for your part doesn't carry to the next agent's, so they end at propose_completion unless a human turns it back on. Refused for: a task not in your lane, handing to yourself, an agent not on the roster (see list_agents), and tasks waiting on a human (pending_approval, plan_proposed) or closed. To give work back to nobody, use decline_task instead. Only on accounts with an agent roster.

Parameter

NameTypPflichtBeschreibung
idstringPflicht
tostringPflicht

The receiving agent's name, as list_agents returns it (case-insensitive).

notestringPflicht

What you did, what's left, where your output lives. Posted as a comment.

agentstringOptional

Your agent id when running as part of a fleet — the one you claimed with. Handing off fails while a different agent holds an active lease.

Annotationen

Die Hinweise, die der Server mit diesem Tool mitschickt. Ein Client liest sie, um zu entscheiden, ob er dich vor einem Aufruf fragt.

Nur lesenreadOnlyHint: false
Ändert Daten in deinem Done-Konto.
DestruktivdestructiveHint: false
Fügt nur hinzu oder liest; nichts Bestehendes wird entfernt oder überschrieben.
IdempotentidempotentHint: false
Jeder Aufruf kann etwas Neues hinzufügen, etwa einen Kommentar, einen Lauf oder eine Aufgabe.
Offene WeltopenWorldHint: false
Berührt nur dein eigenes Done-Konto.

Welche Tokens es aufrufen dürfen

Eine per OAuth hergestellte Verbindung hat vollen Zugriff. Ein Token aus Einstellungen → Agentenzugriff → Weitere MCP-Tokens lässt sich einschränken, und ein eingeschränktes Token sieht nie über sein Projekt oder seinen Workspace hinaus.

  • Voller ZugriffErlaubt
  • Token nur zum LesenAbgelehnt
  • Token für ein ProjektErlaubt
  • Token für einen WorkspaceErlaubt

Probier es aus

Sobald Done verbunden ist, sag deinem Assistenten zum Beispiel:

“Du hast die Lead-Liste erstellt. Übergib die Aufgabe an Instinct für die Ansprache.”

Verbinde Done mit deinem Assistenten

Ein MCP-Endpunkt pro Konto, per OAuth oder Token. Die Einrichtung Schritt für Schritt für jeden Client:

Überblick über die MCP-Einrichtung →