Connect LeadOcean to Windsurf

Add one entry to Windsurf's MCP config, sign in through your browser, and the agent can search, count and enrich people and companies. No API key is pasted anywhere. The free plan gets the same server as Pro.

This page covers Windsurf only. Other clients are on the MCP hub.

Before you start

You need a LeadOcean account and Windsurf installed. Create a free account. It has no card and 1,000 records, one-off, and it needs a work email.

The Windsurf MCP docs, September 2026, name no paid plan for remote HTTP servers. They do say Enterprise users must turn MCP on in settings. Team admins can also allowlist servers, and once one is allowlisted, all others are blocked. If the server is refused, ask your admin.

Windsurf now has two agents, and each reads its own config. Cascade is the legacy agent. Devin Local is the default for new tabs. Pick the section that matches the agent you use.

Add the server

The server URL is https://api.leadocean.io/mcp.

Cascade. Click the ... (Actions) menu in the Cascade panel, then the Open MCP config file icon in the MCPs section. Add the entry under mcpServers and save. Windsurf's docs say remote HTTP servers need a serverUrl or url field:

{
  "mcpServers": {
    "leadocean": {
      "serverUrl": "https://api.leadocean.io/mcp"
    }
  }
}

The docs put this file at ~/.config/devin/mcp_config.json on macOS and Linux, and %APPDATA%\devin\mcp_config.json on Windows. Do not add a headers block with an API key. The server signs you in with OAuth instead.

Devin Local. The Windsurf page says servers live in config files and points to the Devin CLI for the rest. The Devin CLI docs add a remote server with one command:

devin mcp add leadocean https://api.leadocean.io/mcp

The file locations on the Windsurf page and the CLI page differ. The CLI page says versions from v3000.3 use .devin/mcp_config.json. Check the CLI page if your version is older.

Cascade caps you at 100 tools in total. LeadOcean adds 12.

Sign in

Sign-in is OAuth 2.1 in your browser, and you approve on LeadOcean. You do not register an OAuth client yourself. The LeadOcean OAuth server supports dynamic client registration at https://api.leadocean.io/oauth/register (scope mcp), so the client registers itself.

Windsurf's docs say OAuth is supported for each transport type. For Cascade they do not show the sign-in prompt, so we cannot describe it step by step. Check the server's status in the MCPs section after you save.

Devin Local is documented. A server with stale credentials shows Needs auth. Click Authenticate to re-run the browser flow. From a shell, run devin mcp login leadocean. Tokens are not shared between clients, so Windsurf signs in on its own.

To revoke, remove the app under API keys, Connected apps in your LeadOcean account.

Your first prompt

Start with a count. Counting is free.

How many CMO-level marketing leaders in the US can I email? Count only. Do not pull anyone.

The agent calls leadocean_count_leads with jobLevel set to C-Team, jobFunction set to Advertising & Marketing and country set to US. That costs 0 records. We ran the same filters on 2026-10-01 and the tool returned 22,386, an exact total.

That figure uses the tool's default email filter: verified, catch_all_valid or catch_all. It is not everyone we hold for those filters.

Devin Local asks for approval before any MCP tool call. Allow the tool for the session, or for the whole leadocean server if you trust it.

When the count looks right, ask: "Pull five of them with title and company." That calls leadocean_search_leads and costs 1 record per person returned, so 5. For a bigger sizing job, see size your TAM in Windsurf. To get addresses, see find work emails in Windsurf. To fill in a spreadsheet, see enrich a CSV in Windsurf.

The 12 tools

Windsurf lists them as leadocean_ plus the name below. Six spend no records.

A leadocean_get_lead call that finds nobody costs nothing. Exports reserve up to your limit when they start, so count first. In Cascade you can switch a tool off with the server's disabledTools array, for example ["leadocean_export_leads"]. Source: LeadOcean MCP docs, September 2026.

Troubleshooting

FAQ