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 same MCP endpoint and port that your local config exposes. Common examples include:
   • http://localhost:15000/mcp/sse
   • http://localhost:15000/mcp/http
   • If you run agentgateway on a different host or port, replace localhost:15000 in the examples accordingly.

Configuration

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

{
  "mcpServers": {
    "agentgateway": {
      "url": "http://localhost:15000/mcp/sse"
    }
  }
}

Project-Level Configuration

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

{
  "mcpServers": {
    "agentgateway": {
      "url": "http://localhost:15000/mcp/sse"
    }
  }
}

Using Streamable HTTP

For improved performance, use the streamable HTTP transport:

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

Authentication

Include authentication headers if required:

{
  "mcpServers": {
    "agentgateway": {
      "url": "http://localhost:15000/mcp/sse",
      "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.