add_leads_to_campaign

Move leads this account owns into a campaign this account owns. Updates membership only — sends nothing. If the target campaign was already reviewed, its approval token becomes unusable (launch recounts recipients), so a fresh review_campaign_readiness is required before launching.

Parameters2

campaign_id	string	required	The destination campaign.
lead_ids	array	required	Lead ids to move (from find_lead or list_leads).

Raw schema

{
  "type": "object",
  "properties": {
    "campaign_id": {
      "type": "string",
      "description": "The destination campaign."
    },
    "lead_ids": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Lead ids to move (from find_lead or list_leads)."
    }
  },
  "required": [
    "campaign_id",
    "lead_ids"
  ],
  "additionalProperties": false
}

analyze_lead_source

Summarise the leads in an account or one campaign: how many exist, how many can actually be contacted, how many opted out, and how they break down by status and source. Read-only — sends nothing and changes nothing. Start here when the operator asks what they have to work with.

Parameters1

campaign_id

string

optional

Limit to one campaign. Omit to cover every campaign this account owns.

Raw schema

{
  "type": "object",
  "properties": {
    "campaign_id": {
      "type": "string",
      "description": "Limit to one campaign. Omit to cover every campaign this account owns."
    }
  },
  "additionalProperties": false
}

create_campaign_draft

Create a campaign in draft status with its opening SMS. THIS SENDS NOTHING — a draft cannot deliver a message. It exists so a human can read the exact wording and audience before deciding. The message is rejected if it implies a prior relationship or manufactures urgency. After this, call review_campaign_readiness.

Parameters5

name	string	required	A name the operator will recognise in their dashboard.
message	string	required	The opening SMS, 320 characters or fewer. Say who is writing and why. Do not imply a prior conversation or a deadline. An opt-out line is appended automatically on first contact.
description	string	optional	Context for the operator: who this targets and why.
lead_ids	array	optional	Existing leads to move into this campaign. Ids outside this account are ignored.
idempotency_key	string	optional	Repeat a retried call safely — the same key returns the same campaign.

Raw schema

{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "description": "A name the operator will recognise in their dashboard.",
      "maxLength": 120
    },
    "message": {
      "type": "string",
      "description": "The opening SMS, 320 characters or fewer. Say who is writing and why. Do not imply a prior conversation or a deadline. An opt-out line is appended automatically on first contact.",
      "maxLength": 320
    },
    "description": {
      "type": "string",
      "description": "Context for the operator: who this targets and why.",
      "maxLength": 2000
    },
    "lead_ids": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Existing leads to move into this campaign. Ids outside this account are ignored."
    },
    "idempotency_key": {
      "type": "string",
      "description": "Repeat a retried call safely — the same key returns the same campaign.",
      "maxLength": 120
    }
  },
  "required": [
    "name",
    "message"
  ],
  "additionalProperties": false
}

create_lead

Add a single lead to a campaign this account owns. Requires campaign_id plus at least a phone or an email; deduplicates against the account's existing leads by contact detail. Writes a record only — sends nothing, to nobody, ever.

Parameters8

campaign_id	string	required	The campaign this lead belongs to (required — every lead lives in a campaign).
name	string	optional	Full name, if first/last are not given separately.
first_name	string	optional
last_name	string	optional
phone	string	optional	Any common format; at least one of phone/email is required.
email	string	optional
company_name	string	optional
notes	string	optional

Raw schema

{
  "type": "object",
  "properties": {
    "campaign_id": {
      "type": "string",
      "description": "The campaign this lead belongs to (required — every lead lives in a campaign)."
    },
    "name": {
      "type": "string",
      "description": "Full name, if first/last are not given separately."
    },
    "first_name": {
      "type": "string"
    },
    "last_name": {
      "type": "string"
    },
    "phone": {
      "type": "string",
      "description": "Any common format; at least one of phone/email is required."
    },
    "email": {
      "type": "string"
    },
    "company_name": {
      "type": "string"
    },
    "notes": {
      "type": "string"
    }
  },
  "required": [
    "campaign_id"
  ],
  "additionalProperties": false
}

find_lead

Search this account's leads by phone number, email address, or name. Phone matching tolerates formatting differences. Returns masked contact details plus lead ids. Read-only — sends nothing and changes nothing.

Parameters2

query	string	required	A phone number, an email address, or part of a name.
campaign_id	string	optional	Optional: narrow the search to one campaign.

Raw schema

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "A phone number, an email address, or part of a name."
    },
    "campaign_id": {
      "type": "string",
      "description": "Optional: narrow the search to one campaign."
    }
  },
  "required": [
    "query"
  ],
  "additionalProperties": false
}

get_campaign_status

Report what a campaign has actually done: leads, messages delivered, replies, opt-outs, meetings scheduled, and threads waiting on a human. Omit campaign_id to list every campaign in the account. Read-only. The response includes caveats about which numbers may lag — read them before telling the operator a campaign is or is not working.

Parameters4

campaign_id	string	optional	One campaign. Omit to list all of them.
status	string	optional	Filter the list by status, e.g. 'active', 'draft', 'paused'.
limit	integer	optional
offset	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "campaign_id": {
      "type": "string",
      "description": "One campaign. Omit to list all of them."
    },
    "status": {
      "type": "string",
      "description": "Filter the list by status, e.g. 'active', 'draft', 'paused'."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 100
    },
    "offset": {
      "type": "integer",
      "minimum": 0
    }
  },
  "additionalProperties": false
}

