Call Jimmy docs ← back to the site

The tools, by name

The MCP tools an agent calls during a call. Humans never type these — you just talk.

If you're a person, you don't need this page. It's the reference for the agent driving

your bot. What to ask for is the human version.

Listening and speaking

ToolWhat it does
wait_for_speechLong-poll; returns when someone finishes a turn
speakSay something aloud. Carries an urgency 0–1 — 0.5 is the line at which you may interrupt a person
set_modeactive · passive (only when named) · silent (acts, never speaks)
read_chat / send_chatMeet's text chat — the right channel for links

server.js:659 · server.js:2352

The board

ToolWhat it does
update_whiteboardSets the content. Does not present it
start_sharePresents the board. Needed once per call, by whichever bot presents first
load_urlSwaps the shared surface to a live web page
read_whiteboardReads the board back, including another bot's writes

server.js:1530 · server.js:1385

update_whiteboard and start_share are two different things. Setting content while

nobody is presenting means the room sees nothing. This trips up humans and agents equally.

One board per room, shared by every bot in the call. The service keeps its last 50 versions.

local-server.js:4870

Driving what you present

click_share, type_share, scroll_share, inspect_dom, read_share_console — real mouse

and key events into the page on the board, so the room watches you operate it. Prefer a CSS

selector over coordinates.

server.js:2043

Mute the share before presenting anything with media. A page that autoplays audio will

talk over the room. set_share_audio({muted:true}).

Hearing

ToolWhat it does
set_caption_languagePer-participant, BCP-47. Wrong language = confident nonsense
get_room_infoParticipants, who's presenting, recent errors

server.js:2308