# prospeo-mcp-server

Даёт агенту доступ к базе Prospeo: ищет людей и компании, достаёт рабочие почты и мобильные номера. Пригодится, когда нужно собрать список контактов прямо в чате.

- MCP-сервер · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI
- Автор: prospeo-v2
- Лицензия: MIT · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/prospeo-v2/prospeo-mcp-server
- Обновлён: 2026-10-18
- HTML: https://affpapa.org/nevibecode/mcp/prospeo-mcp-server

## Что делает

Сервер подключается к Prospeo и открывает набор инструментов: `search_suggestions` подбирает канонические значения фильтров, `search_person` и `search_company` ищут по базе, `enrich_person` и `enrich_company` достают почту, телефон и профиль компании, а `bulk_enrich_person` и `bulk_enrich_company` обрабатывают до 25 записей за раз. `get_account_info` показывает остаток кредитов и план.

Работает двумя способами. Хостинговый вариант — подключение к `https://mcp.prospeo.io`, авторизация через OAuth или ключ в заголовке `X-KEY`. Локальный запускается через `npx` и требует Node.js 18+ и переменную `PROSPEO_API_KEY`. При старте сервер загружает таблицу инструментов с бэкенда; если её не удалось получить, поднимаются восемь совместимых инструментов, а после релиза каталога процесс нужно перезапустить.

Кредиты тратятся на обогащение: одна единица за найденную почту, десять за почту вместе с мобильным. `search_suggestions` и `get_account_info` бесплатны. Перед поиском по локации или должности стоит сначала вызвать `search_suggestions` — угаданная строка вроде «SF» вместо «San Francisco, California, United States» даёт пустой результат.

## Требования
- Нужно: Node.js (команды через npx)
- Удалённый сервер: `https://mcp.prospeo.io`
- Переменные окружения: `PROSPEO_API_KEY` — это ключи и токены: значения спроси у человека, в репозиторий и общие файлы не записывай.

## Установка

### Claude Code (родная платформа)

1. **Командой платформы: удалённый сервер**
```bash
claude mcp add --transport http prospeo-mcp-server https://mcp.prospeo.io
```

2. **Командой платформы**
```bash
claude mcp add --env PROSPEO_API_KEY=<PROSPEO_API_KEY> --transport stdio prospeo-mcp-server -- npx -y @prospeo/prospeo-mcp-server
```
Вместо <…> подставьте свои значения

### Codex

1. **Командой платформы: удалённый сервер**
```bash
codex mcp add prospeo-mcp-server --url https://mcp.prospeo.io
```

2. **Командой платформы**
```bash
codex mcp add prospeo-mcp-server --env PROSPEO_API_KEY=<PROSPEO_API_KEY> -- npx -y @prospeo/prospeo-mcp-server
```
Вместо <…> подставьте свои значения

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "prospeo-mcp-server": {
            "url": "https://mcp.prospeo.io"
        }
    }
}
```
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "prospeo-mcp-server": {
            "command": "npx",
            "args": [
                "-y",
                "@prospeo/prospeo-mcp-server"
            ],
            "env": {
                "PROSPEO_API_KEY": "<PROSPEO_API_KEY>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения

### GitHub Copilot

**Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "prospeo-mcp-server": {
            "type": "http",
            "url": "https://mcp.prospeo.io"
        }
    }
}
```
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "prospeo-mcp-server": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@prospeo/prospeo-mcp-server"
            ],
            "env": {
                "PROSPEO_API_KEY": "<PROSPEO_API_KEY>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения

### Gemini CLI

1. **Командой платформы: удалённый сервер**
```bash
gemini mcp add -t http prospeo-mcp-server https://mcp.prospeo.io
```

2. **Командой платформы**
```bash
gemini mcp add -e PROSPEO_API_KEY=<PROSPEO_API_KEY> prospeo-mcp-server npx -y @prospeo/prospeo-mcp-server
```
Вместо <…> подставьте свои значения

## Когда брать
- найти рабочую почту человека по ссылке на LinkedIn
- собрать список компаний по отрасли и размеру штата
- обогатить до 25 контактов за один вызов
- подтянуть профиль компании: выручку, технологии, финансирование
- проверить остаток кредитов перед запуском обогащения

## Примеры запросов агенту
- Найди в Prospeo людей с должностью Head of Sales в Берлине и покажи их почты
- Обогати эти 20 контактов: достань рабочую почту и мобильный номер
- Собери профиль компании по домену example.com: штат, отрасль, технологии

## Похожие
- [cargo-gtm](https://affpapa.org/nevibecode/skills/cargo-gtm.md) — скилл · 10000 установок
- [FullEnrich](https://affpapa.org/nevibecode/mcp/fullenrich.md) — MCP-сервер · ★ 10
- [contact-research](https://affpapa.org/nevibecode/skills/contact-research.md) — скилл · 2900 установок
- [prospect](https://affpapa.org/nevibecode/skills/prospect.md) — скилл · 2900 установок
- [mcp](https://affpapa.org/nevibecode/mcp/apolloio-mcp.md) — MCP-сервер · ★ 33
- [Tomba MCP Server](https://affpapa.org/nevibecode/mcp/tomba-mcp-server.md) — MCP-сервер · ★ 8

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md