get_interested_leads

List leads whose replies were classified as positive or as asking a question, newest first, with the reply text. The classifier is keyword and sentiment based, NOT a language model — the response says so explicitly, and the reply text is included so you can judge for yourself. Read-only.

Parameters4

campaign_id	string	optional	Limit to one campaign.
days	integer	optional	How far back to look, in days (1-365). Default 30.
limit	integer	optional
offset	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "campaign_id": {
      "type": "string",
      "description": "Limit to one campaign."
    },
    "days": {
      "type": "integer",
      "description": "How far back to look, in days (1-365). Default 30.",
      "minimum": 1,
      "maximum": 365
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 100
    },
    "offset": {
      "type": "integer",
      "minimum": 0
    }
  },
  "additionalProperties": false
}

launch_approved_campaign

SENDS REAL MESSAGES TO REAL PEOPLE. This is irreversible and costs credits. It requires an approval_token from review_campaign_readiness AND the confirmation phrase that review returned, which the HUMAN OPERATOR must give you explicitly. Never generate the confirmation yourself, never infer approval from a previous message, and never reuse an approval issued for a different campaign or a different size. If the operator has not clearly said yes to this exact launch, do not call this tool — ask them.

Parameters4

campaign_id	string	required	The campaign to launch.
approval_token	string	required	The token from review_campaign_readiness. Single-use and short-lived.
confirmation	string	required	The exact confirmation phrase from the readiness review, as given to you by the human operator.
lead_ids	array	optional	Must match the subset that was reviewed and approved.

Raw schema

{
  "type": "object",
  "properties": {
    "campaign_id": {
      "type": "string",
      "description": "The campaign to launch."
    },
    "approval_token": {
      "type": "string",
      "description": "The token from review_campaign_readiness. Single-use and short-lived."
    },
    "confirmation": {
      "type": "string",
      "description": "The exact confirmation phrase from the readiness review, as given to you by the human operator."
    },
    "lead_ids": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Must match the subset that was reviewed and approved."
    }
  },
  "required": [
    "campaign_id",
    "approval_token",
    "confirmation"
  ],
  "additionalProperties": false
}

list_leads

Page through this account's leads, optionally filtered by campaign and status. Read-only — sends nothing and changes nothing.

Parameters4

campaign_id	string	optional	Optional: one campaign only.
status	string	optional	Optional lead status filter, e.g. 'active'.
limit	integer	optional
offset	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "campaign_id": {
      "type": "string",
      "description": "Optional: one campaign only."
    },
    "status": {
      "type": "string",
      "description": "Optional lead status filter, e.g. 'active'."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 100
    },
    "offset": {
      "type": "integer",
      "minimum": 0
    }
  },
  "additionalProperties": false
}

pause_campaign

Stop a campaign from sending anything further. Queued messages that have not yet gone out are skipped; anything already handed to the carrier cannot be recalled. Safe to call when unsure — pausing is reversible and errs toward not contacting people.

Parameters2

campaign_id	string	required	The campaign to pause.
reason	string	optional	Why it is being paused, for the operator's records.

Raw schema

{
  "type": "object",
  "properties": {
    "campaign_id": {
      "type": "string",
      "description": "The campaign to pause."
    },
    "reason": {
      "type": "string",
      "description": "Why it is being paused, for the operator's records.",
      "maxLength": 500
    }
  },
  "required": [
    "campaign_id"
  ],
  "additionalProperties": false
}

recommend_followup_campaign

Propose how to follow up, based on which leads have never been contacted, were contacted without replying, or already replied. Returns segments with counts and a suggested approach for each. Read-only — this is a proposal to discuss with the operator, not a plan that has been put into effect.

Parameters2

campaign_id	string	optional	Limit to one campaign. Omit to cover the whole account.
goal	string	optional	What the operator is trying to achieve, in their words.

Raw schema

{
  "type": "object",
  "properties": {
    "campaign_id": {
      "type": "string",
      "description": "Limit to one campaign. Omit to cover the whole account."
    },
    "goal": {
      "type": "string",
      "description": "What the operator is trying to achieve, in their words.",
      "maxLength": 500
    }
  },
  "additionalProperties": false
}

review_campaign_readiness

Pre-flight a campaign: how many people would be contacted, on which channels, what it would cost, and which checks pass, warn or fail. SENDS NOTHING. If everything passes, it returns a short-lived approval token and a confirmation phrase — both of which a human operator must authorise before launch_approved_campaign will do anything. Run this before every launch; the token is single-use and campaign-specific.

Parameters2

campaign_id	string	required	The campaign to review.
lead_ids	array	optional	Review a subset of the campaign's leads. Omit for all of them.

Raw schema

{
  "type": "object",
  "properties": {
    "campaign_id": {
      "type": "string",
      "description": "The campaign to review."
    },
    "lead_ids": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Review a subset of the campaign's leads. Omit for all of them."
    }
  },
  "required": [
    "campaign_id"
  ],
  "additionalProperties": false
}

PersuadioAI

com.persuadioai/mcp — Model Context Protocol (MCP) Server

🛠️ Key Features

🚀 Use Cases

⚠️ Limitations

⚡ Developer Benefits

add_leads_to_campaign

analyze_lead_source

create_campaign_draft

create_lead

find_lead

get_campaign_status

get_interested_leads

launch_approved_campaign

list_leads

pause_campaign

recommend_followup_campaign

review_campaign_readiness

Install

Remote endpoint