CODEIUM · MCP CLIENTQUICKSTART · 2 MIN

Windsurf × Hail

Windsurf's Cascade agent treats MCP servers as first-class collaborators. Hail slots in alongside your other tools with zero friction.

Windsurf EditorCascade Agent

Three steps. That's the bar.

~120 SECONDS · COFFEE OPTIONAL
01

Grab an API key

Sign in to the Hail console and create a project key. Keep it scoped to the project — you can rotate or kill it any time without touching the rest of your stack.

console.hail.so → Keys → New
02

Drop Hail into your config

Add the Hail MCP server using the snippet below. Paste it where this client expects MCP servers — the path varies, the shape doesn't.

Windsurf → Settings → MCP Servers → Add server

JSON · ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "hail": {
      "serverUrl": "https://mcp.hail.so/v1",
      "auth": { "type": "bearer", "token": "hl_live_••••" }
    }
  }
}
03

Try it once. It works or it doesn't.

Reload the client. The Hail tools should surface in the agent's toolset. Send the prompt below — if a call is placed, an SMS lands, or an email shows up in the inbox view, you're done.

Cascade prompt: "Text +1-415-555-0123: deploy is green, ship it."
■ NOTES & GOTCHAS
  • Cascade pre-flights tool calls — you confirm each call/SMS the first time.
  • Workspace-scoped configs override global; useful for per-project numbers.

Hail your first call — from this client.

Self-host on your own carrier or claim a managed number. Either way, your agent picks up the phone in ~120 seconds.

■ ALSO AVAILABLE FOR