Get access
Pick one. Each needs a person to approve once.Connect over MCP
Add the hosted server. No key to copy.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.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:
hostname you sent. The person can revoke it in API keys.
The whole flow as one script
The whole flow as one script
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.
- 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
403HOURLY_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 answers503FREE_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
429with codeNEEDS_CARD, a plainerrorand oftenneeds(turnstileorphone) with averify_url. Send the person that link, or ask them to add a card.NEEDS_PAYMENTmeans their card already lifted another account: credit or a plan is the way on.
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.
Create a computer
Find a workspace. The list is underworkspaces.
POST /workspaces and {"name": "agents"}. Then create the computer:
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.