Agent Fleet gives agents and assistants MCP tools for operating Agent Fleet itself.
Which of them a client sees depends on where it connects from.
| Column |
Who uses it |
How it connects |
| Session |
the agent in a session |
Built in, as the MCP server af |
| Assistant |
an assistant chat in the Console |
Built in, when the assistant’s tools are “AF read” or “AF write” (Ask an assistant) |
| Outside |
a client outside Agent Fleet, such as claude.ai or Claude Code on your own computer |
The Control Plane’s /mcp, with a token or by signing in (Drive your workspace from an external Claude) |
How to read a cell:
- Session: ✓ alone means every session has it. A quoted name is the switch in
⚙ Settings → Sessions (⚙ Settings → Image generation for image generation) that has to be on; “Agent memory” is the one in ⚙ Settings → Agent memory → Settings.
“image studio” means only a session working in the image studio.
- Assistant: “AF read” means an assistant with either grant has it; “AF write” means only an assistant
allowed to write.
- with a browser: not offered in a workspace that has no browser (deployment targets).
- Outside:
read or write is the scope the token or connected app needs. “admin” means only tenant
administrators and deployment administrators see it. “memory” means only when memory may be used from outside
(Use memory from an external agent); those tools are also all that
/mcp/memory serves.
- Required parameters are the ones a call cannot leave out. The tool list a client receives describes
every parameter.
| Tool |
What it does |
Session |
Assistant |
Outside |
Required parameters |
af_report |
Report once that an instruction carrying an [agent-fleet] note is fully done |
✓ |
— |
— |
— |
af_stop_after_turn |
Schedule this session to stop at the end of its turn, or cancel that |
✓ |
— |
— |
— |
propose_session_handoff |
Propose to you the first prompt of a follow-up session; it starts nothing itself |
✓ |
— |
— |
title, prompt |
| Tool |
What it does |
Session |
Assistant |
Outside |
Required parameters |
list_my_sessions |
List the workspace’s sessions with their kind, state and working directory |
— |
✓ AF read |
✓ read |
— |
get_session_status |
Show a session’s state (working, idle, asking, waiting for plan approval) and its pending question |
✓ |
✓ AF read |
✓ read |
Session: —; Assistant, Outside: name |
get_session_output |
Read a session’s recent output. In a session or an assistant it continues from the last read; from outside, pass the returned cursor as since to continue, or each call returns the latest tail. A session may read only its own children |
✓ “Starting sessions from sessions” |
✓ AF read |
✓ read |
name |
get_session_usage |
Show each session’s context use and cumulative token use |
✓ |
✓ AF read |
✓ read |
— |
get_agent_usage |
Show each agent CLI’s subscription usage and rate limits |
✓ “Starting sessions from sessions” |
✓ AF read |
✓ read |
— |
search_sessions |
Full-text search over what was said in this workspace’s past sessions, stopped and archived ones included |
✓ “Past-session search” |
— |
— |
— |
| Tool |
What it does |
Session |
Assistant |
Outside |
Required parameters |
create_session |
Start a new session and hand it its first task |
✓ “Starting sessions from sessions” |
✓ AF write |
✓ write |
— |
list_child_sessions |
List the child sessions this session started, with their state and the slots left |
✓ “Starting sessions from sessions” |
— |
— |
— |
rename_child_session |
Rename a child session this session started |
✓ “Starting sessions from sessions” |
— |
— |
name, title |
list_repos |
List the git working copies in the workspace (~/repos) |
✓ “Starting sessions from sessions” |
✓ AF read |
✓ read |
— |
list_models |
List the models each agent can use right now |
✓ “Starting sessions from sessions” |
✓ AF write |
✓ read |
kind |
send_to_session |
Send a prompt to a session to run, resuming it first when it is stopped |
— |
✓ AF write |
✓ write |
name, prompt |
answer_session_question |
Answer a session’s pending question by choosing an option |
— |
✓ AF write |
— |
name, choices |
respond_session_plan |
Approve or reject a plan a session is waiting on (claude only) |
— |
✓ AF write |
— |
name, decision |
stop_session |
Stop a session; its conversation and working copy stay and it can be resumed. A session may stop only its own children |
✓ “Starting sessions from sessions” |
✓ AF write |
✓ write |
name |
stop_session_after_turn |
Stop a session once its current turn ends, without interrupting it. A session may do this only to its own children |
✓ “Starting sessions from sessions” |
✓ AF write |
✓ write |
name |
resume_session |
Resume a stopped session with its conversation kept. A session may resume only its own children |
✓ “Starting sessions from sessions” |
✓ AF write |
✓ write |
name |
| Tool |
What it does |
Session |
Assistant |
Outside |
Required parameters |
list_peer_sessions |
List the other sessions in the same workspace |
✓ “Messages between sessions” |
— |
— |
— |
send_to_peer_session |
Send a short message to another session; a stopped one is resumed to receive it |
✓ “Messages between sessions” |
— |
— |
name, intent, message |
peek_session_output |
Read another session’s recent output, read-only |
✓ “Messages between sessions” |
— |
— |
name |
| Tool |
What it does |
Session |
Assistant |
Outside |
Required parameters |
list_memos |
List your memo queue |
✓ |
✓ AF read |
✓ read |
— |
add_memo |
Add one memo to your memo queue; in an auto-run category it waits for your approval; an optional reference points at a work item without copying it |
✓ |
✓ AF write |
✓ write |
kind |
update_memo |
Edit a memo; only the fields passed change (reference: leave out to keep it, {} to remove it). Editing an approved auto-run memo sends it back for approval |
✓ |
✓ AF write |
✓ write |
id |
defer_queue_item |
Hand the auto-run memo that started this session back to its queue, to run again later; applied only when the run ends, and dropped when the session worked on or has an open or merged pull request |
✓ only a session an auto-run started |
— |
— |
— |
delete_memo |
Delete a memo by its id; refused in an auto-run category |
— |
✓ AF write |
✓ write |
id |
list_memo_queues |
Read the auto-run categories and their settings; settings are changed only in the Console |
— |
✓ AF read |
— |
— |
get_memo_queue_runs |
Read an auto-run category’s run history |
— |
✓ AF read |
— |
categoryId |
flush_memos |
Send the chosen memos to a session as one message; refused in an auto-run category |
— |
✓ AF write |
✓ write |
sessionName, ids |
| Tool |
What it does |
Session |
Assistant |
Outside |
Required parameters |
list_schedules |
List the schedules |
— |
✓ AF read |
— |
— |
get_schedule_runs |
Show a schedule’s latest 50 runs |
— |
✓ AF read |
— |
id |
create_schedule |
Register a schedule |
— |
✓ AF write |
— |
spec_kind, spec, prompt |
update_schedule |
Edit a schedule |
— |
✓ AF write |
— |
id |
delete_schedule |
Delete a schedule |
— |
✓ AF write |
— |
id |
pause_schedule |
Pause a schedule |
— |
✓ AF write |
— |
id |
resume_schedule |
Resume a paused schedule |
— |
✓ AF write |
— |
id |
run_schedule_now |
Fire a schedule now, to try it |
— |
✓ AF write |
— |
id |
| Tool |
What it does |
Session |
Assistant |
Outside |
Required parameters |
list_cleanup_candidates |
Inspect and list sessions and worktrees that could be cleaned up |
— |
✓ AF read |
✓ read |
— |
list_cleanup_archives |
List the archives clean-up set aside |
— |
✓ AF read |
✓ read |
— |
archive_session |
Archive a finished session to hide it from the list; it can be restored |
— |
✓ AF write |
✓ write |
name |
delete_worktree |
Delete a worktree that is no longer needed; refused while it has uncommitted or unpushed work |
— |
✓ AF write |
✓ write |
name |
delete_session |
Delete a session for good to reclaim its disk, after setting it aside in an archive it can be restored from |
— |
✓ AF write |
✓ write |
name |
delete_branch |
Delete a merged local branch |
— |
✓ AF write |
✓ write |
repo, branch |
restore_cleanup_archive |
Restore a session or branch from a clean-up archive |
— |
✓ AF write |
✓ write |
id |
purge_cleanup_archive |
Delete an archive for good; it cannot be restored afterwards |
— |
✓ AF write |
✓ write |
id |
| Tool |
What it does |
Session |
Assistant |
Outside |
Required parameters |
memory_index |
List the shared memories, without their bodies |
✓ “Agent memory” |
— |
✓ read, memory |
— |
memory_search |
Full-text search over the shared memory |
✓ “Agent memory” |
— |
✓ read, memory |
query |
memory_read |
Read one memory with its body |
✓ “Agent memory” |
— |
✓ read, memory |
name |
memory_save |
Create or update a memory; it is published at once, and a secret is refused |
✓ “Agent memory” |
— |
✓ write, memory |
Session: name, description, body; Outside: name, description, type, body, scope |
memory_patch |
Change part of a memory without sending it again whole |
✓ “Agent memory” |
— |
✓ write, memory |
Session: name, revision; Outside: name, revision, scope |
memory_feedback |
Report that a memory you relied on is wrong or out of date |
✓ “Agent memory” |
— |
✓ write, memory |
Session: name, revision, verdict; Outside: name, revision, verdict, scope |
memory_forget |
Take a memory out of use; its history stays |
✓ “Agent memory” |
— |
✓ write, memory |
Session: name, revision; Outside: name, revision, scope |
memory_projects |
List the memory’s projects with their id, repository and memory count |
— |
— |
✓ read, memory |
— |
| Tool |
What it does |
Session |
Assistant |
Outside |
Required parameters |
list_memory_snapshots |
List the snapshots of the agents’ own memory, newest first |
— |
✓ AF read |
— |
— |
get_memory_snapshot |
Show the agents’ own memory as of a snapshot, with the difference |
— |
✓ AF read |
— |
— |
restore_memory_snapshot |
Put the agents’ own memory back to a snapshot; the range must be given |
— |
✓ AF write |
— |
— |
| Tool |
What it does |
Session |
Assistant |
Outside |
Required parameters |
list_chromium_targets |
List the pages on a loopback Chromium debugging port |
✓ with a browser |
✓ AF read, with a browser |
— |
port |
get_chromium_attachment |
Show a Chromium attachment’s state, control mode and outcome |
✓ with a browser |
✓ AF read, with a browser |
— |
attachment_id |
attach_chromium |
Attach to an existing page so you can see it; it starts view-only, and input needs a control-mode switch |
✓ with a browser |
✓ AF write, with a browser |
— |
port, target_id |
detach_chromium |
Drop the attachment only; the page and the browser stay open |
✓ with a browser |
✓ AF write, with a browser |
— |
attachment_id |
request_browser_action |
Ask you to do something on the page, such as signing in, or update that request |
✓ with a browser |
✓ AF write, with a browser |
— |
attachment_id, message |
get_browser_action_result |
Read what you reported for that request: done, cancelled or pending |
✓ with a browser |
✓ AF write, with a browser |
— |
attachment_id |
set_chromium_control_mode |
Switch the attachment between view-only, your control and locked |
✓ with a browser |
✓ AF write, with a browser |
— |
attachment_id, control_mode |
| Tool |
What it does |
Session |
Assistant |
Outside |
Required parameters |
generate_image |
Generate an image from a prompt and return the file paths; it spends your plan’s usage. Offered only while an image provider other than the session’s own agent CLI is ready, and never in a session working in the image studio |
✓ “Image generation” |
— |
— |
prompt |
get_image_studio |
Read the image studio draft you are working on together |
✓ image studio |
— |
— |
— |
set_image_draft |
Change fields of the studio draft |
✓ image studio |
— |
— |
— |
add_image_knowledge |
Add a note to the studio’s knowledge for its model or model family, only when you ask for it |
✓ image studio |
— |
— |
scope, key, note |
run_image_trial |
Make one trial image from the draft as it is; refused unless “Let the agent run a trial” is on in the studio |
✓ image studio |
— |
— |
— |
| Tool |
What it does |
Session |
Assistant |
Outside |
Required parameters |
branch_name |
Decide a branch name and its base from your branch naming rules; called before creating or renaming a branch |
✓ |
— |
— |
— |
link_work_item |
Link this session to an issue, ticket or pull request, shown on its row in the Console |
✓ |
— |
— |
provider, key |
| Tool |
What it does |
Session |
Assistant |
Outside |
Required parameters |
watch |
Get a notice in this session when a pull request or another watched subject changes, instead of polling |
✓ |
— |
— |
ref |
unwatch |
End one of this session’s watches |
✓ |
— |
— |
id |
list_watches |
List this session’s watches with their expiry and the last read of each subject |
✓ |
— |
— |
— |
| Tool |
What it does |
Session |
Assistant |
Outside |
Required parameters |
skill_restore |
List or bring back an agent-written skill that was archived as unused |
✓ |
— |
— |
— |
| Tool |
What it does |
Session |
Assistant |
Outside |
Required parameters |
get_chat_plan |
Read the work plan pinned to this conversation |
— |
✓ AF write |
— |
— |
set_chat_plan |
Replace this conversation’s work plan as a whole |
— |
✓ AF write |
— |
plan |
list_assistants |
List the assistants you can consult, built-in and your own |
— |
✓ AF write |
— |
— |
ask_assistant |
Ask another assistant for advice, read-only and for one turn |
— |
✓ AF write |
— |
assistant, prompt |
| Tool |
What it does |
Session |
Assistant |
Outside |
Required parameters |
list_workspaces |
List the tenant’s members with the state of their workspace |
— |
— |
✓ read, admin |
— |
get_usage |
Show the tenant’s resource use: members, running workspaces and limits |
— |
— |
✓ read, admin |
— |
list_sessions |
List sessions across the tenant, or of one member |
— |
— |
✓ read, admin |
— |
stop_workspace |
Force-stop a member’s workspace; the home stays |
— |
— |
✓ write, admin |
user_key |
stop_user_session |
Stop a session in a member’s workspace; it can be resumed |
— |
— |
✓ write, admin |
user_key, name |
set_user_quota |
Set a member’s quota: sessions, CPU, memory and disk |
— |
— |
✓ write, admin |
user_key |
get_egress_stats |
Show outbound traffic by destination host (deployment administrators) |
— |
— |
✓ read, admin |
— |
list_allowlist |
List the egress allowlist entries (deployment administrators) |
— |
— |
✓ read, admin |
— |
propose_allowlist_change |
Propose an allowlist addition; it takes effect only once an administrator approves it in the Console (deployment administrators) |
— |
— |
✓ write, admin |
entry |
tail_audit |
Show recent audit-log entries |
— |
— |
✓ read, admin |
— |