Other MCP clients

Every client below signs in through your browser; none needs a secret. The address is https://api.unbranch.ai/mcp, over Streamable HTTP.

Let the agent set itself up

Paste this into any MCP-capable agent. It adds unbranch in its own configuration format:

Connect to unbranch as an MCP server.

Server URL: https://api.unbranch.ai/mcp
Transport: Streamable HTTP (a remote server, not a command to run).
Sign-in: OAuth. Open the sign-in page in my browser and I will sign in with my unbranch account and confirm the connection.

Add it in your own MCP configuration format. Once connected, call the whoami tool and tell me which account and projects you can see. Then call read_instructions and follow it before doing anything else in unbranch.

The prompt names the transport on purpose. A client that sees only an address may treat the entry as a command to run.

Or add it yourself

Cursor

Add this to ~/.cursor/mcp.json for every project, or .cursor/mcp.json for one:

{
  "mcpServers": {
    "unbranch": { "url": "https://api.unbranch.ai/mcp" }
  }
}

Open Cursor Settings → MCP, choose Login next to unbranch, then sign in and confirm.

VS Code

Add this to .vscode/mcp.json in your workspace:

{
  "servers": {
    "unbranch": { "type": "http", "url": "https://api.unbranch.ai/mcp" }
  }
}

Choose Start above the server entry, then sign in and confirm when the browser opens.

Windsurf

Add this to ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "unbranch": { "serverUrl": "https://api.unbranch.ai/mcp" }
  }
}

Refresh the MCP list in Windsurf, then sign in and confirm when asked.

Codex CLI

Run both lines. The second opens unbranch in your browser to sign in and confirm.

codex mcp add unbranch --url https://api.unbranch.ai/mcp
codex mcp login unbranch

Gemini CLI

Add this to ~/.gemini/settings.json, or .gemini/settings.json in the project:

{
  "mcpServers": {
    "unbranch": { "httpUrl": "https://api.unbranch.ai/mcp" }
  }
}

Run /mcp auth unbranch in Gemini CLI, then sign in and confirm in the browser.

Other

Add the server with its URL, and set the transport to Streamable HTTP in whichever field your client uses for it (type, transport, httpUrl or serverUrl):

{
  "mcpServers": {
    "unbranch": { "type": "http", "url": "https://api.unbranch.ai/mcp" }
  }
}

Connect, then sign in and confirm when the browser opens.

First call

Once connected, the agent should call whoami to confirm the account and projects it reaches, then read_instructions. The server explains its own tools there. See MCP tools.