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

Two steps. That's the bar.

~60 SECONDS · NO API KEY
01

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"
    }
  }
}
02

Click Allow. Then try it.

Reload the client. On first use it pops a browser tab — sign in to Hail (or sign up — takes 30 seconds), click Allow, and tokens flow back to the client. 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 supports OAuth across all three transports — Windsurf opens the consent browser tab on first connect.
  • The Hail endpoint is the MCP root, not a /mcp subpath — paste https://mcp.hail.so verbatim into serverUrl.
  • Cascade pre-flights tool calls — you confirm each call/SMS the first time.
  • Workspace-scoped configs override global; useful for per-project numbers.
  • Manage or revoke this app at https://hail.so/console/apps after first connect.
  • Self-host? Set HAIL_API_KEY as the bearer; see docs/setup/mcp.

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