Coresignal

Coresignal MCP v2

Официальный сервер Model Context Protocol для Coresignal — подключайте свежие B2B-данные о 895M+ сотрудниках, 70M+ компаниях и 468M+ вакансиях прямо в ваш ИИ-ассистент.

https://mcp.coresignal.com/mcp/v2

Ищите на простом естественном языке, получайте полные записи, обогащайте контакты подтверждёнными email-адресами и выгружайте большие наборы результатов как загружаемые файлы — всё это из Claude, Cursor, Codex, VS Code или любого другого MCP-совместимого клиента.

Возможности

• Аутентификация OAuth 2.1 — вход с аккаунтом панели Coresignal; никаких API-ключей в конфигурационных файлах.
• Поиск на естественном языке с указанием признаков совпадения в каждой строке результата, чтобы вы видели, почему каждая запись подошла.
• Прозрачность стоимости — каждый ответ сообщает credits_consumed, а дорогие вызовы запрашивают подтверждение перед списанием средств.
• Поиск полей — entity_fields находит нужные имена полей по ключевым словам бесплатно, без загрузки полного словаря из 300+ полей в контекст.
• Загрузка файлов — большие наборы результатов хранятся на сервере и возвращаются в виде ссылки для скачивания, а не заваливают чат.
• artifact_read страницы возвращают доставленные файлы обратно в разговор бесплатно — работает даже в клиентах без доступа к файловой системе.

Предварительные требования

• Аккаунт Coresignal с активной подпиской (кредитами) и командным API-ключом, созданным в панели. MCP-сервер автоматически определяет ключ вашей команды после входа — вам никогда не нужно вставлять его в конфигурационный файл. Ещё нет подписки? Начните с 7-дневного бесплатного пробного периода — он включает 2000 кредитов. См. сравнение тарифов.

При первом подключении ваш клиент открывает окно браузера для входа в панель Coresignal. Это вся настройка — никаких переменных окружения, никаких секретов.

Настройка клиентов

claude mcp add --transport http coresignal https://mcp.coresignal.com/mcp/v2

codex mcp add coresignal --url https://mcp.coresignal.com/mcp/v2

{
  "mcpServers": {
    "coresignal": {
      "url": "https://mcp.coresignal.com/mcp/v2"
    }
  }
}

opencode mcp add coresignal --url https://mcp.coresignal.com/mcp/v2

opencode mcp auth coresignal

{
  "servers": {
    "coresignal": {
      "type": "http",
      "url": "https://mcp.coresignal.com/mcp/v2"
    }
  }
}

{
  "mcpServers": {
    "coresignal": {
      "type": "streamableHttp",
      "url": "https://mcp.coresignal.com/mcp/v2",
      "disabled": false
    }
  }
}

cline mcp

Загрузка файлов и список разрешённых доменов

Большие результаты (а также любые вызовы с delivery="url") не сбрасываются в чат, чтобы экономить входные токены LLM. Вместо этого сервер сохраняет строки в файл и возвращает подписанную HTTPS-ссылку для скачивания, которая истекает через 1 час:

{
  "delivery": "url",
  "url": "https://mcp.coresignal.com/mcp/v2/artifacts/…?exp=…&sig=…",
  "artifact_name": "employee_fetch-baf941dd4f8c4dfe.jsonl",
  "count": 500,
  "credits_consumed": 10000
}

Дальше агент получает данные одним из трёх способов:

1. Агент сам скачивает файл — в клиентах с доступом к оболочке агент обычно curl ссылку на диск и анализирует файл локально с помощью grep/jq/pandas.
2. Агент читает его обратно в чате — в клиентах без оболочки и без файловой системы агент вызывает artifact_read(artifact_name, offset, limit) и листает файл по частям через MCP-сессию. Это бесплатно и работает везде, так что чат ничем не заваливается.
3. Вы скачиваете вручную — если агенту не разрешено получать ссылку (домен не в списке разрешённых, песочница без доступа к сети), нажмите на ссылку, сохраните файл и сообщите агенту, где он лежит: «Я скачал файл в ~/Downloads/employee_fetch-….jsonl — проанализируй его оттуда». Работает в любом клиенте, который умеет читать локальные файлы.

