How to integrate Icypeas MCP with Atomic Agent

Connect Atomic Agent to Icypeas MCP. Find verified email for john doe at acme.com, bulk search emails for 100 new leads, and more using natural language, with authentication handled for you.

Icypeas logoIcypeas
Api Key

Icypeas is an email discovery and verification service for professionals. It helps you find and verify work email addresses quickly and reliably.

22 Tools

Introduction

Atomic Agent is an open-source AI agent that runs on your machine and supports local models through llama.cpp. Connect it to 1,700+ apps through Composio, including Icypeas.

This guide uses Atomic Agent's built-in Composio integration. You need Atomic Agent v0.5.6 or later, your own Composio API key, and a Icypeas account. See the Atomic Agent documentation for installation instructions.

For exact tool slugs and parameter tables, see the tool catalog in the Composio docs.

Also integrate Icypeas with

How Atomic Agent connects to Icypeas

Atomic Agent connects to Composio's Tool Router over Streamable HTTP MCP. It discovers the tools needed for your request, and Composio handles account authentication.

Execution and account-connection tools follow Atomic Agent's configured approval policy. Review any approval prompt before allowing an action on your connected account.

Connect Icypeas to Atomic Agent

  1. Sign up or sign in to the Composio dashboard. Copy your API key.
  2. In Atomic Agent, open the Integrations tab and select Composio. Select API key, press e, paste the key, and press Enter. The tools become available immediately, without a restart.
  3. Ask Atomic Agent to do something in Icypeas. It searches Composio for the right tool.
  4. On first use, open the sign-in link returned in the chat. Connect your Icypeas account, then return to Atomic Agent to continue.

Headless setup

Add the following line to ~/.atomic-agent/.env, replacing YOUR_COMPOSIO_API_KEY with your key. Start Atomic Agent after saving the file.

bash
COMPOSIO_API_KEY=YOUR_COMPOSIO_API_KEY

What is the Icypeas MCP server, and what's possible with it?

The Icypeas MCP server is an implementation of the Model Context Protocol that connects your AI agent and assistants like Claude, Cursor, etc directly to your Icypeas account. It provides structured and secure access to professional email discovery and verification, so your agent can perform actions like finding emails, verifying addresses, searching company data, and scanning domains on your behalf.

  • Accurate email discovery and verification: Instantly find and verify professional email addresses using first name, last name, and company domain to supercharge your outreach or lead generation.
  • Bulk prospecting and search management: Launch bulk email or profile URL searches for thousands of contacts at once, then track progress and fetch results without manual oversight.
  • Comprehensive company and people lookup: Search for companies or filter people by name, title, company, and more to enrich your CRM or build targeted prospect lists efficiently.
  • Domain scanning for role-based emails: Scan entire company domains to discover all available role-based email addresses, simplifying large-scale contact discovery.
  • Subscription and usage insights: Check your Icypeas subscription details and remaining credits, helping you stay on top of your usage and plan outreach campaigns smarter.

Use Icypeas from Atomic Agent

With your account connected, ask Atomic Agent to work with Icypeas in natural language. You can connect more apps through the same Composio integration as you need them.

Visit the Atomic Agent website or inspect the Atomic Agent source code.

Troubleshooting

Why is my API key rejected?

Copy the key directly from the Composio dashboard. Atomic Agent requires ASCII characters because it sends the key in an HTTP header. Remove any extra characters introduced when copying.

Why are Composio tools unavailable after saving a key?

Check that you use Atomic Agent v0.5.6 or later and that Composio is enabled in your configuration. A "composio": { "enabled": false } setting disables the integration while keeping the saved key on disk.

Does Composio have a free plan?

The Hobby plan includes 100,000 tool calls per month. Composio-managed OAuth apps have a lower included allowance. See Composio pricing for the current limits that apply to your connection.

TOOLS

Supported Tools

Every Icypeas action and event your agent gets out of the box.

Bulk Email Search

Initiate a bulk email search using names and company domains or names, with up to 5,000 rows per request; the job returns a file identifier for tracking and results.

Find Profile URLs Bulk

Tool to perform bulk search for profile URLs based on firstname, lastname, and company/domain or job title.

Bulk Reverse Email Lookup

Look up LinkedIn profile URLs for 2–50 professional email addresses in one request, returning per-email results.

Scrape Bulk

Retrieve multiple LinkedIn company or profile records in one request, up to 50 inputs.

Check Search Progress

Check the processing progress of a single search item or bulk search file by ID, with pagination support.

Count Companies

Tool to count companies in Icypeas database matching specified filters without returning data or being charged.

Count People

Tool to count people matching specified filters without retrieving data; free.

Domain Scan

Initiate a scan for role-based email addresses using a domain or company name; the response may contain a search item ID and initial status for tracking.

Fetch Bulk Search Info

Retrieve bulk search files with status and progress, optionally filtering by file or status, with pagination support.

Fetch Subscription Information

Retrieves subscription details and remaining credits for an Icypeas account, using the account owner's email associated with the API key.

Find Companies

Tool to search companies in Icypeas database.

Find Company URL

Find a company profile URL using its name or domain.

Reverse Email Lookup

Find the LinkedIn profile URL behind a single professional email address.

Find People

Search for people/leads in the Icypeas database.

Find Profile URL

Finds a person's LinkedIn profile URL using their name and company or job title.

Find Single Email

Initiates an asynchronous email search using a prospect's name and company or domain, returning a search item ID on success for retrieving the result.

Statistics Bulk Search

Parses the statistics data from a bulk search completion webhook.

Retrieve Search Results

Retrieves a search result by ID or paginates through bulk search results.

Scrape Company

Retrieve company profile data from a LinkedIn company URL.

Scrape Profile

Retrieve profile data from a public LinkedIn profile URL.

Setup Notifications

Provides instructions for setting up Icypeas push notifications and webhooks for bulk searches or single search updates.

Verify Email Address

Initiates verification of an email address for deliverability, returning a verification item ID on success for retrieving the result.

FAQ

Frequently asked questions

Start with Icypeas.It takes 30 seconds.

Managed auth, hosted MCP servers, and every Icypeas tool your agent needs.Free to start.

Start building