Connecting Icypeas MCP and Cursor

Step-by-step Tutorial

The following tutorial will allow you to use Icypeas MCP from Cursor.

Estimated time for the whole setup: <1 minute.

Open Cursor.

Access the settings by clicking the gear icon in the top right corner, or use the shortcut:

• Mac: Cmd + Shift + J
• Windows/Linux: Ctrl + Shift + J

Click "Tools & MCPs". Then, click "Add Custom MCP":

‍

Cursor opens the file "mcp.json". Replace the placeholder text with this one:

{

 "mcpServers": {

   "Icypeas-MCP": {

     "url": "https://mcp.icypeas.com/mcp"

   }

 }

}

‍

‍

Close the editing tab for mcp.json. Then, click "Connect".

‍

You’re redirected to a page where you must enter your Icypeas API key:

‍

To get your Icypeas API key, sign in to your Icypeas account, click “API” and copy your key.

‍

Wait for 3-4 seconds while you’re connecting your Cursor account to the Icypeas MCP server:

‍

Come back to Cursor. Your MCP is installed:

‍

Tips for Advanced Users

1. ‍Watch your credit usage: Always test your pipeline on a small data sample and check your credit usage before scaling up. Occasionally, Cursor might overcomplicate a workflow by adding unnecessary steps, so a test run ensures you don't waste your Icypeas credits.
2. Combine MCPs for end-to-end pipelines: Connect multiple tools—like HubSpot and Instantly—so Cursor can orchestrate your entire workflow. You can automate the full process, from lead sourcing and enrichment straight through to your sequencer.

‍

FAQ

‍Can I see how many credits have been consumed by Cursor?

To see how many Icypeas credits Cursor consumed, ask Cursor to fetch your credit balance before and after the task. The delta gives you the amount of credits consumed during the task. 

‍What kind of tasks can I ask Cursor to do once connected to Icypeas?

Once connected, you can prompt Cursor to perform tasks directly, such as: "Find the contact email for the CEO of [Company Name]," "Verify this list of email addresses in my CSV," or "Write a Python script that uses the Icypeas MCP to enrich my leads database."

Do I need a paid Icypeas account to use the MCP integration?

You will need an active Icypeas API key to authenticate the MCP server. While Icypeas offers a free trial with 50 free credits, you will eventually need a plan for higher-volume use.

Is it secure to give Cursor access to my Icypeas API key?

Yes. The Model Context Protocol (MCP) is designed with security in mind. Cursor runs in the cloud on secured servers.

‍