Kubi Docs
Get started

Connect your agent

Add the hosted MCP server to Claude Code, claude.ai, Codex, Cursor or VS Code. No code, about two minutes.

Our MCP server runs with the API, so there is nothing to install. Add one URL to your agent app:

Code
https://mcp.trykubi.com

The first time, your browser opens our sign-in page. Pick the screens the agent may use and what it may do, then return to your app. You can disconnect it any time from Connected apps in the dashboard.

Claude Code

TerminalCode
claude mcp add --transport http kubi https://mcp.trykubi.com

Then run /mcp inside Claude Code and sign in (or claude mcp login kubi from your shell).

claude.ai and Claude Desktop

Open Customize > Connectors, click + Add, then Add custom connector. Name it Kubi, paste the URL above and click Continue, then Add.

Codex

TerminalCode
codex mcp add kubi --url https://mcp.trykubi.com codex mcp login kubi

Cursor

Add the server to mcp.json:

JSONCode
{ "mcpServers": { "kubi": { "url": "https://mcp.trykubi.com" } } }

VS Code

Open the Command Palette, run MCP: Add Server, choose HTTP and paste the URL.

Using an API key instead of signing in

For agents that run without a person (CI, servers), send a key in the header:

Code
Authorization: Bearer kubi_...

The tools your agent gets

ToolWhat it does
screenshotThe screen as an image, with its size and id
zoomA region at full resolution, for small text
act1 to 20 actions (click, type, keys, scroll, drag), then the screen after them
waitPause; returns an image only if the screen changed
execRun a shell command; short output inline, long runs get an id
exec_statusWait up to 25 s for a command to finish
list_screens, statusYour screens, and each one's state and health
viewer_linkA view-only live link to share with a person
clipboardRead the clipboard, or set it when given text
read_file, write_fileA file up to 64 KiB, as text or base64

start, stop and restart are off unless you turn them on. The server never offers tools to create or delete screens, make keys or touch billing.

Each tool call answers within 30 seconds, well inside the 60-second limit some apps use.