Return SmartProspect credit balance (available/total/used), daily and single-fetch limits, and leads-found / emails-fetched metrics. Safety — read-only: yes; may consume SmartProspect credits: no; creates or modifies remote state: no; can send email: no; destructive: no. Endpoint: GET https://prospect-api.smartlead.ai/api/v1/search-email-leads/search-analytics. Read this before any credit-consuming call. Free and read-only. Pass filter_id to also get per-filter leads-found and emails-fetched figures.

Return SmartProspect reply counts for the current and previous month, with the trend. Safety — read-only: yes; may consume SmartProspect credits: no; creates or modifies remote state: no; can send email: no; destructive: no. Endpoint: GET https://prospect-api.smartlead.ai/api/v1/search-email-leads/reply-analytics. Free and read-only.

List country values available as SmartProspect search filters. Safety — read-only: yes; may consume SmartProspect credits: no; creates or modifies remote state: no; can send email: no; destructive: no. Endpoint: GET https://prospect-api.smartlead.ai/api/v1/search-email-leads/countries. Reference data only. Does not reveal contacts and does not consume credits.

List state/region values available as SmartProspect search filters. Safety — read-only: yes; may consume SmartProspect credits: no; creates or modifies remote state: no; can send email: no; destructive: no. Endpoint: GET https://prospect-api.smartlead.ai/api/v1/search-email-leads/states. Reference data only. Does not reveal contacts and does not consume credits.

List city values available as SmartProspect search filters. Safety — read-only: yes; may consume SmartProspect credits: no; creates or modifies remote state: no; can send email: no; destructive: no. Endpoint: GET https://prospect-api.smartlead.ai/api/v1/search-email-leads/cities. Reference data only. Does not reveal contacts and does not consume credits. Smartlead documents that filtering by country also requires state.

List department values available as SmartProspect search filters. Safety — read-only: yes; may consume SmartProspect credits: no; creates or modifies remote state: no; can send email: no; destructive: no. Endpoint: GET https://prospect-api.smartlead.ai/api/v1/search-email-leads/departments. Reference data only. Does not reveal contacts and does not consume credits.

List seniority level values available as SmartProspect search filters. Safety — read-only: yes; may consume SmartProspect credits: no; creates or modifies remote state: no; can send email: no; destructive: no. Endpoint: GET https://prospect-api.smartlead.ai/api/v1/search-email-leads/levels. Reference data only. Does not reveal contacts and does not consume credits.

List industry values available as SmartProspect search filters. Safety — read-only: yes; may consume SmartProspect credits: no; creates or modifies remote state: no; can send email: no; destructive: no. Endpoint: GET https://prospect-api.smartlead.ai/api/v1/search-email-leads/industries. Reference data only. Does not reveal contacts and does not consume credits.

List sub-industry values available as SmartProspect search filters. Safety — read-only: yes; may consume SmartProspect credits: no; creates or modifies remote state: no; can send email: no; destructive: no. Endpoint: GET https://prospect-api.smartlead.ai/api/v1/search-email-leads/sub-industries. Reference data only. Does not reveal contacts and does not consume credits.

List company revenue range values available as SmartProspect search filters. Safety — read-only: yes; may consume SmartProspect credits: no; creates or modifies remote state: no; can send email: no; destructive: no. Endpoint: GET https://prospect-api.smartlead.ai/api/v1/search-email-leads/revenue. Reference data only. Does not reveal contacts and does not consume credits. This endpoint takes no pagination parameters.

List company head count (size) ranges available as SmartProspect search filters. Safety — read-only: yes; may consume SmartProspect credits: no; creates or modifies remote state: no; can send email: no; destructive: no. Endpoint: GET https://prospect-api.smartlead.ai/api/v1/search-email-leads/head-counts. Reference data only. Does not reveal contacts and does not consume credits.

List company names available as SmartProspect search filters. Safety — read-only: yes; may consume SmartProspect credits: no; creates or modifies remote state: no; can send email: no; destructive: no. Endpoint: GET https://prospect-api.smartlead.ai/api/v1/search-email-leads/company. Reference data only. Does not reveal contacts and does not consume credits.

List company domains available as SmartProspect search filters. Safety — read-only: yes; may consume SmartProspect credits: no; creates or modifies remote state: no; can send email: no; destructive: no. Endpoint: GET https://prospect-api.smartlead.ai/api/v1/search-email-leads/domain. Reference data only. Does not reveal contacts and does not consume credits.

List job title values available as SmartProspect search filters. Safety — read-only: yes; may consume SmartProspect credits: no; creates or modifies remote state: no; can send email: no; destructive: no. Endpoint: GET https://prospect-api.smartlead.ai/api/v1/search-email-leads/job-title. Reference data only. Does not reveal contacts and does not consume credits.

List company keyword values available as SmartProspect search filters. Safety — read-only: yes; may consume SmartProspect credits: no; creates or modifies remote state: no; can send email: no; destructive: no. Endpoint: GET https://prospect-api.smartlead.ai/api/v1/search-email-leads/keywords. Reference data only. Does not reveal contacts and does not consume credits.

Search the SmartProspect contact database with filters and return a preview page plus filter_id, total_count and scroll_id. Safety — read-only: yes; may consume SmartProspect credits: no; creates or modifies remote state: no; can send email: no; destructive: no. Endpoint: POST https://prospect-api.smartlead.ai/api/v1/search-email-leads/search-contacts. Read-only. Running a search does not fetch or reveal credit-gated contacts and does not spend credits by itself. limit is required and must be 1-500; every array filter accepts at most 2000 items. Pass the returned scroll_id back in to page through results; keep the filter_id to fetch or retrieve contacts later.

Retrieve contacts that were already saved or fetched, by adapt IDs or by filter_id, with optional verification and catch-all filtering. Safety — read-only: yes; may consume SmartProspect credits: no; creates or modifies remote state: no; can send email: no; destructive: no. Endpoint: POST https://prospect-api.smartlead.ai/api/v1/search-email-leads/get-contacts. Read-only. Returns contacts whose emails were already paid for; it does not spend credits. Provide exactly one of id (max 200 adapt IDs) or filter_id — never both. limit, offset, search, verification_status and catch_all_status apply when using filter_id.

Re-sync contact metrics and statuses for a SmartProspect filter, returning updated counts for emails, bounces and verification. Safety — read-only: no; may consume SmartProspect credits: no; creates or modifies remote state: yes; can send email: no; destructive: no. Endpoint: PATCH https://prospect-api.smartlead.ai/api/v1/search-email-leads/review-contacts/{filter_id}. Modifies remote state (records are updated) but does not consume credits. Blocked in readonly mode.

List saved SmartProspect search filters with their stored filter details. Safety — read-only: yes; may consume SmartProspect credits: no; creates or modifies remote state: no; can send email: no; destructive: no. Endpoint: GET https://prospect-api.smartlead.ai/api/v1/search-email-leads/search-filters/saved-searches. Free and read-only. Use the returned id as a filter_id elsewhere.

List recently executed SmartProspect searches with their filter details. Safety — read-only: yes; may consume SmartProspect credits: no; creates or modifies remote state: no; can send email: no; destructive: no. Endpoint: GET https://prospect-api.smartlead.ai/api/v1/search-email-leads/search-filters/recent-searches. Free and read-only.

List searches whose contacts have already been fetched, including per-filter fetch metrics (total contacts, emails, bounces). Safety — read-only: yes; may consume SmartProspect credits: no; creates or modifies remote state: no; can send email: no; destructive: no. Endpoint: GET https://prospect-api.smartlead.ai/api/v1/search-email-leads/search-filters/fetched-searches. Free and read-only. Contacts listed here were already paid for; retrieve them with smartprospect_get_contacts rather than fetching again.

Save a named SmartProspect search filter for later reuse. Safety — read-only: no; may consume SmartProspect credits: no; creates or modifies remote state: yes; can send email: no; destructive: no. Endpoint: POST https://prospect-api.smartlead.ai/api/v1/search-email-leads/search-filters/save-search. Creates remote state. Does not run the search and does not consume credits. Blocked in readonly mode.

Rename an existing saved SmartProspect search filter. Safety — read-only: no; may consume SmartProspect credits: no; creates or modifies remote state: yes; can send email: no; destructive: no. Endpoint: PUT https://prospect-api.smartlead.ai/api/v1/search-email-leads/search-filters/save-search/{id}. Modifies remote state. Blocked in readonly mode. Does not consume credits.

Rename an existing fetched SmartProspect search (fetched lead set). Safety — read-only: no; may consume SmartProspect credits: no; creates or modifies remote state: yes; can send email: no; destructive: no. Endpoint: PUT https://prospect-api.smartlead.ai/api/v1/search-email-leads/search-filters/fetched-searches/{id}. Modifies remote state. Blocked in readonly mode. Does not consume credits.

Look up email addresses for up to 10 named contacts at their company domains. CONSUMES SMARTPROSPECT CREDITS. Safety — read-only: no; may consume SmartProspect credits: yes; creates or modifies remote state: yes; can send email: no; destructive: no. Endpoint: POST https://prospect-api.smartlead.ai/api/v1/search-email-leads/search-contacts/find-emails. Maximum 10 contacts per call; each contact requires firstName, lastName and companyDomain. Requires SMARTLEAD_MCP_ALLOW_CREDIT_SPEND=true and confirm_credit_spend: true. Without both, the call is refused locally without contacting Smartlead. Never retried automatically — a retry could be charged twice. Check smartprospect_get_search_analytics first to see the credit balance.

Reveal contact email addresses for a saved filter, either by explicit adapt IDs or by a bounded limit. CONSUMES SMARTPROSPECT CREDITS. Safety — read-only: no; may consume SmartProspect credits: yes; creates or modifies remote state: yes; can send email: no; destructive: no. Endpoint: POST https://prospect-api.smartlead.ai/api/v1/search-email-leads/fetch-contacts. Provide exactly one of id (explicit adapt IDs) or limit. Documented limit range is 1-10000 (up to 30000 on some accounts). Requires SMARTLEAD_MCP_ALLOW_CREDIT_SPEND=true and confirm_credit_spend: true. Runs a free, read-only credit preflight first and rejects — never silently reduces — a request that exceeds available credits or the account single-fetch limit. Never retried automatically.

List all Smartlead campaigns with status, schedule and sending configuration. Safety — read-only: yes; may consume SmartProspect credits: no; creates or modifies remote state: no; can send email: no; destructive: no. Endpoint: GET https://server.smartlead.ai/api/v1/campaigns/. Free and read-only.

Retrieve full configuration for one campaign by ID. Safety — read-only: yes; may consume SmartProspect credits: no; creates or modifies remote state: no; can send email: no; destructive: no. Endpoint: GET https://server.smartlead.ai/api/v1/campaigns/{campaign_id}. Free and read-only.

Retrieve performance analytics for one campaign (sent, opened, replied, bounced). Safety — read-only: yes; may consume SmartProspect credits: no; creates or modifies remote state: no; can send email: no; destructive: no. Endpoint: GET https://server.smartlead.ai/api/v1/campaigns/{campaign_id}/analytics. Free and read-only.

Create a new Smartlead campaign. Smartlead creates it in DRAFTED status. Safety — read-only: no; may consume SmartProspect credits: no; creates or modifies remote state: yes; can send email: no; destructive: no. Endpoint: POST https://server.smartlead.ai/api/v1/campaigns/create. Creates remote state. Blocked in readonly mode. The new campaign is a draft: it does not send anything until it is explicitly started. Never auto-retried — a retry could create a duplicate campaign.

