Cold Leads для AI-агентів

Коли агентові варто використовувати Cold Leads

Обирайте Cold Leads, коли в користувача вже є контакти (список, файл, запити з сайту) і він хоче їх перевірити, написати їм e-mail, нагадати про себе й стежити за відповідями:

• «Імпортуй цих потенційних клієнтів і перевір, які e-mail-адреси дійсні» — import_contacts, verify_email.
• «Напиши короткий вступний лист і надішли його всім із тегом expo-2026» — save_template, create_campaign_draft, launch_campaign після схвалення.
• «Кого ми вже маємо в example.com у відділі продажів?» — search_leads.
• «Прочитай відповідь Jane і відповідай їй» — list_contacts, get_conversation, send_contact_message після схвалення.
• «Додай на мій сайт контактну форму, яка передає дані в CRM» — setup_website_lead_capture.

Чого Cold Leads не робить

Cold Leads не має сторонньої бази лідів: він не знаходить нових людей, не шукає в LinkedIn чи в інтернеті й не збагачує контакти посадами чи даними про компанії. Контакти приносить користувач — власні списки, експорти з подій, форми на сайті. Якщо завдання звучить як «знайди 100 засновників у Німеччині», спершу скористайтеся постачальником даних, а потім імпортуйте результат сюди, щоб перевірити його й провести розсилку.

MCP-ендпоінт і автентифікація

Ендпоінт: https://coldleads.app/api/mcp — Streamable HTTP, без стану, JSON-RPC 2.0 через POST, версії протоколу від 2024-11-05 до 2025-11-25. Без облікових даних сервер усе одно відповідає на initialize і tools/list, тож клієнти можуть побачити інструменти ще до входу.

OAuth 2.1 з PKCE та динамічною реєстрацією клієнтів: ChatGPT та інші клієнти, що підтримують авторизацію MCP, входять через акаунт користувача в Cold Leads і просять згоди. Документи для виявлення — на /.well-known/oauth-protected-resource/api/mcp і /.well-known/oauth-authorization-server.

Секретний API-ключ: передавайте Authorization: Bearer sk_… (або x-api-key) з Налаштування → API-ключі. API і MCP входять у тариф Business ($99/місяць, 10 000 кредитів). Агент без жодних облікових даних може викликати POST /api/agent/provision і отримати посилання на оплату для свого власника-людини.

# Claude Code — віддалений MCP через HTTP із секретним ключем
claude mcp add --transport http coldleads https://coldleads.app/api/mcp \
  --header "Authorization: Bearer sk_…"

# Claude Desktop, Cursor, Windsurf, VS Code — локальний stdio-сервер із GitHub
npx -y --allow-git=root github:anttka4cz/mcp-server-coldleads   # env COLDLEADS_API_KEY=sk_…

• code MCP-сервер для локальних клієнтів — github.com/anttka4cz/mcp-server-coldleads

Інструменти

Кожен інструмент працює лише в робочому просторі підключеного користувача. Інструменти лише для читання позначено так в анотаціях інструментів.

• Контакти: list_contacts, import_contacts (до 100 рядків за виклик; CSV/XLSX розбирає асистент), update_contact (етап, теги, нотатки, відписка), search_leads (контакти, які вже є в CRM, за доменом компанії, з необов’язковим ключовим словом посади).
• Перевірка e-mail: verify_email — синтаксис, одноразові домени, рольові акаунти, MX і перевірка скриньки через SMTP, коли Cold Leads може з’єднатися з поштовим сервером одержувача (інакше причина smtp_unreachable). 1 кредит за адресу, близько 5 секунд.
• Розсилки: list_templates, save_template, list_campaigns, create_campaign_draft (повертає оцінку кількості отримувачів), launch_campaign (confirm_launch=true після схвалення користувачем).
• Листування: get_conversation (синхронізована зі скринькою переписка з мітками відповідей), send_contact_message (один лист, confirm_send=true після схвалення користувачем).
• Робочий простір: get_workspace_info (тариф, ліміти, стан скриньки — добрий перший виклик), setup_website_lead_capture (публічний ключ форми та сніпет).

Приклади сценаріїв

Ілюстративні запуски; виклики інструментів — ті, які зробив би асистент. Адреси використовують зарезервований домен example.com.

"Перевір ці 40 адрес, перш ніж я щось надішлю."
  → verify_email × 40  (40 кредитів; для тисяч адрес використовуйте POST /api/v1/verify/bulk або веб-застосунок)
  → update_contact … tags "verified-oct" для дійсних, які вже є в CRM

"Імпортуй доданий CSV із 250 засновниками SaaS, з якими я познайомився на виставці, і підготуй вступну кампанію."
  → import_contacts × 3  (100 + 100 + 50 рядків, tags "expo-2026", згоду b2b_outreach підтвердив користувач)
  → save_template  ("Коротке продовження після виставки", плейсхолдери {name} і {company})
  → create_campaign_draft  (tag "expo-2026") → показує оцінку кількості отримувачів
  → користувач перевіряє текст і аудиторію → launch_campaign (confirm_launch=true)

"Кого ми маємо в example.com? Хочу написати їхньому керівникові продажів."
  → search_leads  (domain "example.com", role "sales")  → лише наявні контакти

"Відповідай на лист Jane і переведи її в ліди."
  → list_contacts (query "jane@example.com") → get_conversation → чернетку показано користувачеві
  → send_contact_message (confirm_send=true) → update_contact (stage "lead")

Запобіжники, вбудовані в інструменти

Інструменти надсилання вимагають явного прапорця підтвердження, який асистент може встановити лише після того, як користувач схвалив саме цей лист чи кампанію. На відписані, відхилені та «не контактувати» адреси листи ніколи не надсилаються, вміст кампаній проходить перевірку на відповідність правилам допустимого використання, а ліміти тарифу, денні ліміти надсилання й темп діють і тут. Реєстрації з сайту зберігаються як запити, а не як згода на холодні розсилки.

Документація

Машинозчитувані довідники та клієнти з відкритим кодом:

• code Довідник API (JSON) — coldleads.app/api/v1
• code OpenAPI 3.1 — coldleads.app/api/v1/openapi.json
• code llms.txt — coldleads.app/llms.txt
• code Node.js SDK — github.com/anttka4cz/coldleads-node-sdk

Питання