Skip to content

MCP tools

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 —