How to Use the Icypeas MCP in Windsurf

Q: How does Icypeas handle bulk validation inside Windsurf?

Cascade uses verifyemail to check addresses sequentially. It loops through your prospect lists autonomously, updating each record in real time without requiring manual intervention.

Q: Can I monitor my API budget using Icypeas in Windsurf?

Yes. Cascade calls getcredits before running large batch searches to check your remaining balance. It prevents your runs from failing halfway through due to empty credits.

Q: How does Windsurf use Icypeas to find missing contact info?

Cascade combines searchprospects with findemail to locate people at target domains. It builds a complete profile, verifies the address, and appends it to your workspace.

Build clean, verified outbound lists inside Windsurf while Cascade handles the multi-step verification pipeline.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Icypeas MCP to Windsurf

Create your Vinkius account to connect Icypeas to Windsurf and route execution through our secure gateway. The platform manages server hosting, runtime updates, and security layers. Configuration requires no manual server provisioning.

GDPR Free for Subscribers

Setup Icypeas with Windsurf

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Let Windsurf chain your lead generation

The `search_prospects` tool lets your agent query your prospect lists directly from the editor. Cascade reads your target criteria, pulls the raw leads, and immediately starts cleaning them up without asking for permission at every step. Once it grabs the list, Cascade feeds those contacts directly into `find_email` to dig up missing contact details. It handles the entire sequence autonomously, saving you from manual copy-paste cycles.

Keep your deliverability high

The `verify_email` tool runs deliverability checks on every address your agent finds before you send a single message. Cascade coordinates this check in the background, filtering out dead mailboxes that would otherwise bounce and hurt your domain reputation. While doing this, the agent uses `get_credits` to monitor your usage against your monthly limit. You set the budget, and the MCP Server makes sure Cascade stops before you burn through your API credits.

Sync campaigns with this MCP Server

The `list_campaigns` tool exposes your active outreach efforts directly to your development environment. Cascade reads your current campaign metrics using `get_campaign` and flags which lists need more prospects. It then pulls from `list_prospects` to balance the load across your active sequences. You get a fully updated pipeline without ever leaving your IDE.

Setup guide

Set up Icypeas MCP in Windsurf

Prerequisites

Windsurf IDE installed (macOS, Windows, or Linux)
Active Vinkius subscription with a valid endpoint token

1

Open MCP configuration

Click the Cascade assistant icon in the sidebar, then click the hammer icon (🔨) at the top of the panel. Select "Configure" to open ~/.codeium/windsurf/mcp_config.json.
2

Add the Icypeas MCP

Paste the JSON snippet shown on the right into the mcpServers object. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Refresh MCPs

Go back to the hammer icon (🔨) in Cascade and click "Refresh". Windsurf will detect the new server. No full restart is needed — the connection is hot-reloaded.
4

Verify in Cascade

Start a new Cascade conversation and ask something like "Show my Icypeas payment history." If connected, Cascade will call the Icypeas tools directly. You will see a green dot next to the server name in the MCP panel.

mcp_config.json

{
  "mcpServers": {
    "icypeas-mcp": {
      "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    }
  }
}

Get your connection token →

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Icypeas. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect Icypeas now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about Icypeas MCP in Windsurf

Cascade uses `verify_email` to check addresses sequentially. It loops through your prospect lists autonomously, updating each record in real time without requiring manual intervention.

Yes. Cascade calls `get_credits` before running large batch searches to check your remaining balance. It prevents your runs from failing halfway through due to empty credits.

Cascade combines `search_prospects` with `find_email` to locate people at target domains. It builds a complete profile, verifies the address, and appends it to your workspace.

Open your settings and add the server configuration under the `mcpServers` key in your json config file. The agent will auto-discover all ten tools instantly.

Your prospect data stays inside the secure V8 sandbox. The MCP Server routes calls directly to the API, and no contact information is stored on our servers after the session ends.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript