Connect an AI to your bubbles

The sixteenbridges command

npx sixteenbridges login

1. Sign in once: your browser opens, you click Allow.
2. Then tell your AI: "Use the sixteenbridges command for my bubbles." It learns the rest from npx -y sixteenbridges --help.

Works with Claude Code, Codex, Gemini CLI, Cursor's agent, Aider, and anything else that runs commands. Over SSH or in a sandbox: npx sixteenbridges login --no-browser.

Claude Desktop

1. First, sign this computer in once: npx sixteenbridges login
2. Add this to the config file, save, and restart Claude Desktop.

{
  "mcpServers": {
    "sixteen-bridges": {
      "command": "npx",
      "args": [
        "-y",
        "sixteenbridges",
        "mcp"
      ]
    }
  }
}

On Windows, if it doesn't start, use "command": "cmd" with "args": ["/c", "npx", "-y", "sixteenbridges", "mcp"].

Cursor

1. First, sign this computer in once: npx sixteenbridges login
2. Add this to ~/.cursor/mcp.json (or Settings → MCP → Add), then reload.

{
  "mcpServers": {
    "sixteen-bridges": {
      "command": "npx",
      "args": [
        "-y",
        "sixteenbridges",
        "mcp"
      ]
    }
  }
}

VS Code

1. First, sign this computer in once: npx sixteenbridges login
2. Add this to .vscode/mcp.json in your project (or your user MCP settings), then start the server.

{
  "servers": {
    "sixteen-bridges": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "sixteenbridges",
        "mcp"
      ]
    }
  }
}

Windsurf

1. First, sign this computer in once: npx sixteenbridges login
2. Add this to ~/.codeium/windsurf/mcp_config.json, then refresh its MCP servers.

{
  "mcpServers": {
    "sixteen-bridges": {
      "command": "npx",
      "args": [
        "-y",
        "sixteenbridges",
        "mcp"
      ]
    }
  }
}

Claude (claude.ai, Desktop)

1. Open Settings → Connectors and choose Add custom connector.
2. Name it Sixteen Bridges and paste the URL: https://mcp.sixteenbridges.com/mcp
3. Choose Connect, then Allow on sixteenbridges.com.

Free plans can add one custom connector.

ChatGPT

1. Turn on Developer mode: Settings → Apps (or Connectors) → Advanced settings.
2. Create an app or connector named Sixteen Bridges with the URL https://mcp.sixteenbridges.com/mcp and OAuth sign-in.
3. Allow it on sixteenbridges.com, then turn it on in the chat.

Developer mode is on paid plans, and saving or editing bubbles from ChatGPT may need a Business or Enterprise plan. Workspace admins may need to allow custom apps first.

Gemini (gemini.google.com)

1. On a computer, open gemini.google.com → Settings → Connected Apps. If it isn't there, open Personal Intelligence first.
2. Under Custom apps, choose Add a custom app.
3. Paste the URL https://mcp.sixteenbridges.com/mcp and choose Next. Leave Advanced features empty: it signs in by itself.
4. Follow the prompts (name it Sixteen Bridges if asked), then Allow on sixteenbridges.com.
5. In a chat, type @ and pick Sixteen Bridges.

Custom apps are only for people 18 or over in the US, on a personal Google account (not work or school), in English, with Keep Activity on. Added on the web, they then work in the Gemini app too.

Grok

1. Open grok.com/connectors, choose New Connector, then Custom.
2. Paste the URL: https://mcp.sixteenbridges.com/mcp
3. Allow it on sixteenbridges.com.

Custom connectors are on paid Grok plans.

Perplexity

1. Open Settings → Connectors and choose Custom connector, Remote.
2. Name it Sixteen Bridges, paste the URL https://mcp.sixteenbridges.com/mcp, and choose OAuth.
3. Allow it on sixteenbridges.com, then turn it on under a thread's sources.

Custom connectors are on Pro, Max and Enterprise plans, and are added on the web.

Claude Code

claude mcp add --transport http sixteen-bridges https://mcp.sixteenbridges.com/mcp

1. In Claude Code, run /mcp, pick sixteen-bridges and sign in. Allow it on sixteenbridges.com.

Codex

codex mcp add sixteen-bridges --url https://mcp.sixteenbridges.com/mcp
codex mcp login sixteen-bridges

1. The login opens your browser: Allow it on sixteenbridges.com.

Gemini CLI

gemini mcp add --transport http sixteen-bridges https://mcp.sixteenbridges.com/mcp

1. In Gemini CLI, run /mcp auth sixteen-bridges. Allow it on sixteenbridges.com.