Integration

Orgo integration

Orgo runs cloud computers (Linux, Windows, and Mac or iPhone on request) that AI agents control. With this API an agent can create, start, stop, suspend, resume, clone, fork, resize, move and delete computers, organise them in workspaces, take screenshots, click, type, press keys, scroll and drag, run Bash or Python on them, manage extra screens, push files to them, run Orgo's own computer-use agent on a computer (billed to AI credits), ask Orgo's support agent, read account capacity, manage template versions and their builds, and read or update reseller client workspaces. Not exposed: VNC passwords and SSH settings (connection secrets and host addresses), signed upload and download links, buying or reducing plan capacity, agent self-signup and claim links, creating client workspaces or rotating their keys (the response carries a key shown once), client transfers and client billing (payment links, prices, refunds), the template schema document and build log streams. Authentication is an Orgo API key (starts with sk_live_) sent as a bearer token in the Authorization header; template and capacity routes need an account-wide key, a workspace-scoped key reaches only its workspace.

Connect Orgo How integrations work

Ask it in chat

Say what should happen.
The workflow builds itself.

When this happens, do that in Orgo.Built from the 60 Orgo tools below, on the connection you add once.

What you can do with Orgo

Each of these is one operation on one endpoint, available both as a workflow step and as a tool an AI agent can call on its own. Nothing bundles several operations into one action, so what a run did stays readable afterwards.

Most endpoints run on the free plan. A few, mainly the ones that publish on your behalf, need a paid plan.

Screen, 5 operations

create_screenCreate screenPOSTStarts another screen (display) on a Linux computer, at most four; omit width and height to match the boot screen. macOS and iPhone answer 409, Windows 404. The screen comes back after a restart.
destroy_screenDestroy screenDELETEDestroys an extra screen: stops its X server, window manager and every window on it. Not recoverable. The boot screen `default` cannot be destroyed.
get_screenGet screenGETReturns one screen of the computer (id, display, width, height). An unknown screen id returns 404.
list_screensList screensGETLists the computer's screens (id, display, size), the boot screen `default` included. macOS and iPhone have exactly one; Windows has none and answers 404.
resize_screenResize screenPATCHChanges a screen's resolution; width and height are both required. An extra screen keeps its new size after a restart, the boot screen does not.

Template, 5 operations

delete_templateDelete templateDELETEDeletes one template version you own: its registry entry, its golden snapshot and its queued builds. Running computers launched from it are unaffected. A curated (system) ref removes nothing.
get_templateGet templateGETFetches one template version: ref, digest, publish time and the template document. Use namespace system for curated templates.
list_curated_templatesList curated templatesGETLists the curated templates Orgo maintains (the system namespace, e.g. system/[email protected]), launchable on any paid plan with create_computer template_ref.
list_templatesList templatesGETLists the templates published under your account (ref namespace/name@version, digest, publish time). Needs an account-wide key.
publish_templatePublish templatePOSTPublishes a template document (api_version orgo.ai/v1 plus template name and version) to your registry. A ref is immutable: the same ref with other content returns 409 unless force=true. Requires a Scale plan.

Workspace, 5 operations

create_workspaceCreate workspacePOSTCreates a workspace you own; its id is what create_computer needs. The name must not match another workspace you own (case-insensitive). Needs an account-wide key.
delete_workspaceDelete workspacePOSTPermanently deletes a workspace and every computer, file and member record in it. Owner only; any failed authorization check (an unknown id too) answers 401. Cannot be undone.
get_workspaceGet workspaceGETReturns one workspace with its computers under desktops, your role and permissions. An unknown id returns 403, not 404.
list_workspacesList workspacesGETLists every workspace you own or belong to, each with its computers under desktops (id, name, status...). On an account with no workspace, the first call creates a default one.
update_workspaceUpdate workspacePATCHRenames a workspace, changes its icon or its status (active, inactive). Fields you leave out are left alone. Owner only.

Account, 4 operations

close_clientClose clientDELETECloses a client: their API key stops working at once. Refused with 409 ACCOUNT_HAS_COMPUTERS while they still have computers. A client already closed or transferred is returned unchanged.
get_clientGet clientGETReturns one reseller client: name, status, workspace, limits, this month's usage and billing status.
list_clientsList clientsGETLists your reseller clients (a workspace each), newest first, with limits, usage, billing status and price, plus the total and what they pay you each month. Pages with before = next.
update_clientUpdate clientPATCHRenames a client or changes their limits (max_computers, monthly_ai_cap_usd). Fields you leave out keep their current value.

Computer, 4 operations