Предпочитайте загрузку, если ваш клиент её поддерживает. artifact_read бесплатен в кредитах Coresignal, но не в токенах LLM: каждая возвращённая страница становится частью разговора и повторно тарифицируется как входные токены при каждом следующем ходе. Кроме того, каждая страница обрезается до фиксированного токенного бюджета — полная запись сотрудника составляет ~8k токенов, поэтому одна страница вмещает лишь несколько полных записей, независимо от запрошенного limit. Чтение большого файла таким способом требует сотен вызовов и может исчерпать контекстное окно раньше, чем вы дойдёте до конца. Скачанный файл стоит практически ноль токенов — ассистент может локально отфильтровать тысячи строк с помощью grep/jq и показать только ответ. Поэтому стоит настроить загрузку заранее (список разрешённых доменов, доступ к сети в песочнице) и оставить artifact_read для клиентов, которые не умеют скачивать, или для быстрого просмотра нескольких строк.

Если загрузка заблокирована, ничего не потеряно: записи уже сохранены и оплачены — читайте их через artifact_read. Никогда не запускайте выборку повторно, чтобы «восстановить» файл; это повторно спишет каждую запись.

Инструменты

entity_search

Ищет по employee, company или job записи с помощью запроса на простом языке:

«Senior Python developers at fintech companies in French»

Каждый вызов стоит фиксированные 20 кредитов и возвращает:

• total_count — точное количество записей, совпавших с запросом,
• до 20 строк предпросмотра (limit=0 возвращает только количество), каждая с полями, по которым произошло совпадение, — доказательством того, почему результат здесь,
• cache_id — одночасовой хэндл поиска, который экономит кредиты и время: передайте его в entity_fetch, и совпавшие записи будут собраны сразу — без необходимости повторного запуска (и повторной оплаты) поиска, а само разрешение cache_id бесплатно. Идентификаторы записей остаются на сервере, так что через разговор никогда не проходят громоздкие данные.

entity_fields

Бесплатный мгновенный поиск имён полей по смыслу — "salary" находит поля компенсаций, "current job title and seniority" находит active_experience_title, experience.position_title и т. д. Используйте его, чтобы собрать список fields для выборки с собственным набором полей, не загружая полный словарь полей в контекст.

entity_fetch

Собирает записи — либо до 20 выбранных вручную id из результатов поиска, либо до 1000 записей за вызов через cache_id. Оплата за каждую найденную запись: 20 кредитов за сотрудников/компании, 1 за вакансии.

email_enrich

Подтверждённые, доставляемые рабочие email-адреса для до 1000 id сотрудников — 10 кредитов за каждый найденный email; ненайденные id бесплатны. Контакты из ЕЭЗ/Великобритании недоступны (GDPR).

artifact_read

Читает доставленный файл обратно через аутентифицированную MCP-сессию, по странице за раз — бесплатно, поскольку записи были оплачены при их получении. Именно это делает доставку файлов возможной везде, включая чат-клиенты, которые не могут открыть ссылку или работать с файловой системой.

Примеры запросов

Обзор рынка

"Find B2B SaaS companies in the Nordics with 50–200 employees that raised funding in the last two years."

Создание списка лидов с подтверждёнными email

"Search for heads of data at US companies with 500+ employees. Fetch 20 full profiles to a file with verified emails."

Глубокое изучение отдельной компании**

"Pull the full record for flo.health — funding rounds, headcount growth, and current job openings."

...

Кредиты и оплата

Каждый ответ включает credits_consumed — фактически списанную сумму, поэтому расхождение (отправлено 1000 id, списано за 950 записей) точно показывает, сколько id не было найдено. Сервер никогда не тратит средства молча: выборки сначала подтверждают с вами набор полей, а выборка, которую невозможно доставить, завершается ошибкой до списания каких-либо кредитов.

Кредиты расходуются из подписки Coresignal вашей команды — управляйте ключами и оплатой в панели. Впервые с Coresignal? 7-дневный бесплатный пробный период включает 2000 кредитов — это 100 поисков, или 100 записей сотрудников/компаний, или их комбинация — см. сравнение тарифов.

Ссылки

• Coresignal — покрытие данных, тарифы и цены
• Панель Coresignal — аккаунт, команда, API-ключи, кредиты
• Документация API — базовые API данных