Prospeo

This MCP server enables integration with the Prospeo API to find work emails, discover emails by domain, and enrich profiles from LinkedIn URLs. It lets you extend your MCP client with targeted email and profile enrichment capabilities, powered by Prospeo.

How to use

You connect this server to your MCP client to access Prospeo’s email finding and LinkedIn enrichment capabilities. Start the server locally or run it via a container, then configure your MCP client to point to the local process or to a remote endpoint if you choose to run it elsewhere. Use the available tools to: locate a work email from a name and company, retrieve emails associated with a domain, and enrich a LinkedIn-based profile with a verified work email.

How to install

Prerequisites you need before installation are: a working Node.js runtime and npm (Node 14+ is common for MCP servers), and Git for cloning repositories.

Step by step commands to set up the server locally:

# 1) Clone the repository
git clone https://example.com/meerkats-ai/prospeo-mcp-server.git

# 2) Install dependencies
npm install

# 3) Create environment file with your Prospeo API key
# PROSPEO_API_KEY=your_api_key_here
```} ,{

4. Build the server

npm run build

5. Start the server locally

npm start

Docker setup

You can also run the server using Docker Compose. Prepare a .env file with your Prospeo API key, then start the containers.

# 1) Clone the repository (or use the same directory structure you prefer)
# 2) Create a .env file with your Prospeo API key
# PROSPEO_API_KEY=your_api_key_here

# 3) Build and run with Docker Compose
docker-compose up -d

Configuration for MCP client

To enable the MCP client to communicate with this server, add the following configuration to your MCP settings. This config runs a local process that exposes the MCP endpoints for Prospeo.

{
  "mcpServers": {
    "prospeo": {
      "command": "node",
      "args": ["path/to/prospeo/dist/index.js"],
      "env": {
        "PROSPEO_API_KEY": "your_api_key_here"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

Security and secrets

Keep your Prospeo API key secure. Do not commit keys to version control. Use environment variable management to supply the API key at runtime, and restrict access to the MCP server process.

Examples and notes

The server exposes three primary capabilities: find a work email from a person’s name and company, discover emails tied to a domain, and enrich a profile using a LinkedIn URL. Use these capabilities through your MCP client by invoking the corresponding endpoints or tool names provided by your MCP integration.

Available tools

prospeo_find_work_email

Find a work email using a person's name and their company information.

prospeo_find_domain_emails

Find email addresses associated with a specific domain.

prospeo_enrich_from_linkedin

Find a work email and enrich person data from a LinkedIn URL.