Icypeas

icypeas-mcp-server

javascript

0

GitHub Stars

javascript

Language

7 months ago

First Indexed

3 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "meerkats-ai-icypeas-mcp-server": {
      "command": "node",
      "args": [
        "path/to/icypeas/dist/index.js"
      ],
      "env": {
        "ICYPEAS_API_KEY": "YOUR_API_KEY_HERE"
      }
    }
  }
}

You run an MCP Server that connects to the Icypeas API to locate work emails using a person’s name and company information. This server lets you perform email lookups in automation pipelines and tools that rely on MCP endpoints.

How to use

Connect to this server from your MCP client and invoke the icypeas_find_work_email tool to locate a work email based on a person’s name and their company. Use this capability to enrich contact data, verify emails for outreach, or populate CRM data with verified contact points.

When you configure your MCP client, the server exposes a stdio endpoint that runs locally. The icypeas_find_work_email tool accepts a name and company context and returns the best-matched work email found via the Icypeas API. Ensure you provide your API key as an environment variable so the server can authenticate with Icypeas on each request.

How to install

Prerequisites you must have before installing this MCP server:

Node.js (recommended LTS version)
npm (comes with Node.js)

Step-by-step setup flow to run locally:

# 1) Install dependencies
npm install

# 2) Create a local environment file and set your Icypeas API key
# Use the example as a template if you have one
# ICYPEAS_API_KEY=your_api_key_here

# 3) Build the server
npm run build

# 4) Start the server
npm start

Configuration and runtime details

The server is configured to run locally via a standard Node.js runtime. It expects an Icypeas API key to be provided through the environment variable ICYPEAS_API_KEY. You can set this in a local .env file or in your deployment environment.

Useful notes for deployment and operation include starting the server after building, managing environment variables securely, and ensuring network access to Icypeas endpoints for email lookups.

Additional notes

If you prefer containerized deployment, you can use Docker Compose to manage the runtime. Ensure the ICYPEAS_API_KEY is supplied in the environment for the container to access the Icypeas API.

Security considerations

Protect your Icypeas API key. Do not commit it to source control. Use a secure mechanism for injecting environment variables in both development and production environments.

Available tools

icypeas_find_work_email

Find a work email using name and company information via Icypeas API