Start, pause or stop a campaign. Safety — read-only: no; may consume SmartProspect credits: no; creates or modifies remote state: yes; can send email: yes; destructive: yes. Endpoint: POST https://server.smartlead.ai/api/v1/campaigns/{campaign_id}/status. PAUSED is an ordinary mutation and works in standard mode. START activates the campaign and will cause email to be sent: it requires unrestricted mode, SMARTLEAD_MCP_ALLOW_SEND=true and confirm_send: true. STOPPED permanently stops the campaign and cannot be undone: it requires unrestricted mode, SMARTLEAD_MCP_ALLOW_DESTRUCTIVE=true and confirm_destructive: true. Smartlead documents the activation value as "START", not "ACTIVE".

List leads in a campaign with pagination and status/engagement filters. Safety — read-only: yes; may consume SmartProspect credits: no; creates or modifies remote state: no; can send email: no; destructive: no. Endpoint: GET https://server.smartlead.ai/api/v1/campaigns/{campaign_id}/leads. Free and read-only. Returns personal data (lead email addresses and names).

Look up a single lead by email address and return its associated campaign data. Safety — read-only: yes; may consume SmartProspect credits: no; creates or modifies remote state: no; can send email: no; destructive: no. Endpoint: GET https://server.smartlead.ai/api/v1/leads/. Free and read-only. Returns personal data for the matched lead.

List saved lead lists with optional name and tag filtering. Safety — read-only: yes; may consume SmartProspect credits: no; creates or modifies remote state: no; can send email: no; destructive: no. Endpoint: GET https://server.smartlead.ai/api/v1/lead-list/. Free and read-only.

Import leads into an explicitly named campaign. Safety — read-only: no; may consume SmartProspect credits: no; creates or modifies remote state: yes; can send email: no; destructive: yes. Endpoint: POST https://server.smartlead.ai/api/v1/campaigns/{campaign_id}/leads. Creates remote state. Blocked in readonly mode. Requires an explicit campaign_id and confirm_import: true. Maximum 400 leads per call. Duplicate emails are removed locally (case-insensitive, trimmed) before the request and the number removed is reported. Never activates the campaign — use smartlead_update_campaign_status separately. Bypassing the global block list, unsubscribe list, duplicate protection or community bounce list is classified as destructive and requires unrestricted mode plus destructive confirmation. Never auto-retried: a retry could import leads twice.

List connected sending accounts with warmup, SMTP and provider filters. Safety — read-only: yes; may consume SmartProspect credits: no; creates or modifies remote state: no; can send email: no; destructive: no. Endpoint: GET https://server.smartlead.ai/api/v1/email-accounts/. Free and read-only. Returns mailbox addresses, which are personal data.

List blocked domains and email addresses with their source and client association. Safety — read-only: yes; may consume SmartProspect credits: no; creates or modifies remote state: no; can send email: no; destructive: no. Endpoint: GET https://server.smartlead.ai/api/v1/leads/get-domain-block-list. Free and read-only.

Add domains or email addresses to the global block list so no campaign emails them. Safety — read-only: no; may consume SmartProspect credits: no; creates or modifies remote state: yes; can send email: no; destructive: no. Endpoint: POST https://server.smartlead.ai/api/v1/leads/add-domain-block-list. Creates remote state. Blocked in readonly mode. Does not send email. This is a suppression action: it reduces, never increases, outbound sending.

Delete one entry from the global block list, re-enabling outreach to that domain or address. Safety — read-only: no; may consume SmartProspect credits: no; creates or modifies remote state: yes; can send email: no; destructive: yes. Endpoint: DELETE https://server.smartlead.ai/api/v1/leads/delete-domain-block-list. Classified as DESTRUCTIVE: it deletes a suppression record and re-enables sending to a previously blocked recipient. Requires unrestricted mode, SMARTLEAD_MCP_ALLOW_DESTRUCTIVE=true and confirm_destructive: true. Call smartlead_get_domain_block_list first to confirm which entry the ID refers to.