# Icypeas MCP > Icypeas: Build and clean your lead database instantly. This MCP connects your AI agent to Icypeas's full API suite for professional-grade sales automation. Use it to search large prospect lists, verify email deliverability across domains, find contact details for specific people, and manage all outreach campaigns directly through natural language prompts. ## Overview - **Category:** sales-automation - **Price:** Free - **Tags:** email-verification, prospecting, b2b-leads, contact-enrichment, outreach-automation ## Description Need a reliable way to build or clean up your lead database? This MCP handles the heavy lifting of prospecting and data enrichment so you don't have to live in spreadsheets. You tell your agent what contacts you need—maybe just people at a specific domain, or maybe an entire list based on filters. The tool finds the necessary contact information and then verifies if those emails are actually deliverable before you even send the first message. It’s built for sales teams that know data quality is everything. All this functionality is managed through Vinkius, making it accessible to your AI client without needing API keys or complex scripting. You just talk to your agent, and it handles the whole process of finding, vetting, and organizing your leads. ## Tools ### count_people Uses same filter format as find_people. Count the number of people matching a query (does not consume credits) ### domain_scan Returns a search ID — use fetch_results to retrieve found emails. Scan a domain for all role-based email addresses (contact@, admin@, etc) ### fetch_results Pass the _id returned by those tools. If mode=single, lists all single searches. Max 100 results per request. Retrieve results from previous searches by ID or list all single/bulk searches ### find_companies Returns enriched company profiles. Search the lead database for companies matching filters ### find_email Finds a likely email address for a specific person at a given company domain. ### find_people Returns enriched profiles. Use JSON filter format: {"currentJobTitle": {"include": ["CTO"]}, "location": {"include": ["US"]}} Search the lead database for people matching filters ### get_subscription Get subscription information and remaining credits ### reverse_email_lookup Find the profile URL behind a professional email address ### verify_email Checks the deliverability status of an email address to ensure it's active. ## Prompt Examples **Prompt:** ``` List all prospects in my 'Tech Startup' list. ``` **Response:** ``` I'll retrieve the prospect list for 'Tech Startup' from Icypeas. ``` **Prompt:** ``` Verify if the email 'john@example.com' is deliverable. ``` **Response:** ``` I'll check the deliverability of that email address for you. ``` **Prompt:** ``` Find the email for Jane Doe at stripe.com. ``` **Response:** ``` I'll use Icypeas to find the contact information for that person. ``` ## Capabilities ### Verify email deliverability Check an email address instantly to confirm if it will actually reach a recipient's inbox. ### Find contact details by domain Discover the probable email address for a person given their name and company domain. ### Search or list entire prospect records Retrieve full details about all your existing leads or search through them using specific filters. ### Manage outreach campaigns and lists View, retrieve, and manage the structure of your saved prospect lists and ongoing sales campaigns. ## Use Cases ### Cleaning up an old lead spreadsheet A BDR receives a massive list of contacts from an old trade show. Instead of manually checking every email, they ask their agent to process the file: it runs verify_email on all addresses and flags any that fail deliverability checks, instantly giving them a clean list for outreach. ### Targeting a new company vertical A Sales Manager needs 50 contacts at SaaS companies in Austin. They prompt the agent to use search_prospects with specific filters (Industry: SaaS, Location: Austin) and then ask for find_email on every result to build a hyper-specific outreach list. ### Auditing an existing campaign A Marketing Specialist needs to know the status of last month's 'Q3 Webinar Series' campaign. They use get_campaign and list_prospects to pull up all relevant data points—who was targeted, how many were verified, and what the current status is. ### Finding a key decision-maker A user only knows that 'John Smith' works at 'AcmeCorp'. Instead of guessing his email format, they use find_email. The agent instantly returns the verified contact information for John Smith. ## Benefits - Verify every email address using the verify_email tool. This eliminates sending messages to dead ends, saving you time and maintaining a better sender reputation. - Stop guessing contacts. Use find_email to pinpoint an individual's likely professional email just by knowing their name and company domain. - Effortlessly manage your entire pipeline. The list_campaigns and list_prospect_lists tools give you full visibility into all your outreach efforts, keeping everything in one place. - Never lose track of leads again. You can search_prospects or use list_prospects to pull up any individual's record instantly, no matter how old the contact is. - Stay organized by viewing account details and using get_credits to keep tabs on your usage. This keeps your sales process running smoothly without unexpected hiccups. ## How It Works The bottom line is, instead of logging into multiple sales platforms, you ask your AI client to manage all your lead data enrichment and outreach operations in one chat window. 1. You prompt your AI client with a request, like 'Find all prospects working at Stripe.' 2. The MCP processes that request using the Icypeas tools to pull data from your account and execute the search. 3. Your agent receives a structured result set—a list of verified contacts or campaign details—ready for you to use. ## Frequently Asked Questions **How does Icypeas MCP verify email addresses?** The verify_email tool checks an address's deliverability status against real-time data sources. It tells you whether the email is likely to land in the inbox or bounce back. **Can I find emails for people who aren't listed?** Yes, using the find_email tool, you can input a person's name and company domain. The MCP attempts to locate their professional email address through its data sources. **What if I need to search by multiple filters in Icypeas MCP?** You use the search_prospects tool, which allows you to combine multiple criteria like industry, company size, or list name. This dramatically narrows your results for better targeting. **Does this MCP help manage my sales campaigns?** Yes, tools like list_campaigns and get_prospect_list let you pull up details on any ongoing outreach effort or specific prospect list needed for review. **Is Icypeas MCP only for finding emails?** No. It's a comprehensive toolset that also lets you manage account details, get credits, and pull entire lists of prospects using multiple dedicated tools. **How do I get Icypeas API credentials?** You can find your API key in your Icypeas dashboard under 'Account Settings'. **Does email verification cost credits?** Yes, using the verify_email and find_email tools will consume credits from your Icypeas account. **Can I see my remaining credits?** Yes, the get_credits tool allows you to check your current credit balance.