---
title: Windsurf
slug: litmus-mcp-server/windsurf
docTags: 
createdAt: 2026-05-11T21:43:35.131Z
---

Configure [Windsurf](https://codeium.com/windsurf) to use the Litmus MCP server over SSE.

## 1. Run the server

```bash
docker run -d --name litmus-mcp-server \
  -p 8000:8000 \
  ghcr.io/litmusautomation/litmus-mcp-server:latest
```

## 2. Edit `~/.codeium/windsurf/mcp_config.json`

```json
{
  "mcpServers": {
    "litmus-mcp-server": {
      "url": "http://<MCP_SERVER_IP>:8000/sse",
      "headers": {
        "EDGE_URL": "https://<LITMUSEDGE_IP>",
        "EDGE_API_CLIENT_ID": "<oauth2_client_id>",
        "EDGE_API_CLIENT_SECRET": "<oauth2_client_secret>",
        "NATS_SOURCE": "<LITMUSEDGE_IP>",
        "NATS_PORT": "4222",
        "NATS_USER": "<access_token_username>",
        "NATS_PASSWORD": "<access_token_from_litmusedge>",
        "INFLUX_HOST": "<LITMUSEDGE_IP>",
        "INFLUX_PORT": "8086",
        "INFLUX_DB_NAME": "tsdata",
        "INFLUX_USERNAME": "<datahub_username>",
        "INFLUX_PASSWORD": "<datahub_password>"
      }
    }
  }
}
```

## 3. Verify

Restart Windsurf so the new MCP server is picked up. The Litmus tools should be available in the agent's tool list.

## Reference

- [Windsurf: MCP docs](https://docs.windsurf.com/windsurf/mcp)
- [Headers Reference](#)