Connect Windsurf

Add the looot MCP server to Windsurf, and check it works. Browser sign-in is not confirmed on this client.

Windsurf reaches looot’s catalog, balance and runs over MCP, through a config file.

Before you start you need a looot account. The runs you make spend the organization’s balance, so top up before your first paid run. See Before your first run.

Sign in with the browser

The server URL is https://api.looot.ai/mcp. Nothing to copy: you sign in on looot.ai, pick the organization to bill and click Connect.

~/.codeium/windsurf/mcp_config.json

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

Headless: a token in the header

Only for CI and machines with no browser. Create an agent token in Settings and send it as Authorization: Bearer <token>. Never commit it.

Headless: with a header

{
  "mcpServers": {
    "looot": {
      "serverUrl": "https://api.looot.ai/mcp",
      "headers": {
        "Authorization": "Bearer <agent token from looot.ai Settings>"
      }
    }
  }
}

Notes

• Windsurf has no MCP marketplace or one-click install for Cascade.

Check it works

Ask the agent to call balance or catalog_overview. Both are free. A working connection answers with your available balance, or the catalog’s categories and job counts.

What you see when you connect

If browser sign-in starts, the browser opens looot.ai and shows the consent page: which organization to bill, which scopes to grant and how long to stay connected. See The consent page.