create_computerCreate computerPOSTCreates and boots a computer (default Linux, 4 GB RAM) in a workspace; id in the answer feeds every other computer tool. Counts against the owner's plan, or with billing_mode hourly is billed hourly from credit.
delete_computerDelete computerDELETEPermanently deletes a computer and all its data. Unless a 409 refusal applies, the record is always removed, even when the computer has no live host. Cannot be undone.
get_computerGet computerGETReturns a computer's details: name, workspace, os, RAM, CPU, status (creating, running, suspended, frozen, error...), instance_id, sleep and suspension state, hardware. Connection secrets and host addresses are not returned.
update_computerUpdate computerPATCHRenames a computer, sets its mascot, or both. Fields you leave out are left alone.

File, 3 operations

delete_fileDelete fileDELETEPermanently deletes a stored file by id (from list_files). A second delete of the same file returns 404.
list_filesList filesGETLists the files stored in a workspace (id, filename, size, type, source), optionally only those attached to one computer.
upload_fileUpload filePOSTUploads a file (max 10 MB) to a workspace and copies it to /root/Desktop on every running computer; with desktopId and destPath it is placed in that folder on one computer instead, and no file record is kept.

Build, 2 operations

build_templateBuild templatePOSTQueues a golden-snapshot build of a published template version and answers at once; poll get_build_status until ready or failed. At most 10 builds queued or running. Requires a Scale plan.
cancel_buildCancel buildDELETECancels a template build no runner has claimed yet; the version then reads not_built. A build already claimed runs to completion (404 here).

Run, 2 operations

stop_template_runStop template runDELETEStops a preview computer booted by test_run_template and reclaims it. Answers deleted true even when the preview was already gone.
test_run_templateTest run templatePOSTBoots a short-lived preview computer from a template ref (auto-reaped) to test it; stop it with stop_template_run. Requires a Scale plan. For a persistent computer use create_computer with template_ref.

Template version, 2 operations

list_curated_template_versionsList curated template versionsGETLists every published version of one curated template (namespace system).
list_template_versionsList template versionsGETLists every published version of one of your templates. An unknown template returns an empty versions list, not 404.

Bash, 1 operation

execute_bashExecute bashPOSTRuns a shell command on the computer (Bash on Linux, PowerShell on Windows) and returns output and exit_code. timeout defaults to 200 s, maximum 300. A non-zero exit is still a success: read exit_code.

Capacity, 1 operation

get_account_capacityGet account capacityGETReads the account's computer capacity: plan, limits and use (computers, RAM, vCPU), added capacity, how many more of each size may be added, and each size's monthly price. Needs an account-wide key (a workspace-scoped one gets 403).

Click, 1 operation

mouse_clickMouse clickPOSTClicks the mouse at x, y on the computer's screen (left button by default; right, middle, double, repeat and modifier keys available). Coordinates are unscaled screen pixels, see get_screenshot.

Clone, 1 operation

clone_computerClone computerPOSTCreates a copy of a computer with the same disk state, in the same workspace; the copy boots fresh (use fork_computer to copy live memory). The clone is charged against the workspace owner's plan.

Completion, 1 operation

create_chat_completionCreate chat completionPOSTRuns Orgo's agent on a running computer until it answers (it sees the screen, clicks, types, runs commands); answer in choices[0].message.content. Spends the owner's AI credits, cost in orgo.cost_cents. Can take minutes.

Drag, 1 operation

mouse_dragMouse dragPOSTPresses the left mouse button at start_x, start_y, moves to end_x, end_y and releases. The speed cannot be set.

Exec, 1 operation

execute_pythonExecute pythonPOSTRuns Python code on the computer in a fresh interpreter (python3 -c on Linux, Python 3.12 on Windows) and returns its output. Code that raises still answers success false with the traceback in output. Not on iPhone or Android.

Fork, 1 operation

fork_computerFork computerPOSTCopies a running Linux computer including its live memory into the same workspace; the fork comes up with the same apps and windows open. The source pauses about two seconds. Charged against the owner's plan. Takes the instance_id.

Key, 1 operation

press_keyPress keyPOSTPresses a key or key combination on the computer (Return, Tab, ctrl+c, alt+F4...). On an iPhone: home, app_switcher, Return, BackSpace, space; other chords return 501.

Mouse move, 1 operation

mouse_moveMouse movePOSTMoves the pointer to x, y without clicking (a hover), to open a menu, tooltip or link preview that shows only under a resting pointer.

Move, 1 operation

move_computerMove computerPATCHMoves a computer to another workspace you own (you must own both). A workspace-scoped key is refused with 401.

Operation, 1 operation

get_computer_operationGet computer operationGETReads a pending start or stop by the operation_id start_computer or stop_computer returned. Poll every two seconds while status is queued or running; it ends succeeded, failed or needs_review.

