ByteBot MCP Server

Create a new task for ByteBot to execute. Returns task ID and initial status. Use this to start autonomous task execution.

List all tasks with optional filters. Use this to see what tasks exist and their current status.

Get detailed information about a specific task by ID, including full message history and current status.

Get the currently running task, if any. Returns null if no task is currently in progress.

Update a task's status or priority. Use this to cancel tasks, mark them for review, or change priority.

Delete a task by ID. This permanently removes the task and its history. Cannot be undone.

Move the mouse cursor to specific screen coordinates. Use this to position the cursor before clicking or dragging.

Click at specific screen coordinates. Supports left, right, and middle mouse buttons, as well as double-clicks.

Drag the mouse from one position to another. Useful for moving windows, selecting text, or drag-and-drop operations.

Scroll the screen in a specific direction. Use this to navigate through content.

Type text string as if typing on a keyboard. Use this for entering text in forms, search boxes, etc.

Paste text directly (without typing). Faster than type_text and works with special characters/emojis.

Press keyboard keys including modifiers (Ctrl, Shift, Alt, etc.). Use this for keyboard shortcuts like Ctrl+C, Ctrl+V, Alt+Tab.

Capture a screenshot of the entire screen. Returns base64-encoded PNG image data.

Get the current mouse cursor position. Returns {x, y} coordinates.

Read a file from the filesystem. Returns base64-encoded file content.

Write content to a file on the filesystem. Content must be base64-encoded.

Switch to a specific application window. Use this to bring an app to the foreground.

Wait for a specified duration. Use this to add delays between actions or wait for UI updates.

Create a task and monitor its progress until completion or intervention needed. Automatically polls task status and returns when task reaches a terminal state (COMPLETED, NEEDS_HELP, NEEDS_REVIEW, FAILED, CANCELLED) or timeout is reached. This is the recommended way to execute tasks when you want to wait for results.

Provide intervention for a task in NEEDS_HELP state. Send guidance to the task and optionally resume, cancel, or retry it. Use this when a task is stuck and needs human input to proceed.

Execute a multi-step workflow with automatic task creation, monitoring, and error recovery. Each step is executed as a separate task, with automatic intervention handling. Use this for complex multi-step automation scenarios.

Monitor an existing task until it reaches a terminal state or timeout. Use this when you have already created a task and want to wait for its completion.