# How to integrate Icypeas MCP with Hermes ```json { "title": "How to integrate Icypeas MCP with Hermes", "toolkit": "Icypeas", "toolkit_slug": "icypeas", "framework": "Hermes", "framework_slug": "hermes-agent", "url": "https://composio.dev/toolkits/icypeas/framework/hermes-agent", "markdown_url": "https://composio.dev/toolkits/icypeas/framework/hermes-agent.md", "updated_at": "2026-05-06T08:16:13.782Z" } ``` ## Introduction Hermes is a 24/7 autonomous agent that lives on your computer or server — it remembers what it learns and evolves as your usage grows. This guide explains the easiest and most robust way to connect your Icypeas account to Hermes. You can do this through either Composio Connect CLI or Composio Connect MCP. For personal use we recommend the CLI, but you won't go wrong with MCP either. ## Also integrate Icypeas with - [OpenAI Agents SDK](https://composio.dev/toolkits/icypeas/framework/open-ai-agents-sdk) - [Claude Agent SDK](https://composio.dev/toolkits/icypeas/framework/claude-agents-sdk) - [Claude Code](https://composio.dev/toolkits/icypeas/framework/claude-code) - [Claude Cowork](https://composio.dev/toolkits/icypeas/framework/claude-cowork) - [Codex](https://composio.dev/toolkits/icypeas/framework/codex) - [OpenClaw](https://composio.dev/toolkits/icypeas/framework/openclaw) - [CLI](https://composio.dev/toolkits/icypeas/framework/cli) - [Google ADK](https://composio.dev/toolkits/icypeas/framework/google-adk) - [LangChain](https://composio.dev/toolkits/icypeas/framework/langchain) - [Vercel AI SDK](https://composio.dev/toolkits/icypeas/framework/ai-sdk) - [Mastra AI](https://composio.dev/toolkits/icypeas/framework/mastra-ai) - [LlamaIndex](https://composio.dev/toolkits/icypeas/framework/llama-index) - [CrewAI](https://composio.dev/toolkits/icypeas/framework/crew-ai) ## TL;DR ### What is Composio Connect? Composio Connect is a consumer offering that lets anyone plug 1,000+ applications directly into their agent harness — including Hermes. It can: - Search and load tools from relevant toolkits on-demand, reducing context usage. - Chain multiple tools to accomplish complex workflows via a remote workbench, without excessive back-and-forth with the LLM. - Manage app authentication end-to-end with zero manual overhead. ## Connect Icypeas to Hermes ### Integrating Icypeas with Hermes ### Using Composio Connect CLI 1. Install the Composio CLI Run the install script directly, or paste https://composio.dev/hermes into your Hermes chat box to have it installed for you. ```bash curl -fsSL https://composio.dev/install | bash ``` ## 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. ## Supported Tools | Tool slug | Name | Description | |---|---|---| | `ICYPEAS_BULK_EMAIL_SEARCH` | Bulk Email Search | Tool to start a bulk email search job. Use when you have up to 5000 names and domains to batch-find emails via the ICYPEAS bulk-search endpoint. | | `ICYPEAS_CHECK_PROGRESS` | Check Search Progress | Tool to check the progress of a search by its ID. Use after initiating a single or bulk search to poll for its processing status. | | `ICYPEAS_DOMAIN_SCAN` | Domain Scan | Tool to scan a domain for role-based email addresses. Use when you need to discover all role-based emails for a specific domain. | | `ICYPEAS_FETCH_BULK_SEARCH_INFO` | Fetch Bulk Search Info | Tool to fetch information about bulk search files. Use when you need status and pagination details after initiating bulk search operations. | | `ICYPEAS_FETCH_SUBSCRIPTION_INFO` | Fetch Subscription Information | Tool to fetch subscription and credit info. Use after obtaining a valid API key. | | `ICYPEAS_FIND_COMPANIES` | Find Companies | Tool to search companies in Icypeas database. Use when you need to find companies matching filters like industry, location, or headcount. | | `ICYPEAS_FIND_COMPANY_URL` | Find Company URL | Tool to find a single company profile URL using a company name or domain. Use when you need to initiate a profile-URL search for a given company identifier. | | `ICYPEAS_FIND_PEOPLE` | Find People | Tool to search for people in the leads database. Use when you need to filter people by name, title, company, and other attributes. | | `ICYPEAS_FIND_PROFILE_URL` | Find Profile URL | Tool to find a single profile URL. Use after confirming first name, last name, and either company/domain or job title. Example: "Find the LinkedIn URL for Pierre Landoin at icypeas.com." | | `ICYPEAS_FIND_PROFILE_URLS_BULK` | Find Profile URLs Bulk | Tool to perform bulk search for profile URLs. Use when you need to resolve multiple prospects' profile URLs at once. | | `ICYPEAS_FIND_SINGLE_EMAIL` | Find Single Email | Tool to discover a single email address using a person's first or last name with a company domain or name. Use when needing to retrieve a prospect's specific email before outreach. | | `ICYPEAS_RETRIEVE_SEARCH_RESULTS` | Retrieve Search Results | Tool to retrieve the results of a search by ID or to paginate through bulk search results. Use after initiating a search to fetch individual or multiple search results. | | `ICYPEAS_SCRAPE_COMPANY` | Scrape Company | Tool to scrape company profile information from a LinkedIn company URL. Use when you have a company LinkedIn URL to retrieve detailed company data. | | `ICYPEAS_SCRAPE_PROFILE` | Scrape Profile | Tool to initiate scraping of a LinkedIn profile. Use when you have a public LinkedIn profile URL and need a job ID and status to later fetch full details. | | `ICYPEAS_SETUP_NOTIFICATIONS` | Setup Notifications | Tool to set up push notifications. Use when you need to receive real-time updates about your searches. Note: Icypeas requires webhook configuration via the dashboard UI; no public API endpoint exists for setup. | | `ICYPEAS_STATISTICS_BULK_SEARCH` | Statistics Bulk Search | Tool to parse bulk search statistics webhook. Use when processing the completion notification of a bulk search. | ## Supported Triggers None listed. ## Creating MCP Server - Stand-alone vs Composio SDK The Icypeas MCP server provides comprehensive access to Icypeas operations through Composio. Once connected, Hermes can perform all major Icypeas actions on your behalf using natural language commands. ## Complete Code None listed. ## Conclusion ### Way Forward With Icypeas connected, Hermes can now act on your behalf whenever it detects a relevant task or you ask it to. From here, you can extend Hermes further: - Connect more apps: Calendar, Slack, Notion, Linear, and hundreds of others are available through the same Composio Connect setup. Each new integration compounds what Hermes can do for you. - Build workflows across tools: Once multiple apps are connected, Hermes can chain actions together — turn an email into a calendar invite, a Slack message into a Linear ticket, or a meeting note into a follow-up draft. - Let it learn your patterns: The more you use Hermes, the better it gets at anticipating how you'd handle recurring tasks. Give it feedback on drafts and decisions, and it will adapt. If you run into trouble or want to share what you've built, join the [community](https://discord.com/invite/composio) or check out the [Docs](https://docs.composio.dev?utm_source=toolkits&utm_medium=framework_template&utm_campaign=hermes&utm_content=docs) for deeper configuration options. ## How to build Icypeas MCP Agent with another framework - [OpenAI Agents SDK](https://composio.dev/toolkits/icypeas/framework/open-ai-agents-sdk) - [Claude Agent SDK](https://composio.dev/toolkits/icypeas/framework/claude-agents-sdk) - [Claude Code](https://composio.dev/toolkits/icypeas/framework/claude-code) - [Claude Cowork](https://composio.dev/toolkits/icypeas/framework/claude-cowork) - [Codex](https://composio.dev/toolkits/icypeas/framework/codex) - [OpenClaw](https://composio.dev/toolkits/icypeas/framework/openclaw) - [CLI](https://composio.dev/toolkits/icypeas/framework/cli) - [Google ADK](https://composio.dev/toolkits/icypeas/framework/google-adk) - [LangChain](https://composio.dev/toolkits/icypeas/framework/langchain) - [Vercel AI SDK](https://composio.dev/toolkits/icypeas/framework/ai-sdk) - [Mastra AI](https://composio.dev/toolkits/icypeas/framework/mastra-ai) - [LlamaIndex](https://composio.dev/toolkits/icypeas/framework/llama-index) - [CrewAI](https://composio.dev/toolkits/icypeas/framework/crew-ai) ## Related Toolkits - [Aeroleads](https://composio.dev/toolkits/aeroleads) - Aeroleads is a B2B lead generation platform for finding business emails and phone numbers. Grow your sales pipeline faster with powerful prospecting tools. - [Autobound](https://composio.dev/toolkits/autobound) - Autobound is an AI-powered sales engagement platform that crafts hyper-personalized outreach and insights. It helps sales teams boost response rates and close more deals through tailored content and recommendations. - [Better proposals](https://composio.dev/toolkits/better_proposals) - Better Proposals is a web-based tool for crafting and sending professional proposals. It helps teams impress clients and close deals faster with slick, easy-to-use templates. - [Bidsketch](https://composio.dev/toolkits/bidsketch) - Bidsketch is a proposal software that helps businesses create professional proposals quickly and efficiently. It streamlines the proposal process, saving time while boosting client win rates. - [Bolna](https://composio.dev/toolkits/bolna) - Bolna is an AI platform for building conversational voice agents. It helps businesses automate support and streamline interactions through natural, voice-powered conversations. - [Botsonic](https://composio.dev/toolkits/botsonic) - Botsonic is a no-code AI chatbot builder for easily creating and deploying chatbots to your website. It empowers businesses to offer conversational experiences without writing code. - [Botstar](https://composio.dev/toolkits/botstar) - BotStar is a comprehensive chatbot platform for designing, developing, and training chatbots visually on Messenger and websites. It helps businesses automate conversations and customer interactions without coding. - [Callerapi](https://composio.dev/toolkits/callerapi) - CallerAPI is a white-label caller identification platform for branded caller ID and fraud prevention. It helps businesses boost customer trust while stopping spam, fraud, and robocalls. - [Callingly](https://composio.dev/toolkits/callingly) - Callingly is a lead response management platform that automates immediate call and text follow-ups with new leads. It helps sales teams boost response speed and close more deals by connecting seamlessly with CRMs and lead sources. - [Callpage](https://composio.dev/toolkits/callpage) - Callpage is a lead capture platform that lets businesses instantly connect with website visitors via callback. It boosts lead generation and increases your sales conversion rates. - [Clearout](https://composio.dev/toolkits/clearout) - Clearout is an AI-powered service for verifying, finding, and enriching email addresses. It boosts deliverability and helps you discover high-quality leads effortlessly. - [Clientary](https://composio.dev/toolkits/clientary) - Clientary is a platform for managing clients, invoices, projects, proposals, and more. It streamlines client work and saves you serious admin time. - [Convolo ai](https://composio.dev/toolkits/convolo_ai) - Convolo ai is an AI-powered communications platform for sales teams. It accelerates lead response and improves conversion rates by automating calls and integrating workflows. - [Delighted](https://composio.dev/toolkits/delighted) - Delighted is a customer feedback platform based on the Net Promoter System®. It helps you quickly gather, track, and act on customer sentiment. - [Docsbot ai](https://composio.dev/toolkits/docsbot_ai) - Docsbot ai is a platform that lets you build custom AI chatbots trained on your documentation. It automates customer support and content generation, saving time and improving response quality. - [Emelia](https://composio.dev/toolkits/emelia) - Emelia is an all-in-one B2B prospecting platform for cold-email, LinkedIn outreach, and prospect research. It streamlines outbound campaigns so you can find, engage, and warm up leads faster. - [Findymail](https://composio.dev/toolkits/findymail) - Findymail is a B2B data provider offering verified email and phone contacts for sales prospecting. Enhance outreach with automated exports, email verification, and CRM enrichment. - [Freshdesk](https://composio.dev/toolkits/freshdesk) - Freshdesk is customer support software with ticketing and automation tools. It helps teams streamline helpdesk operations for faster, better customer support. - [Fullenrich](https://composio.dev/toolkits/fullenrich) - FullEnrich is a B2B contact enrichment platform that aggregates emails and phone numbers from 15+ data vendors. Instantly find and verify lead contact data to boost your outreach. - [Gatherup](https://composio.dev/toolkits/gatherup) - GatherUp is a customer feedback and online review management platform. It helps businesses boost their reputation by streamlining how they collect and manage customer feedback. ## Frequently Asked Questions ### What are the differences in Tool Router MCP and Icypeas MCP? With a standalone Icypeas MCP server, the agents and LLMs can only access a fixed set of Icypeas tools tied to that server. However, with the Composio Tool Router, agents can dynamically load tools from Icypeas and many other apps based on the task at hand, all through a single MCP endpoint. ### Can I use Tool Router MCP with Hermes? Yes, you can. Hermes fully supports MCP integration. You get structured tool calling, message history handling, and model orchestration while Tool Router takes care of discovering and serving the right Icypeas tools. ### Can I manage the permissions and scopes for Icypeas while using Tool Router? Yes, absolutely. You can configure which Icypeas scopes and actions are allowed when connecting your account to Composio. You can also bring your own OAuth credentials or API configuration so you keep full control over what the agent can do. ### How safe is my data with Composio Tool Router? All sensitive data such as tokens, keys, and configuration is fully encrypted at rest and in transit. Composio is SOC 2 Type 2 compliant and follows strict security practices so your Icypeas data and credentials are handled as safely as possible. --- [See all toolkits](https://composio.dev/toolkits) · [Composio docs](https://docs.composio.dev/llms.txt)