Resize, 1 operation

resize_computerResize computerPATCHChanges a running computer's vCPU, RAM, disk (grow only), bandwidth cap or idle auto-stop; may restart it. Read get_resize_limits first. Answers per dimension in results; partial true when some failed.

Resize limit, 1 operation

get_resize_limitsGet resize limitsGETReturns the largest CPU, RAM, disk and bandwidth resize_computer will accept on this computer, and the add-on capacity behind them. resizable false means it cannot be resized (see reason).

Restart, 1 operation

restart_computerRestart computerPOSTReboots a running computer in place: the disk is kept, memory and running processes are lost. Answers after the reboot completes. A frozen computer returns 409 stopped: use start_computer.

Resume, 1 operation

resume_computerResume computerPOSTBrings a suspended computer back with its memory. On its host it is back in seconds (status running); from storage it answers status resuming or waking: poll get_computer_suspension until running (about a minute).

Screenshot, 1 operation

get_screenshotGet screenshotGETCaptures the computer's screen and returns the image as a file. Pass screen for another screen, format (png, jpeg, webp) and scale to shrink it. A sleeping computer answers 409 computer_asleep: call resume_computer.

Scroll, 1 operation

scroll_mouseScroll mousePOSTMoves the pointer to x, y, then scrolls the mouse wheel up or down by amount clicks (default 1 click down).

Start, 1 operation

start_computerStart computerPOSTStarts a frozen or stopped computer and waits up to 300 s. A frozen computer restores its archived disk and gets a new instance_id. Still pending after 300 s, it answers operation_id: poll get_computer_operation.

Stop, 1 operation

stop_computerStop computerPOSTStops a running Linux or Windows computer: archives its disk, releases its host, leaves it frozen. Waits up to 300 s; still pending, it answers operation_id: poll get_computer_operation.

Support answer, 1 operation

ask_supportAsk supportPOSTAsks Orgo's support agent how to do something in Orgo; answers markdown with links. Send question (or messages to follow up). Reads your plan and computers but changes nothing. Free daily tokens, then account credits.

Suspend, 1 operation

suspend_computerSuspend computerPOSTSuspends a running computer with its memory (windows and processes survive) and releases its host. status suspended, or suspending when saved to storage: poll get_computer_suspension. Hourly computers use stop_computer.

Suspension, 1 operation

get_computer_suspensionGet computer suspensionGETReads a computer's status and suspension: whether its memory is being saved (with progress), stored, or coming back. Poll it after suspend_computer or resume_computer answers suspending or resuming.

Sync, 1 operation

apply_computer_secretsApply computer secretsPOSTWrites the named vault secrets to /root/.orgo-secrets.env on a running Linux computer (workspace values win over account values). Open a new terminal or restart the agent to load them. Values are never returned.

Template build, 1 operation

get_build_statusGet build statusGETReturns a template version's build state. Poll until status is ready or failed (error says why). Works for curated system templates too.

Type, 1 operation

type_textType textPOSTTypes text on the computer's keyboard, one keystroke per character (Unicode supported). The API waits at most 30 s for the typing to finish.

Validate, 1 operation

validate_templateValidate templatePOSTChecks a template document against the orgo.ai/v1 schema without saving anything; answers ok and, when invalid, errors (field, code, message, hint). Read-only.

Wait, 1 operation

wait_on_computerWait on computerPOSTPauses on the computer for seconds (above 0, up to 60) and answers when the wait is over. Not on Windows (404).

Use Orgo from Claude Code, Cursor or Codex

Connect Orgo in LiveContext, create an API key in Settings, then add the LiveContext MCP server to your client. Its Orgo operations become tools the client can call, next to every other integration you connected.

Claude Code

claude mcp add --transport http livecontext https://livecontext.ai/mcp --header "X-API-Key: YOUR_API_KEY"

Codex (~/.codex/config.toml)

[mcp_servers.livecontext]
url = "https://livecontext.ai/mcp"

[mcp_servers.livecontext.http_headers]
"X-API-Key" = "YOUR_API_KEY"

Cursor, Claude Desktop and other JSON configs

{
  "mcpServers": {
    "livecontext": {
      "type": "http",
      "url": "https://livecontext.ai/mcp",
      "headers": {
        "X-API-Key": "YOUR_API_KEY"
      }
    }
  }
}

Set up the MCP server step by step

How to connect Orgo

Create your workspace
Sign up free. Nothing to install.
Connect Orgo once
Add your Orgo connection in Settings. Every tool from this integration reuses it, and secrets are encrypted at rest and visible only to you.
Describe the job in chat
The workflow builds itself in front of you and picks the endpoints it needs. Drag the steps yourself on the canvas whenever you would rather be explicit.