Skip to main content
An AI agent needs three things: access, a computer, and a way to use it. This page covers each in the fewest steps.
Give your agent orgo.ai/orgo.md. It is this whole flow as one markdown file. For the full docs as text, use llms.txt or llms-full.txt.

Get access

Pick one. Each needs a person to approve once.

Connect over MCP

Add the hosted server. No key to copy.
In any other client, add https://www.orgo.ai/mcp as a remote MCP server. The client opens Orgo in a browser. The person signs in, chooses a workspace, and approves. The connection can create and use computers in that workspace. See MCP for the tools and for local setups.

Get an API key with device approval

The agent starts a request, the person approves it in a browser, and the agent collects an account-wide API key. No key is ever pasted into a chat. 1. Start. No auth needed.
2. Ask the person to approve. Send them verification_uri_complete. They sign in and approve within 30 minutes. 3. Poll every interval_seconds with the device_code.
status is pending until the person acts, then one of:
The key is named “CLI on” plus the hostname you sent. The person can revoke it in API keys.
An agent that can run a shell gets the same flow and a running computer from one command, npx -y orgo@latest init. It waits for the approval, so give it a 10 minute timeout; if the shell stops it, run it again and it continues. orgo login signs in only. See CLI.

Try Orgo free

You can test computer use with no plan. Two ways in:
  • A person is here. Sign them in with device approval (above). A new account gets $5 of starting credit the first time it is used signed in, if it passes the free checks: a few accounts a day per address, network and email domain; nothing free from a server, datacenter or VPN address or a throwaway inbox; the credit once per inbox. If a check holds it back, adding a card gets it.
  • No person to approve. Agent signup gives the agent its own account with $2 of starting credit, no email or card. It pays for computers, not AI. An account that adds less than $5 of credit in all and is never claimed expires 72 hours after signup: its computers stop and its keys stop working, and 2 days later its computers are deleted.
What the starting credit runs:
  • One Medium Linux computer (2 vCPU, 8 GB RAM, 40 GB disk) by the hour: $0.055 an hour while it runs, $0.0027 while it is stopped, so $5 is about 90 running hours. Add "billing_mode": "hourly" to the create request below, or leave it out with an API key. A person’s starting credit also pays for AI.
  • One at a time, Medium only. Another computer answers 403 HOURLY_LIMIT. A size you name is ignored: a free account always gets a Medium. Free computers share running places: when they are full, a launch or a Start answers 503 FREE_HOURLY_BUSY; try again in a few minutes. Credit the person buys lifts the one at a time limit and the shared places, up to 50 Medium computers. Other sizes and Windows need a plan.
  • When a free check refuses, the answer is 429 with code NEEDS_CARD, a plain error and often needs (turnstile or phone) with a verify_url. Send the person that link, or ask them to add a card. NEEDS_PAYMENT means their card already lifted another account: credit or a plan is the way on.
When the credit runs out, the computer stops and its files are kept 7 days. Add credit and start it, or choose a plan with room for it (the plan takes it over). After 7 days without credit, the computer and its files are deleted.

Make sure the account has a plan

For always-on computers, other sizes and more of them, the account needs a plan or credit the person buys: either one lifts the account to 50 computers, and past 50 more run by the hour from credit, up to 999. If the account has no plan, the agent can get a checkout link for the person:
plan is hacker_v2 (Starter), startup_v2 (Growth), or scale_v2 (Scale). The response has a Stripe Checkout url. Send it to the person to pay. Prices are in pricing.md.
Call checkout only for an account with no plan. With an API key, a call on an account that already has a plan changes that plan without asking.

Create a computer

Find a workspace. The list is under workspaces.
If it is empty, create one with POST /workspaces and {"name": "agents"}. Then create the computer:
It answers 201 with the computer’s status. Until it is running, poll GET /computers/$COMPUTER_ID; a computer just made can take a few seconds to answer. With no size, a free account gets a Medium by the hour and a plan gets 4 GB and 1 vCPU. Its id is the $COMPUTER_ID for every call below. Set os to windows for Windows, which needs the Scale plan or a Windows add-on on another paid plan. See Create computer for sizes and templates.

Use the computer

Run commands and see the screen directly:
Or hand over a whole task. Orgo’s Computer Use agent screenshots, clicks, and types until it is done:
The endpoint is OpenAI-compatible. See Create chat completion.

When you’re stuck, ask

Orgo’s support agent answers questions about using Orgo, with full URLs and commands you can run. Ask it before guessing:
With a key it also reads the account’s plan and computers, and can hand the conversation to Orgo’s team. See Ask support.

Reference for agents