CGStrategyLab/icypeas-mcp

IcyPeas MCP Server

Production-ready Model Context Protocol server for comprehensive email lookup and people discovery via IcyPeas API

🚀 Quick Start

Installation

git clone https://github.com/yourusername/icypeas-mcp.git
cd icypeas-mcp
python -m venv .venv

# Activate virtual environment
source .venv/bin/activate          # Linux/Mac
# OR
.venv\Scripts\activate             # Windows

pip install -r requirements.txt
cp config_template.py config.py    # Add your IcyPeas API credentials

Claude Desktop Integration

Add to your claude_desktop_config.json:

Windows:

{
  "mcpServers": {
    "icypeas": {
      "command": "C:\\path\\to\\icypeas-mcp\\.venv\\Scripts\\python.exe",
      "args": ["C:\\path\\to\\icypeas-mcp\\main.py"],
      "cwd": "C:\\path\\to\\icypeas-mcp"
    }
  }
}

Linux/Mac:

{
  "mcpServers": {
    "icypeas": {
      "command": "/path/to/icypeas-mcp/.venv/bin/python",
      "args": ["/path/to/icypeas-mcp/main.py"],
      "cwd": "/path/to/icypeas-mcp"
    }
  }
}

🔍 Features

Two Powerful Tools

find_person_email - Individual email lookup

• Perfect for targeted outreach when you know name + company
• Returns email with confidence score and verification

advanced_people_search - Comprehensive people discovery

• 13 tested filters: companies, job titles, locations, skills, education, etc.
• Optimized for lead generation, recruiting, market research
• Smart defaults (2 results) to conserve API credits

📋 Usage Examples

Find a specific person's email:

{
  "first_name": "John",
  "last_name": "Smith",
  "company_domain_or_name": "shopify.com"
}

Discover Google engineers with Python skills:

{
  "current_company": ["Google"],
  "current_job_titles": ["Software Engineer"],
  "skills": ["Python"],
  "limit": 10
}

📖 Documentation

• - Comprehensive usage guide with examples
• MCP Documentation - Official MCP protocol guide

✅ Validation

• 100% Filter Success Rate (13/13 filters working)
• Production Tested with real API responses
• Cross-platform Compatible (Windows/Mac/Linux)
• Security Hardened (credentials excluded from git)

🔧 Requirements

• Python 3.11+
• IcyPeas API account (get one here)
• Claude Desktop for MCP integration

📞 Support

1. Check for detailed guides
2. Review
3. Ensure API credentials are valid and have credits

Ready to supercharge your professional research with Claude Desktop! 🎉