MCPサーバー

PersuadioAI

com.persuadioai/mcp

このMCPでできること

Manages leads and outreach campaigns, supports audience selection and message drafting, analyzes responses, and launches SMS campaigns only after explicit approval.

add_leads_to_campaign
Add leads to campaign
Move leads this account owns into a campaign this account owns, by explicit id. Updates membership only — sends nothing. Opted-out and suppressed leads are REJECTED with per-lead skip reasons even when listed explicitly; leads already in the target are deduplicated; the response includes the campaign's final lead count read back from the database. To pick the audience by filter instead of by id, use select_and_attach_leads (same attach semantics, driven by search_leads filters). If the target campaign was already reviewed, its earlier approval is stale (the launch step recounts recipients and refuses a token approved for a smaller audience), so a fresh review_campaign_readiness is required before launching.
入力スキーマ
{'type': 'object', 'required': ['campaign_id', 'lead_ids'], 'properties': {'lead_ids': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Lead ids to move (from find_lead, list_leads or search_leads).'}, 'campaign_id': {'type': 'string', 'description': 'The destination campaign.'}, 'idempotency_key': {'type': 'string', 'maxLength': 200, 'description': 'Optional but recommended. Retrying the same key returns the same result instead of re-running the move; reusing it with different arguments is rejected as idempotency_conflict.'}}, 'additionalProperties': False}
analyze_lead_source
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.
読み取り専用 冪等
入力スキーマ
{'type': 'object', 'properties': {'campaign_id': {'type': 'string', 'description': 'Limit to one campaign. Omit to cover every campaign this account owns.'}}, 'additionalProperties': False}
attach_leads_to_campaign
Attach leads to campaign
Attach leads this account owns to a campaign this account owns, by explicit id. Synonym for add_leads_to_campaign — same tool, same behavior, same response shape, just the verb some callers expect. Updates membership only — sends nothing. Opted-out and suppressed leads are REJECTED with per-lead skip reasons even when listed explicitly; leads already in the target are deduplicated; the response includes the campaign's final lead count read back from the database. To pick the audience by filter instead of by id, use select_and_attach_leads (same attach semantics, driven by search_leads filters). If the target campaign was already reviewed, its earlier approval is stale (the launch step recounts recipients and refuses a token approved for a smaller audience), so a fresh review_campaign_readiness is required before launching.
入力スキーマ
{'type': 'object', 'required': ['campaign_id', 'lead_ids'], 'properties': {'lead_ids': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Lead ids to move (from find_lead, list_leads or search_leads).'}, 'campaign_id': {'type': 'string', 'description': 'The destination campaign.'}, 'idempotency_key': {'type': 'string', 'maxLength': 200, 'description': 'Optional but recommended. Retrying the same key returns the same result instead of re-running the move; reusing it with different arguments is rejected as idempotency_conflict.'}}, 'additionalProperties': False}
check_campaign_readiness
Check campaign readiness
Read-only, idempotent campaign readiness status for monitoring and scheduled checks: recipient count, message, channels, cost and every pass/warn/fail check. SENDS NOTHING and NEVER mints an approval token or confirmation phrase, so it cannot launch a campaign. Use review_campaign_readiness only when a human is actively deciding whether to launch.
読み取り専用 冪等
入力スキーマ
{'type': 'object', 'required': ['campaign_id'], 'properties': {'lead_ids': {'type': 'array', 'items': {'type': 'string'}, 'description': "Check a subset of the campaign's leads. Omit for all of them."}, 'campaign_id': {'type': 'string', 'description': 'The campaign to check.'}}, 'additionalProperties': False}
clone_campaign_draft
Clone a campaign as a new draft
Copy a previous campaign's configuration (channel, message template, AI instructions, follow-up sequence, sender/automation settings) onto a brand-new campaign, and attach an audience to it. THE RESULT IS ALWAYS A DRAFT — this tool NEVER launches, NEVER sends, and never touches an approval token; it does not call launch_approved_campaign under any circumstance. import_ids (from preview_lead_import / import_leads_from_file) is the preferred way to supply a bulk audience — give several to combine multiple imported files into one campaign; leads are deduplicated across every import_id and lead_id given. At least one of import_ids/lead_ids should normally be supplied, or the clone has no audience. Use channels=['sms'] when the new draft must be text-only with no AI/voice calls, and from_address_id to pin the verified email identity on an email clone. After this, call review_campaign_readiness; only an explicit human approval may lead to launch_approved_campaign.
入力スキーマ
{'type': 'object', 'required': ['source_campaign_id', 'name', 'idempotency_key'], 'properties': {'name': {'type': 'string', 'maxLength': 120, 'description': 'Name for the new draft campaign.'}, 'channels': {'type': 'array', 'items': {'enum': ['email', 'sms', 'voice'], 'type': 'string'}, 'minItems': 1, 'description': "Optional explicit channel narrowing on the new draft. Example: ['sms'] makes an SMS campaign text-only and prevents AI/voice calling. This can only narrow the campaign type, never widen it.", 'uniqueItems': True}, 'lead_ids': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Existing lead ids to include (from find_lead/list_leads). May be combined with import_ids; deduplicated together.'}, 'import_ids': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Preferred for bulk audiences: import_id values from preview_lead_import/import_leads_from_file. Combine several to merge multiple imported files.'}, 'description': {'type': 'string', 'maxLength': 2000, 'description': "Optional new description. Omit to keep the source campaign's description."}, 'from_address_id': {'type': 'string', 'description': 'Optional verified sender to pin on an email/both clone. Must belong to this account and remain on a live sending domain. Readiness re-checks final eligibility before launch.'}, 'idempotency_key': {'type': 'string', 'maxLength': 200, 'description': 'Required. Repeat a retried call safely — the same key returns the same cloned campaign instead of creating a duplicate.'}, 'channel_override': {'enum': ['email', 'sms', 'both'], 'type': 'string', 'description': "Override the cloned campaign's channel. Omit to keep the source campaign's channel."}, 'source_campaign_id': {'type': 'string', 'description': 'The campaign to copy settings from. Must be owned by this account.'}}, 'additionalProperties': False}
create_campaign_draft
Create a 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.
入力スキーマ
{'type': 'object', 'required': ['name', 'message'], 'properties': {'name': {'type': 'string', 'maxLength': 120, 'description': 'A name the operator will recognise in their dashboard.'}, 'message': {'type': 'string', 'maxLength': 320, '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.'}, 'lead_ids': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Existing leads to move into this campaign. Ids outside this account are ignored.'}, 'description': {'type': 'string', 'maxLength': 2000, 'description': 'Context for the operator: who this targets and why.'}, 'idempotency_key': {'type': 'string', 'maxLength': 120, 'description': 'Repeat a retried call safely — the same key returns the same campaign.'}, 'outreach_vertical': {'enum': ['home_purchase', 'b2b'], 'type': 'string', 'maxLength': 40, 'description': "Who the recipients ARE. 'home_purchase' — homeowners who might sell. 'b2b' — businesses and operators in the industry, never contacted about a house they live in. This chooses the copy rules AND which registered number the campaign may text from, so set it here rather than later: a b2b campaign left unset is treated as homeowner outreach. Omit it only when the campaign genuinely is homeowner outreach or you do not know."}}, 'additionalProperties': False}
create_lead
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.
入力スキーマ
{'type': 'object', 'required': ['campaign_id'], 'properties': {'name': {'type': 'string', 'description': 'Full name, if first/last are not given separately.'}, 'email': {'type': 'string'}, 'notes': {'type': 'string'}, 'phone': {'type': 'string', 'description': 'Any common format; at least one of phone/email is required.'}, 'last_name': {'type': 'string'}, 'first_name': {'type': 'string'}, 'campaign_id': {'type': 'string', 'description': 'The campaign this lead belongs to (required — every lead lives in a campaign).'}, 'company_name': {'type': 'string'}}, 'additionalProperties': False}
find_lead
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.
読み取り専用 冪等
入力スキーマ
{'type': 'object', 'required': ['query'], '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.'}}, 'additionalProperties': False}
get_campaign_status
Get campaign status
Report recorded campaign outcomes: leads, sent records, confirmed delivery receipts, replies, opt-outs, booking records, and AI-paused leads (not people awaiting a human). Omit campaign_id to list campaigns. Account totals are independent of pagination and status filters. Read-only. Null metrics are unavailable; read the caveats before telling the operator a campaign is or is not working.
読み取り専用 冪等
入力スキーマ
{'type': 'object', 'properties': {'limit': {'type': 'integer', 'maximum': 100, 'minimum': 1}, 'offset': {'type': 'integer', 'minimum': 0}, 'status': {'type': 'string', 'description': "Filter the list by status, e.g. 'active', 'draft', 'paused'."}, 'campaign_id': {'type': 'string', 'description': 'One campaign. Omit to list all of them.'}}, 'additionalProperties': False}
get_interested_leads
Get leads who replied with interest
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.
読み取り専用 冪等
入力スキーマ
{'type': 'object', 'properties': {'days': {'type': 'integer', 'maximum': 365, 'minimum': 1, 'description': 'How far back to look, in days (1-365). Default 30.'}, 'limit': {'type': 'integer', 'maximum': 100, 'minimum': 1}, 'offset': {'type': 'integer', 'minimum': 0}, 'campaign_id': {'type': 'string', 'description': 'Limit to one campaign.'}}, 'additionalProperties': False}
import_leads_from_file
Import leads from a CSV/XLSX file
Upsert leads from an uploaded CSV or XLSX file into this account. WRITES TO THE DATABASE — SENDS NOTHING on any channel, ever; this only stores contacts. Deduplicates by phone/email (dedupe_by, default both) against both the file itself and every lead already in this account. Re-importing a lead that is opted-out, suppressed, or do-not-contact NEVER clears those flags and NEVER moves the lead — only genuinely new contacts are created. Returns an import_id: pass it to clone_campaign_draft's import_ids to attach this audience to a campaign. idempotency_key is required — retrying the same key returns the same result rather than importing twice; reusing it with different arguments is rejected as idempotency_conflict.
冪等
入力スキーマ
{'type': 'object', 'required': ['file', 'idempotency_key'], 'properties': {'file': {'type': 'object', 'required': ['filename', 'content_base64'], 'properties': {'filename': {'type': 'string', 'maxLength': 255, 'description': "Original filename, e.g. 'alameda_investors.xlsx'. Determines .csv vs .xlsx parsing."}, 'content_base64': {'type': 'string', 'description': 'The raw file bytes, base64-encoded.'}}, 'description': "The uploaded lead file, inline. filename + content_base64 (raw file bytes, base64-encoded) — this server's transport is stateless JSON-RPC with no separate attachment channel, so the file rides in the tool call itself. .csv and .xlsx only; 15MB decoded max.", 'additionalProperties': False}, 'mode': {'enum': ['upsert'], 'type': 'string', 'description': "Import mode. Only 'upsert' (create new, update existing) is currently supported."}, 'tags': {'type': 'array', 'items': {'type': 'string'}, 'maxItems': 25, 'description': 'Optional labels applied to every imported/updated lead.'}, 'source': {'type': 'string', 'maxLength': 100, 'description': "Where this list came from, e.g. 'PropStream export'. Stored as provenance and never overwritten on re-import."}, 'dedupe_by': {'type': 'array', 'items': {'enum': ['phone', 'email'], 'type': 'string'}, 'description': 'Which normalized fields count as a duplicate match. Default: ["phone", "email"] (either matching is a duplicate).'}, 'column_mapping': {'type': 'object', 'description': "Optional override of auto-detected columns: {target_field: 'exact column name in the file'}. Target fields: first_name, last_name, full_name, phone, mobile_phone, email, address, property_address, city, state, zip, company_name. Anything not given here falls back to auto-detection.", 'additionalProperties': {'type': 'string'}}, 'idempotency_key': {'type': 'string', 'maxLength': 200, 'description': 'Required. Repeat a retried call safely — the same key returns the same import result instead of importing twice.'}}, 'additionalProperties': False}
launch_approved_campaign
Launch an approved campaign
SENDS REAL MESSAGES TO REAL PEOPLE. This is irreversible and costs credits. It requires an approval_token from review_campaign_readiness and explicit operator authorization for this exact launch. In an interactive current turn where the human explicitly asked to send this campaign, pass operator_authorized_this_launch=true instead of asking them to copy/paste the server phrase. Never set that flag for a scheduled or background run, standing instructions, prior approval, enthusiasm, or inferred intent. Never infer approval. Never generate the confirmation yourself. The exact confirmation phrase remains supported for other clients. Never reuse an approval issued for a different campaign or a different size.
破壊的操作あり 外部アクセスあり
入力スキーマ
{'type': 'object', 'required': ['campaign_id', 'approval_token'], 'properties': {'channel': {'enum': ['sms', 'email'], 'type': 'string', 'description': "Must match the channel the readiness review approved. Default 'sms'; 'email' launches email-only."}, 'lead_ids': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Must match the subset that was reviewed and approved.'}, 'campaign_id': {'type': 'string', 'description': 'The campaign to launch.'}, 'from_number': {'type': 'string', 'description': 'SMS channel only: the same outbound number the readiness review was run with. Omit for automatic sender routing.'}, 'confirmation': {'type': 'string', 'description': 'The exact confirmation phrase from the readiness review. Optional only when operator_authorized_this_launch=true.'}, 'approval_token': {'type': 'string', 'description': 'The token from review_campaign_readiness. Single-use and short-lived.'}, 'from_address_id': {'type': 'string', 'description': 'Email channel only: the same from_address_id the readiness review was run with (the approval binds to it).'}, 'all_textable_numbers': {'type': 'boolean', 'description': 'SMS only. Must match the readiness review. When true, queue one separate text to every approved textable phone on each selected lead.'}, 'operator_authorized_this_launch': {'type': 'boolean', 'description': 'Set true only when the authenticated human operator explicitly asked to launch this exact campaign in the current interactive turn. Never set for scheduled/background execution, standing preferences, prior approvals, or inferred intent.'}}, 'additionalProperties': False}
list_from_addresses
List email sender identities
The verified email sender identities (from-addresses) this account can send campaigns from. Read-only; sends nothing. Use before an email-channel readiness review to pick the right sender.
読み取り専用 冪等
入力スキーマ
{'type': 'object', 'properties': {}, 'additionalProperties': False}
list_leads
List leads
Page through this account's leads, optionally filtered by campaign and status. Read-only — sends nothing and changes nothing. For richer filtering (geography, source, tags, contact history, SMS eligibility), use search_leads — the same data with the audience-building filter vocabulary.
読み取り専用 冪等
入力スキーマ
{'type': 'object', 'properties': {'limit': {'type': 'integer', 'maximum': 100, 'minimum': 1}, 'offset': {'type': 'integer', 'minimum': 0}, 'status': {'type': 'string', 'description': "Optional lead status filter, e.g. 'active'."}, 'campaign_id': {'type': 'string', 'description': 'Optional: one campaign only.'}}, 'additionalProperties': False}
pause_campaign
Pause a 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.
冪等
入力スキーマ
{'type': 'object', 'required': ['campaign_id'], 'properties': {'reason': {'type': 'string', 'maxLength': 500, 'description': "Why it is being paused, for the operator's records."}, 'campaign_id': {'type': 'string', 'description': 'The campaign to pause.'}}, 'additionalProperties': False}
preview_lead_import
Preview a lead file before importing
Inspect an uploaded CSV or XLSX lead file WITHOUT writing anything to the database — read-only, sends nothing. Auto-detects common columns (name, phone, email, address, company/entity name) and reports row counts, in-file and account duplicates, missing contact fields, and how many leads would end up SMS- and email-contactable. Run this before import_leads_from_file so the operator can see what would happen first.
読み取り専用 冪等
入力スキーマ
{'type': 'object', 'required': ['file'], 'properties': {'file': {'type': 'object', 'required': ['filename', 'content_base64'], 'properties': {'filename': {'type': 'string', 'maxLength': 255, 'description': "Original filename, e.g. 'alameda_investors.xlsx'. Determines .csv vs .xlsx parsing."}, 'content_base64': {'type': 'string', 'description': 'The raw file bytes, base64-encoded.'}}, 'description': "The uploaded lead file, inline. filename + content_base64 (raw file bytes, base64-encoded) — this server's transport is stateless JSON-RPC with no separate attachment channel, so the file rides in the tool call itself. .csv and .xlsx only; 15MB decoded max.", 'additionalProperties': False}, 'dedupe_by': {'type': 'array', 'items': {'enum': ['phone', 'email'], 'type': 'string'}, 'description': 'Which normalized fields count as a duplicate match. Default: ["phone", "email"] (either matching is a duplicate).'}, 'column_mapping': {'type': 'object', 'description': "Optional override of auto-detected columns: {target_field: 'exact column name in the file'}. Target fields: first_name, last_name, full_name, phone, mobile_phone, email, address, property_address, city, state, zip, company_name. Anything not given here falls back to auto-detection.", 'additionalProperties': {'type': 'string'}}}, 'additionalProperties': False}
recommend_followup_campaign
Recommend a follow-up 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.
読み取り専用 冪等
入力スキーマ
{'type': 'object', 'properties': {'goal': {'type': 'string', 'maxLength': 500, 'description': 'What the operator is trying to achieve, in their words.'}, 'campaign_id': {'type': 'string', 'description': 'Limit to one campaign. Omit to cover the whole account.'}}, 'additionalProperties': False}
review_campaign_readiness
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.
読み取り専用
入力スキーマ
{'type': 'object', 'required': ['campaign_id'], 'properties': {'channel': {'enum': ['sms', 'email'], 'type': 'string', 'description': "How the campaign goes out. Default 'sms' (text + voice where applicable). 'email' reviews an email-only launch."}, 'lead_ids': {'type': 'array', 'items': {'type': 'string'}, 'description': "Review a subset of the campaign's leads. Omit for all of them."}, 'campaign_id': {'type': 'string', 'description': 'The campaign to review.'}, 'from_number': {'type': 'string', 'description': 'SMS channel only: an approved outbound number for this account. Omit for automatic sender routing.'}, 'from_address_id': {'type': 'string', 'description': 'Email channel only: the sender identity to send from (see list_from_addresses). Omit to use the account default.'}, 'all_textable_numbers': {'type': 'boolean', 'description': "SMS only. When true, approve one separate text to every eligible textable phone on each selected lead. Used by DealFinder's attended Send-to-all action."}}, 'additionalProperties': False}
search_leads
Search leads with eligibility filters
Search this account's leads by campaign/list, source, geography (city/state/county), lead type, tags, contact history (never_contacted / contacted_no_reply / replied) and SMS eligibility (textable phone, not opted out, not suppressed), with paging and a deterministic sort. Returns lead_id values plus masked contact details and per-lead eligibility flags. Read-only — SENDS NOTHING and changes nothing. This is the filter-rich sibling of list_leads (plain paging) and find_lead (locate one person); use the lead_ids it returns with add_leads_to_campaign, or let select_and_attach_leads run the same filters and attach a bounded subset in one step.
読み取り専用 冪等
入力スキーマ
{'type': 'object', 'properties': {'city': {'type': 'string', 'description': 'Exact city, case-insensitive.'}, 'sort': {'enum': ['newest', 'oldest', 'score'], 'type': 'string', 'description': "Deterministic orders (ties broken by id). Default 'newest'."}, 'tags': {'type': 'array', 'items': {'type': 'string'}, 'maxItems': 25, 'description': 'Leads carrying ANY of these tags.'}, 'limit': {'type': 'integer', 'maximum': 200, 'minimum': 1, 'description': 'Page size, max 200. Default 25.'}, 'state': {'type': 'string', 'description': "Exact state, case-insensitive, e.g. 'CA'."}, 'county': {'type': 'string', 'description': 'Exact county, case-insensitive.'}, 'offset': {'type': 'integer', 'minimum': 0}, 'source': {'type': 'string', 'description': "Exact source label, case-insensitive, e.g. 'PropStream export'."}, 'status': {'type': 'string', 'description': "Lead status, e.g. 'new'."}, 'has_phone': {'type': 'boolean', 'description': 'Filter on having any phone at all.'}, 'lead_type': {'type': 'string', 'description': "Matches the lead's lead_type/investor_type field."}, 'opted_out': {'type': 'boolean', 'description': 'Lead flag OR suppression-list match (phone-format tolerant).'}, 'suppressed': {'type': 'boolean', 'description': 'do-not-contact / unsubscribed.'}, 'campaign_id': {'type': 'string', 'description': 'Only leads currently in this campaign/list (must be owned by this account).'}, 'sms_eligible': {'type': 'boolean', 'description': 'Textable phone (cell, not landline-only), not opted out, not suppressed. Send-time compliance still re-checks.'}, 'investor_type': {'type': 'string', 'description': 'Exact alias for lead_type — same field, same matching. Pass one or the other, not different values for both.'}, 'contact_status': {'enum': ['never_contacted', 'contacted_no_reply', 'replied'], 'type': 'string', 'description': 'never_contacted = no opening SMS ever claimed for the lead and no reply on record.'}}, 'additionalProperties': False}
select_and_attach_leads
Select eligible leads and attach them to a draft
Deterministically select up to requested_count SMS-eligible leads matching the same filters search_leads accepts (nested under 'filters') and attach them to a DRAFT campaign this account owns — the same membership move add_leads_to_campaign performs, driven by a filter instead of an id list. SENDS NOTHING and never launches. Opted-out and suppressed leads are never selected; leads already in the target are skipped. best_eligible orders by score (highest first) then newest, so the same request against the same data selects the same leads; the response lists the exact ids attached, the eligible total, and an honest shortfall when fewer matched than requested. Attaching to a reviewed campaign makes its earlier approval stale (the launch step recounts recipients and refuses a token approved for a smaller audience), so review_campaign_readiness must run again — and then STOP for the human operator.
冪等
入力スキーマ
{'type': 'object', 'required': ['campaign_id', 'requested_count', 'idempotency_key'], 'properties': {'filters': {'type': 'object', 'properties': {'city': {'type': 'string', 'description': 'Exact city, case-insensitive.'}, 'tags': {'type': 'array', 'items': {'type': 'string'}, 'maxItems': 25, 'description': 'Leads carrying ANY of these tags.'}, 'state': {'type': 'string', 'description': "Exact state, case-insensitive, e.g. 'CA'."}, 'county': {'type': 'string', 'description': 'Exact county, case-insensitive.'}, 'source': {'type': 'string', 'description': "Exact source label, case-insensitive, e.g. 'PropStream export'."}, 'status': {'type': 'string', 'description': "Lead status, e.g. 'new'."}, 'has_phone': {'type': 'boolean', 'description': 'Filter on having any phone at all.'}, 'lead_type': {'type': 'string', 'description': "Matches the lead's lead_type/investor_type field."}, 'opted_out': {'type': 'boolean', 'description': 'Lead flag OR suppression-list match (phone-format tolerant).'}, 'suppressed': {'type': 'boolean', 'description': 'do-not-contact / unsubscribed.'}, 'campaign_id': {'type': 'string', 'description': 'Only leads currently in this campaign/list (must be owned by this account).'}, 'sms_eligible': {'type': 'boolean', 'description': 'Textable phone (cell, not landline-only), not opted out, not suppressed. Send-time compliance still re-checks.'}, 'investor_type': {'type': 'string', 'description': 'Exact alias for lead_type — same field, same matching. Pass one or the other, not different values for both.'}, 'contact_status': {'enum': ['never_contacted', 'contacted_no_reply', 'replied'], 'type': 'string', 'description': 'never_contacted = no opening SMS ever claimed for the lead and no reply on record.'}}, 'description': 'Same vocabulary as search_leads. filters.campaign_id = the source campaign/list to select FROM.', 'additionalProperties': False}, 'campaign_id': {'type': 'string', 'description': "The DRAFT campaign to attach to. Must be owned by this account and have status 'draft'."}, 'idempotency_key': {'type': 'string', 'maxLength': 200, 'description': 'Required. Retrying the same key returns the same selection instead of attaching twice; reusing it with different arguments is rejected.'}, 'requested_count': {'type': 'integer', 'maximum': 500, 'minimum': 1, 'description': 'Exactly this many leads when enough are eligible; fewer (with an honest shortfall report) when not.'}, 'selection_strategy': {'enum': ['best_eligible'], 'type': 'string', 'description': "Only 'best_eligible' (score desc, then newest; SMS-eligible only) is currently supported."}}, 'additionalProperties': False}
update_campaign_message
Edit a draft campaign's opening message
Rewrite the opening SMS of a campaign that is still a DRAFT. THIS SENDS NOTHING — it changes stored wording only, and it never launches or enqueues anything. DRAFT ONLY: a campaign that has already launched is refused, because editing it mid-send would tell one half of an audience something different from the other; clone it into a new draft instead. The replacement is held to the same rules as create_campaign_draft — 320 characters, and rejected if it implies a prior relationship or manufactures urgency. IT INVALIDATES PRIOR APPROVALS: any approval token issued before the edit stops working, because the launch check covers the message body. Run review_campaign_readiness again afterwards and get a fresh human approval before any launch.
入力スキーマ
{'type': 'object', 'required': ['campaign_id', 'message'], 'properties': {'message': {'type': 'string', 'maxLength': 320, 'description': 'The replacement 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, so do not write one into the message.'}, 'campaign_id': {'type': 'string', 'maxLength': 64, 'description': 'The DRAFT campaign whose opening message should change. Must be owned by this account.'}, 'idempotency_key': {'type': 'string', 'maxLength': 120, 'description': 'Recommended. Repeat a retried call safely — the same key with the same message replays the first result; the same key with a different message is refused.'}}, 'additionalProperties': False}
変更
review_campaign_readiness
2026年10月1日2:54
変更
launch_approved_campaign
2026年10月1日2:54
変更
review_campaign_readiness
2026年9月29日3:02
変更
launch_approved_campaign
2026年9月29日3:02
変更
launch_approved_campaign
2026年9月27日2:53
変更
clone_campaign_draft
2026年9月27日2:53
追加
check_campaign_readiness
2026年9月27日2:53
追加
update_campaign_message
2026年9月17日12:36
追加
select_and_attach_leads
2026年9月17日12:36
追加
search_leads
2026年9月17日12:36
追加
review_campaign_readiness
2026年9月17日12:36
追加
recommend_followup_campaign
2026年9月17日12:36
追加
preview_lead_import
2026年9月17日12:36
追加
pause_campaign
2026年9月17日12:36
追加
list_leads
2026年9月17日12:36
追加
list_from_addresses
2026年9月17日12:36
追加
launch_approved_campaign
2026年9月17日12:36
追加
import_leads_from_file
2026年9月17日12:36
追加
get_interested_leads
2026年9月17日12:36
追加
get_campaign_status
2026年9月17日12:36
追加
find_lead
2026年9月17日12:36
追加
create_lead
2026年9月17日12:36
追加
create_campaign_draft
2026年9月17日12:36
追加
clone_campaign_draft
2026年9月17日12:36
追加
attach_leads_to_campaign
2026年9月17日12:36
追加
analyze_lead_source
2026年9月17日12:36
追加
add_leads_to_campaign
2026年9月17日12:36