SIKEMUXDocs
Reference

MCP tools

The sikemux-tools MCP tools every agent in Sikemux gets.

Edit on GitHub

Every agent Sikemux starts gets these tools through the sikemux-tools MCP server. The same calls work from a terminal with sikemux tool METHOD [JSON_PARAMS].

browser

ToolWhat it does
browser_navigateOpen a URL or go back, forward or reload, then wait for the page.
browser_stateRead the tab: url, title, numbered elements, text, tabs and downloads.
browser_findFind elements by visible text or accessible name.
browser_clickClick an element by number, text or selector, or a point.
browser_typeType into a field, replacing its value, or at the caret.
browser_pressPress a key or chord, such as Enter or Meta+a.
browser_actRun clicks, typing and keys in one call.
browser_dragDrag from one element or point to another.
browser_uploadGive files to a file input.
browser_dialogAnswer the page’s alert, confirm or prompt.
browser_viewportSet this tab’s viewport size or preset.
browser_scrollScroll to an element, by deltaY, or to an end.
browser_evaluateRun a script in the page; returns JSON.
browser_networkList the page’s requests with status and body.
browser_consoleList the page’s console messages and errors.
browser_screenshotCapture the tab or the whole page.
browser_annotateDraw a labelled box or caption over the page.
browser_recordRecord this tab to MP4, or stop recording.
browser_waitWait for text, a selector, a url or a quiet network.
browser_switch_tabMake one of this agent’s tabs the current one.
browser_close_tabClose one of this agent’s tabs.

sim

ToolWhat it does
sim_devicesList the iOS simulators, the one you hold, and which other agents hold.
sim_attachAttach a simulator by name or udid, else your project’s own; boots it if needed and reads its screen.
sim_stateRead the attached simulator’s screen: the frontmost app and numbered elements with their centre points.
sim_tapTap an element by number or label, or a point in device points. A duration makes it a long press.
sim_swipeSwipe between two points in device points. Starting at a screen edge makes a system gesture.
sim_typeType text into the focused field on the attached simulator.
sim_buttonPress a hardware button on the attached simulator.
sim_rotateTurn the attached simulator to an orientation and read its screen.
sim_screenshotCapture the attached simulator’s screen at its size in points.
sim_launchLaunch an installed app by bundle id, relaunching it if it runs, and read the screen.
sim_terminateQuit an app on the attached simulator by bundle id.
sim_installInstall a built .app from inside the project on the attached simulator.
sim_open_urlOpen a URL or deep link on the attached simulator.
sim_touch_pathDrag one finger through points over a duration, as a long-press drag or drawing.
sim_touch2_pathMove two fingers through points together, to pinch, spread or turn.
sim_logsRead the attached simulator’s log by cursor and generation, all of it or one process’s.
sim_detachLet go of the attached simulator, for another agent to use.

workspace

ToolWhat it does
workspace_inspectThe open project: tasks, runs and ports.

task

ToolWhat it does
task_startStart a sikemux.json task or any shell command.
task_restartRestart a task’s latest run.
task_readRead a task’s output by cursor, tail or search.
task_stopStop a task’s run and its process tree.

ui

ToolWhat it does
ui_openOpen a file, diff, task terminal or the preview.

page

ToolWhat it does
page_previewCheck a page as the chat shows it.
page_showShow a page in your reply.

events

ToolWhat it does
events_waitWait for task or UI events after a cursor.

agent

ToolWhat it does
agent_listList Sikemux agents.
agent_sendMessage a Sikemux agent.
agent_spawnStart a Sikemux agent.
agent_sessionsSearch past agent sessions.
agent_readRead what an agent said.
agent_waitWait for agents to stop working.

who

ToolWhat it does
who_wroteWho broke CI, a test or a commit, and how to reach them.

ask

ToolWhat it does
askAsk your lead or the person.

board

ToolWhat it does
board_addAdd a board card.
board_listList the board.
board_claimClaim a card.
board_updateChange a card.

review

ToolWhat it does
review_verdictApprove the change you are reviewing, or say what must change.

git

ToolWhat it does
git_commitCommit only the lines you wrote.

skills

ToolWhat it does
skillsManage the skills every agent gets.

app

ToolWhat it does
app_consoleRead the Sikemux app’s console and errors.