npm package: @pagelines/prospect-mcp
Description: MCP server for lead enrichment and sales signals
Latest version: 1.0.11

# Prospect MCP

**Simple** lead search and enrichment. Two tools: find leads, enrich them.

## Tools

| Tool | Returns | Source |
|------|---------|--------|
| `find_leads` | `LeadSimple[]` | Apify |
| `find_leads` (enrich: true) | `Lead[]` | Apify + EnrichLayer |
| `enrich` | `Lead[]` | EnrichLayer |

## Setup

Add to your MCP client config:

```json
{
  "mcpServers": {
    "prospect": {
      "command": "npx",
      "args": ["-y", "@pagelines/prospect-mcp"],
      "env": {
        "ENRICHLAYER_API_KEY": "your-enrichlayer-key",
        "APIFY_API_KEY": "your-apify-key"
      }
    }
  }
}
```

Get API keys: [EnrichLayer](https://enrichlayer.com) (required), [Apify](https://apify.com) (required for find_leads)

---

## Reference

### `find_leads`

Search LinkedIn for leads via Apify. Set `enrich: true` to enrich each result via EnrichLayer.

| Parameter | Example | Notes |
|-----------|---------|-------|
| `query` | `"VP Sales AI tools"` | Fuzzy search query |
| `titles` | `["VP of Sales", "Head of Sales"]` | Job title matching |
| `locations` | `["California, United States"]` | Be specific with region |
| `seniority` | `["vp", "director", "cxo"]` | entry, senior, manager, director, vp, cxo, owner |
| `functions` | `["sales", "marketing"]` | Department/function |
| `companySize` | `["51-200", "201-500"]` | Employee count ranges |
| `companies` | `["https://linkedin.com/company/acme"]` | Specific companies |
| `schools` | `["Stanford University"]` | Schools attended |
| `yearsExperience` | `"3-5"` | 0-1, 1-2, 3-5, 6-10, 10+ |
| `jobChange` | `true` | Recent job changers |
| `includeEmail` | `true` | Find emails (+$0.01/profile) |
| `enrich` | `true` | Enrich each lead via EnrichLayer |
| `limit` | `25` | Max leads to return |

### `enrich`

Enrich people from emails, social URLs, or usernames. Auto-detects type per identifier:
- Email (contains @) → Email-based lookup
- URL → Platform auto-detected (LinkedIn, Twitter, GitHub)
- Plain text → Assumed LinkedIn username

| Parameter | Example |
|-----------|---------|
| `identifiers` | `["john@example.com", "https://linkedin.com/in/johndoe", "janedoe"]` |

### Output Types

**LeadSimple** (basic info from LinkedIn search):
```
firstName, lastName, fullName, headline, title, company,
linkedinUrl, linkedinUsername, city, state, country, email, avatar
```

**Lead** (full enriched profile):
```
id, firstName, lastName, fullName, headline, bio, title, company, companyDomain,
linkedinUrl, linkedinUsername, twitterUrl, twitterUsername, githubUrl, githubUsername,
city, state, country, email, phone, avatar, experiences[], education[], skills[], sources[]
```

### Cost

| Operation | Cost |
|-----------|------|
| `find_leads` (25 profiles) | ~$0.10 |
| `find_leads` + email | +$0.01/profile |
| `find_leads` + enrich | +1-2 credits/profile |
| `enrich` | 1-2 credits |

### Config

| Variable | Required | Description |
|----------|----------|-------------|
| `ENRICHLAYER_API_KEY` | Yes | EnrichLayer API key |
| `APIFY_API_KEY` | Yes* | Apify key (*required for `find_leads`) |

## License

MIT - [PageLines](https://github.com/pagelines)