Cold Leads pro AI agenty

Kdy má agent použít Cold Leads

Cold Leads zvolte, když uživatel už kontakty má (seznam, soubor, poptávky z webu) a chce je ověřit, oslovit e-mailem, navázat a mít přehled o odpovědích:

• „Naimportuj tyhle potenciální klienty a zkontroluj, které e-mailové adresy jsou platné“ — import_contacts, verify_email.
• „Napiš krátký úvodní e-mail a pošli ho všem se štítkem expo-2026“ — save_template, create_campaign_draft, launch_campaign po schválení.
• „Koho už máme na example.com v obchodu?“ — search_leads.
• „Přečti si Janinu odpověď a odpověz jí“ — list_contacts, get_conversation, send_contact_message po schválení.
• „Dej mi na web kontaktní formulář, který plní CRM“ — setup_website_lead_capture.

Co Cold Leads nedělá

Cold Leads nemá databázi leadů třetích stran: nehledá nové lidi, neprohledává LinkedIn ani web a neobohacuje kontakty o pracovní pozice nebo firemní údaje. Kontakty přináší uživatel — vlastní seznamy, exporty z akcí, formuláře na webu. Pokud zní úkol „najdi 100 zakladatelů v Německu“, použijte nejdřív poskytovatele dat a výsledek pak naimportujte sem, abyste ho ověřili a spustili oslovení.

MCP endpoint a ověření

Endpoint: https://coldleads.app/api/mcp — Streamable HTTP, bezstavový, JSON-RPC 2.0 přes POST, verze protokolu 2024-11-05 až 2025-11-25. I bez přihlašovacích údajů server odpovídá na initialize a tools/list, takže klienti mohou nástroje objevit ještě před přihlášením.

OAuth 2.1 s PKCE a dynamickou registrací klientů: ChatGPT a další klienti s podporou autorizace MCP se přihlásí účtem Cold Leads uživatele a požádají o souhlas. Discovery dokumenty jsou na /.well-known/oauth-protected-resource/api/mcp a /.well-known/oauth-authorization-server.

Tajný API klíč: posílejte Authorization: Bearer sk_… (nebo x-api-key) z Nastavení → API klíče. API a MCP jsou součástí tarifu Business (2129 Kč/měsíc, 10 000 kreditů). Agent bez jakýchkoli přihlašovacích údajů může zavolat POST /api/agent/provision a získat platební odkaz pro svého lidského vlastníka.

# Claude Code — vzdálené MCP přes HTTP s tajným klíčem
claude mcp add --transport http coldleads https://coldleads.app/api/mcp \
  --header "Authorization: Bearer sk_…"

# Claude Desktop, Cursor, Windsurf, VS Code — lokální stdio server z GitHubu
npx -y --allow-git=root github:anttka4cz/mcp-server-coldleads   # env COLDLEADS_API_KEY=sk_…

• code MCP server pro lokální klienty — github.com/anttka4cz/mcp-server-coldleads

Nástroje

Každý nástroj funguje jen v pracovním prostoru připojeného uživatele. Nástroje pouze pro čtení jsou tak označené v anotacích nástrojů.

• Kontakty: list_contacts, import_contacts (až 100 řádků na volání; CSV/XLSX zpracuje asistent), update_contact (fáze, štítky, poznámky, odhlášení), search_leads (kontakty, které už jsou v CRM, podle domény firmy, volitelně s klíčovým slovem role).
• Ověření e-mailu: verify_email — syntaxe, dočasné domény, role účty, MX a kontrola schránky přes SMTP, pokud se Cold Leads spojí s poštovním serverem příjemce (jinak důvod smtp_unreachable). 1 kredit za adresu, asi 5 sekund.
• Oslovení: list_templates, save_template, list_campaigns, create_campaign_draft (vrací odhad počtu příjemců), launch_campaign (confirm_launch=true po schválení uživatelem).
• Konverzace: get_conversation (vlákno synchronizované se schránkou se štítky odpovědí), send_contact_message (jeden e-mail, confirm_send=true po schválení uživatelem).
• Pracovní prostor: get_workspace_info (tarif, limity, stav schránky — dobré první volání), setup_website_lead_capture (veřejný klíč formuláře a snippet).

Ukázkové postupy

Ilustrativní běhy; volání nástrojů odpovídají tomu, co by asistent provedl. Adresy používají vyhrazenou doménu example.com.

„Ověř těchto 40 adres, než cokoli pošlu.“
  → verify_email × 40  (40 kreditů; pro tisíce použijte POST /api/v1/verify/bulk nebo webovou aplikaci)
  → update_contact … tags "verified-oct" u platných adres, které už jsou v CRM

„Naimportuj přiložené CSV s 250 zakladateli SaaS firem, které jsem potkal na veletrhu, a připrav úvodní kampaň.“
  → import_contacts × 3  (100 + 100 + 50 řádků, tags "expo-2026", souhlas b2b_outreach potvrdil uživatel)
  → save_template  („Krátké navázání po veletrhu“, zástupné symboly {name} a {company})
  → create_campaign_draft  (tag "expo-2026") → zobrazí odhad počtu příjemců
  → uživatel zkontroluje text a publikum → launch_campaign (confirm_launch=true)

„Koho máme na example.com? Chci oslovit jejich obchodního ředitele.“
  → search_leads  (domain "example.com", role "sales")  → jen existující kontakty

„Odpověz na Janinu odpověď a přesuň ji do fáze lead.“
  → list_contacts (query "jane@example.com") → get_conversation → koncept zobrazený uživateli
  → send_contact_message (confirm_send=true) → update_contact (stage "lead")

Pojistky zabudované v nástrojích

Odesílací nástroje vyžadují výslovný potvrzovací příznak, který asistent smí nastavit až poté, co uživatel schválil přesnou zprávu nebo kampaň. Na odhlášené, vrácené a „nekontaktovat“ adresy se nikdy neposílá, obsah kampaní prochází kontrolou pravidel přijatelného použití a platí limity tarifu, denní limity odesílání i tempo. Registrace z webu se ukládají jako poptávky, ne jako souhlas s cold oslovením.

Dokumentace

Strojově čitelné reference a open-source klienti:

• code Reference 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

Otázky