Skip to main content

​
Install Omni in Windsurf

Windsurf’s Cascade agent has native MCP support over streamable HTTP. Auth headers can pull values from environment variables, so you don’t have to hard-code your key into the config file.

​
Prerequisites

  • Omni API key (free — 250 calls/month). Sign up at secapi.ai. Export OMNI_DATASTREAM_API_KEY in your shell.
  • Windsurf installed and signed in.

​
Install

Open (or create) ~/.codeium/windsurf/mcp_config.json on macOS/Linux, or %USERPROFILE%\.codeium\windsurf\mcp_config.json on Windows: 
{
  "mcpServers": {
    "omni-datastream": {
      "serverUrl": "https://api.secapi.ai/mcp",
      "headers": {
        "x-api-key": "${env:OMNI_DATASTREAM_API_KEY}"
      }
    }
  }
}
Open the Cascade chat, click the MCP icon, and hit Refresh — Windsurf does not auto-watch the config file. The Omni MCP tools should appear in the tool list.

​
Verify

In a Cascade chat, ask:
Show me Apple’s latest 8-K filing.
Cascade should call the filings.latest tool with ticker: AAPL, form: 8-K and return the filing URL plus a short summary.

​
Troubleshooting

  • Server doesn’t appear in the MCP panel — click Refresh in the panel; Windsurf reads the config on demand, not on save.
  • 401 Unauthorized — environment variable is unset or unreadable from Windsurf’s process. Restart Windsurf after export OMNI_DATASTREAM_API_KEY=…, or replace ${env:OMNI_DATASTREAM_API_KEY} with the literal key for a quick test.
  • Old config path doesn’t work — older guides reference ~/.codeium/mcp_config.json (without windsurf/). The current canonical path includes the windsurf/ segment.
  • url vs serverUrl — both keys are accepted, but serverUrl is canonical in current Windsurf docs.

​
Next