# Smartlead — how to use (mcp.ai)

Connect your Smartlead account and use 19 tools for AI sales tools straight from your AI agent. Connect with your own API key. Smartlead is a sales engagement platform for managing cold email campaigns, leads, sending accounts, inbox activity, deliverability, prospecting, and sender provisioning.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_smartlead?ms=1787291220000`
Add it as a custom/remote MCP connector in your client (Claude, Cursor, VS Code…), then authenticate when prompted. Once connected, ask the agent to use the server's tools (e.g. `smartlead_create_campaign`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/smartlead`
Auth: `Authorization: Bearer sk_live_…` — create a workspace API key at https://mcp.ai/settings/api-keys
Discover endpoints: `GET https://api.mcp.ai/api/smartlead/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/smartlead/create/campaign` — Create a new campaign in DRAFTED status. This creates persistent account data but does not send email or start the campaign.
  - body: { name: string, client_id?: integer }
- `POST https://api.mcp.ai/api/smartlead/create/delivery/folder` — Create an organizational folder for Smart Delivery tests. This creates persistent data but does not run or send a test.
  - body: { folder_name: string }
- `POST https://api.mcp.ai/api/smartlead/delete/campaign` — Permanently delete a campaign and all associated sequences, mappings, and statistics. This is irreversible and requires explicit confirmation.
  - body: { campaign_id: integer, confirm_irreversible: boolean }
- `POST https://api.mcp.ai/api/smartlead/delete/delivery/folder` — Delete an empty Smart Delivery folder. The folder must contain no tests, and deletion requires explicit confirmation.
  - body: { folder_id: string, confirm_delete: boolean }
- `POST https://api.mcp.ai/api/smartlead/get/campaign` — Get configuration and performance summary for one Smartlead campaign by ID.
  - body: { campaign_id: integer, include_tags?: boolean }
- `POST https://api.mcp.ai/api/smartlead/get/campaigns` — Get configuration and performance summaries for 1-20 Smartlead campaigns. Returns one success or failure result per campaign ID.
  - body: { campaign_ids: integer[], include_tags?: boolean }
- `POST https://api.mcp.ai/api/smartlead/get/delivery/test` — Get the documented configuration for one Smart Delivery spam test by ID.
  - body: { spam_test_id: string }
- `POST https://api.mcp.ai/api/smartlead/get/prospect/usage` — Get Smart Prospect lead-search metrics, fetch counts, daily limits, and available credit balance. This read does not consume credits.
  - body: { filter_id?: string }
- `POST https://api.mcp.ai/api/smartlead/list/campaigns` — List campaigns visible to the connected Smartlead account, optionally for one client.
  - body: { client_id?: integer, include_tags?: boolean }
- `POST https://api.mcp.ai/api/smartlead/list/delivery/folders` — List folders used to organize Smart Delivery tests.
- `POST https://api.mcp.ai/api/smartlead/list/delivery/tests` — List Smart Delivery spam and inbox-placement tests. This POST endpoint is read-only and does not create or send a test.
- `POST https://api.mcp.ai/api/smartlead/list/email/accounts` — List connected sending accounts with health, warmup, usage, provider, and campaign filters. Credential-like response fields are always removed.
  - body: { limit?: integer, in_use?: boolean, provider?: string, username?: string, client_id?: integer, next_cursor?: string, warmup_status?: string, smtp_connected?: boolean, warmup_blocked?: boolean, include_campaign_ids?: boolean }
- `POST https://api.mcp.ai/api/smartlead/list/inbox/replies` — List lead replies across campaigns from Master Inbox using bounded filters and one page at a time. This reads email content but does not send or modify messages.
  - body: { limit?: integer, search?: string, sort_by?: string, next_cursor?: string, campaign_ids?: integer[], category_ids?: integer[], email_statuses?: string[], email_account_ids?: integer[], reply_time_between?: string[], include_message_history?: boolean }
- `POST https://api.mcp.ai/api/smartlead/list/prospect/industries` — List and search Smart Prospect industry filter values without searching contacts or consuming contact-fetch credits.
  - body: { limit?: integer, search?: string, next_cursor?: string, include_sub_industries?: boolean }
- `POST https://api.mcp.ai/api/smartlead/list/purchased/domains` — List domains already purchased through Smart Senders. This is read-only and does not purchase domains or provision mailboxes.
- `POST https://api.mcp.ai/api/smartlead/list/saved/prospect/searches` — List saved Smart Prospect search definitions without executing them or consuming contact-search credits.
  - body: { limit?: integer, next_cursor?: string }
- `POST https://api.mcp.ai/api/smartlead/list/sender/vendors` — List Smart Senders marketplace vendors and current domain/mailbox pricing without placing an order.
- `POST https://api.mcp.ai/api/smartlead/search/available/domains` — Check Smart Senders marketplace domain availability for a vendor. This read-only search does not purchase a domain, place an order, or provision mailboxes.
  - body: { vendor_id: integer, domain_name: string }
- `POST https://api.mcp.ai/api/smartlead/search/prospect/contacts` — Search one page of Smart Prospect contacts. The initial call and every explicit continuation may consume credits; inspect usage first, choose the smallest useful limit, and confirm each page.
  - body: { limit: integer, filters: object, next_cursor?: string, confirm_credit_consumption: boolean }

## Example prompts
- "What can I do in Smartlead?"
- "Show me a summary of my Smartlead account"

## More
- Page: https://mcp.ai/smartlead
- Agent spec (llms.txt): https://mcp.ai/smartlead/llms.txt
- Postman collection: https://mcp.ai/smartlead/postman.json