No key yet? Connect any MCP client to https://coldleads.app/api/mcp/demo (for Claude Code: `claude mcp add --transport http coldleads-demo https://coldleads.app/api/mcp/demo`). It has the same tools over a sample workspace, never sends e-mail and uses no credits. Limits: a session lasts 24 hours from its start; up to 10 contacts (including 4 samples), 1 template of your own and 1 campaign draft; notes are cut to 100 characters, template bodies to 500 and messages to 200. The reference agent on GitHub runs the whole loop against it.
Connect an MCP client to https://coldleads.app/api/mcp using ChatGPT OAuth or a secret API key from Settings → API keys (Business plan). The Node SDK uses the same hosted tools via `new ColdLeads({ apiKey }).crm`.
Use list_contacts and import_contacts to work with records in your workspace. For CSV/XLSX, let the assistant parse the uploaded file and pass structured rows (up to 100 per call). Imports deduplicate, skip global do-not-contact addresses, and never send mail. Use `consent: inquiry` for website leads; use `b2b_outreach` only when you have a lawful basis.
Use update_contact to edit fields or record an opt-out; opt-out cannot be reversed through MCP. Use get_conversation to read messages already synced from your connected mailbox. send_contact_message sends one message only when the user approved the recipient and final content and the tool receives `confirm_send: true`.
Use list_templates and save_template to prepare content; list_campaigns and create_campaign_draft create drafts with recipient estimates. Review the template and audience in Cold Leads, then have the user explicitly approve launch_campaign with `confirm_launch: true`. Acceptable-use and content checks, account limits, DNC and unsubscribe safeguards apply.
Use get_workspace_info for non-secret account and mailbox status. setup_website_lead_capture creates a public-only `lk_…` key and a form snippet for /api/hooks/lead. Keep this key in the website form only; submissions are stored as inquiry leads and are not automatically eligible for cold outreach.
SDK examples: `await coldleads.crm.importContacts({ contacts: [{ email: 'person@example.com', consent: 'inquiry' }] })`; `await coldleads.crm.setupWebsiteLeadCapture({ site: 'https://example.com' })`; `await coldleads.crm.createCampaignDraft({ name: 'Welcome', templateId, consent: 'inquiry' })`. See the SDK guide on GitHub for all methods.