Install for Windsurf

1. Mint a token

Open API tokens, create a token, copy the value (shown once).

A safe starter set of abilities:

forms:read, submissions:read, submissions:write, webhooks:read, insights:read.

2. Edit MCP config

text

~/.codeium/windsurf/mcp_config.json

Windsurf uses serverUrl (not url) for remote HTTP servers - copy/pasting Cursor's snippet here will fail silently.

json

{
  "mcpServers": {
    "formspring": {
      "serverUrl": "https://formspring.io/mcp-server",
      "headers": {
        "Authorization": "Bearer ${env:FORMSPRING_TOKEN}"
      }
    }
  }
}

Windsurf also supports ${file:/path/to/secret} if you'd rather keep the token outside your shell environment.

Heads up: Cascade caps the total live tool count at 100 across all configured MCPs. If you also run a big toolkit alongside Formspring, narrow Formspring's abilities to just what you need (e.g. drop forms:write, webhooks:write) so it doesn't crowd out other tools.

3. Reload Cascade

Open Cascade (⌘L macOS, Ctrl+L Windows/Linux), click the refresh icon next to the MCP indicator. Or fully quit and relaunch.

Try a prompt

"List my forms."

"Triage spam in the contact form. Show me your plan before applying anything."

"Are any of my webhooks unhealthy? Replay any failed deliveries."

What's next

Tools → - full catalogue
Prompt examples → - paste-ready workflows
Troubleshooting → - 401/403 fixes