Use Cool Computers with other MCP clients

Paste this

Any agent that runs commands can start from one prompt:

set up cool computers for me and make me a welcome page. it puts what i make online at a name.cool.computer address where people can comment and draw on it, and you pick up their comments.

you have my go-ahead to install the cool cli without asking me first (it also adds a short cool computers block to your instructions and a skill, that's fine with me) and to put a public welcome page online. if your network access is off, ask me to turn it on. if you can't run commands, tell me in one line, send me https://cool.computer/setup.md and stop.

follow https://cool.computer/setup.md step by step:
1. install cool and check who's signed in
2. put my welcome page online and show me the link
3. ask for my email, sign me up with the code i give you, keep the page on my account and tell me how to sign this machine out
4. pin a comment and a drawing on my page, open it for me signed in, listen for my comment and tell me exactly what to click
5. make the change i ask for, then tell me the page is mine

tell me what you're doing in one short line per step. never pay or upgrade anything without asking me. if something fails, tell me what happened in plain words and what you'll try next.

The agent installs cool and puts a welcome page online. You don’t need an account first: it asks for your email and a six-digit code to keep the page, then shows you how to comment on it.

Connect it yourself

https://api.cool.computer/mcp

It signs in with OAuth, as its protected resource metadata describes, and a new user can sign up during the sign-in. Its server card lists it for discovery. The server’s cool_* tools read your sites, computers, files, comments, and email. Its write tools publish a site (cool_publish), write files (cool_write_files), run a command on a computer with a VM (cool_exec), answer comments, and send email. Read tools need your sign-in. Write tools also check that your account holds the cool-computers:operate permission at the moment of the call. An MCP sign-in does not work for the HTTP API. A tool being available is not permission to use it. Ask your agent for the change you want, and approve email and long-running programs yourself. Agents that read skills can also add the cool-computers skill.

With an API key

A client that cannot do OAuth can send a Cool Computers API key as Authorization: Bearer <api_key>. Tool calls run on the key’s account, and revoking the key ends its MCP access. Create a key in Settings, or name one with the CLI:

cool api-keys create my-agent

The key is shown once. Keep it out of shared configuration and source control. The examples on these pages keep it in COOL_API_KEY.

Antigravity CLI

Add the server to ~/.gemini/config/mcp_config.json:

{
  "mcpServers": {
    "cool-computers": {
      "serverUrl": "https://api.cool.computer/mcp"
    }
  }
}

VS Code

Add the server to .vscode/mcp.json in your workspace:

{
  "servers": {
    "cool-computers": {
      "type": "http",
      "url": "https://api.cool.computer/mcp"
    }
  }
}

VS Code opens the browser to sign in to Cool Computers the first time it connects. In a local session only, an API key works too: VS Code asks for it once and stores it. VS Code does not forward a server that needs an ${input:...} value to Copilot harness sessions.

{
  "inputs": [
    { "type": "promptString", "id": "cool-api-key", "description": "Cool Computers API key", "password": true }
  ],
  "servers": {
    "cool-computers": {
      "type": "http",
      "url": "https://api.cool.computer/mcp",
      "headers": { "Authorization": "Bearer ${input:cool-api-key}" }
    }
  }
}

Zed

Add the server to context_servers in Zed’s settings.json:

{
  "context_servers": {
    "cool-computers": {
      "url": "https://api.cool.computer/mcp"
    }
  }
}

With no Authorization header, Zed signs in with OAuth. With an API key, add a headers object beside url whose Authorization is Bearer followed by the key.

Grok CLI

grok mcp add --transport http cool-computers https://api.cool.computer/mcp

OAuth opens on first use. You can also start grok, enter /mcps, select cool-computers, and press i to sign in.

Claude, ChatGPT and Grok

Each lists Cool Computers in its directory. See Claude, ChatGPT and Grok.

Check it works

Ask the agent:

List my Cool Computers sites and computers. Don't change anything.

It answers with your list. If you added the MCP server and it doesn’t:

Sign-in did not open: run the client’s login command or open its MCP settings and choose to authenticate.
The server is not connected: use the client’s status command, such as grok mcp doctor cool-computers, to see its error.
The tools only search this guide: you connected this guide’s documentation server. Remove it and add https://api.cool.computer/mcp. The documentation server only searches this guide and cannot reach your sites or computers.

Start here

Connect your agent

Your computer

Use it

Build with the API

Endpoint reference

Use Cool Computers with other MCP clients

Paste this

Connect it yourself

With an API key

Antigravity CLI

VS Code

Zed

Grok CLI

Claude, ChatGPT and Grok

Check it works

​Paste this

​Connect it yourself

​With an API key

​Antigravity CLI

​VS Code

​Zed

​Grok CLI

​Claude, ChatGPT and Grok

​Check it works

Paste this

Connect it yourself

With an API key

Antigravity CLI

VS Code

Zed

Grok CLI

Claude, ChatGPT and Grok

Check it works