x402serps logox402serps

Web search in Windsurf with x402serps

Windsurf's Cascade agent supports remote MCP servers with headers. Note that Windsurf uses serverUrl, not url.

Edit mcp_config.json

Cascade → MCP icon → Configure, or edit ~/.codeium/windsurf/mcp_config.json. (Newer Devin Desktop builds use ~/.config/devin/mcp_config.json.)

{
  "mcpServers": {
    "x402serps": {
      "serverUrl": "https://x402serps.com/api/mcp",
      "headers": {
        "X-Trial": "1"
      }
    }
  }
}

With card credits

Cascade expands ${env:NAME} in headers, so the key can live in your environment:

{
  "mcpServers": {
    "x402serps": {
      "serverUrl": "https://x402serps.com/api/mcp",
      "headers": {
        "Authorization": "Bearer ${env:X402SERPS_KEY}"
      }
    }
  }
}

Click refresh in the MCP panel after saving.

Pay per call with x402 instead: tool calls without a trial header or key return the x402 payment requirements, which an x402-aware client can pay in USDC on Base or Solana. Search is $0.004 a call. Buy a credit key on the pricing page.

Pricing · Docs · MCP · Integrations · Help

Related

Cursor setupRead more →VS Code (GitHub Copilot) setupRead more →Cline and Roo Code setupRead more →Zed setupRead more →Claude Desktop setupRead more →ChatGPT setupRead more →