For the complete documentation index, see llms.txt. Markdown versions of all docs pages are available by appending .md to any docs URL.

Windsurf

Connect Windsurf IDE to agentgateway

Configure Windsurf, Codeium’s AI-powered IDE, to use agentgateway as an MCP server.

Before you begin

1. Install and run agentgateway.
2. Confirm agentgateway is up by opening the agentgateway UI.
3. Use the MCP endpoint http://localhost:3000/mcp/http to connect your client to agentgateway. If you run agentgateway on a different host or port, replace localhost:3000 in the examples accordingly.

Configuration

Add agentgateway to your Windsurf MCP configuration. Create or edit ~/.windsurf/mcp.json:

{
  "mcpServers": {
    "agentgateway": {
      "url": "http://localhost:3000/mcp/http"
    }
  }
}

Project-Level Configuration

For project-specific settings, create .windsurf/mcp.json in your project root:

{
  "mcpServers": {
    "agentgateway": {
      "url": "http://localhost:3000/mcp/http"
    }
  }
}

Authentication

Include authentication headers if required:

{
  "mcpServers": {
    "agentgateway": {
      "url": "http://localhost:3000/mcp/http",
      "headers": {
        "Authorization": "Bearer your-token-here"
      }
    }
  }
}

Verifying the Connection

After configuration, restart Windsurf and verify that agentgateway tools are available in the Cascade agent’s tool list.