create_drop
ClaudeCreate a campaign (drop) with uploaded files, external links, or both. On EchoDrop Social every new campaign starts as a free sandbox and is not published; a person takes it live in the dashboard. Each entry in files is XOR: either an uploaded file (provide bytes_base64 and optionally mime_type) or an external link the user already controls (provide url). Uploaded entries: pass standard base64 of the raw bytes in bytes_base64. Bytes are uploaded directly to ECHOdrop's own object storage over this tool call. Limits per workspace (org limits may differ from these defaults): max 25 entries per drop, max 5 MB per uploaded file, max 50 MB total uploaded. External-link entries do NOT count toward the byte cap. Only use url for links the user already controls; files over the upload limit cannot be added through this tool. For public coverImageUrl/shareImageUrl artwork, use upload_campaign_image first, then pass its completed public URL here. Reward-file uploads are separate and remain gated. Available in Social Personal workspaces and in org workspaces with the mixedSourceDrops feature enabled; elsewhere this tool is hidden from tools/list and rejects calls with mixed_disabled. The recipient Share button is built in to every Social campaign and appears after a successful claim, not on the initial claim form or waitlist. No enable switch or editable share-button setting exists: do not invent one or ask the owner to find a dashboard-only toggle. get_drop.recipientSharing confirms this capability. It works for file, link, code, redirect and video rewards, including completed standalone question flows. After verified live claims it gives each sharer a personalized opaque link; referred counts distinct email pickup starts and referred_completed counts successful unlocks against the sharer's verified email. First touch wins; repeats, self-referrals and sandbox tests are excluded. Sandbox sharing uses the campaign link without live attribution. Counts are readable with get_drop_referrals. Agents must not claim drops to test this; recipient pickups are human-only. Success returns applied:true, appliedVia:sandbox_creation and the new campaign's agentControls. This creates a sandbox, not approval to go live.
duplicate_drop
ClaudeDuplicate one of the user's campaigns as the starting point for a new one, in the same workspace. Copies the whole setup: content, files and links, page text and colors, claim form fields, question flow, limits, per-campaign webhooks, affiliate settings and the agent guide. Never copies claims, leads, counts, activity, codes from a code pool, or an uploaded video; notCopied lists anything the owner must set up again. Expired, defunct and revoked campaigns may be duplicated while their saved setup still exists. The copy has a new link, no original pause/revocation/expiry state, and starts in a free sandbox under normal slot limits. Its own first paid launch uses a new credit and starts a new 365-day lifetime. Missing or deleted uploads are reported, never silently restored. Success returns applied:true, appliedVia:sandbox_creation and the new campaign's agentControls. This creates a sandbox, not approval to go live.
get_drop
ClaudeGet one of the user's campaigns by code: all saved settings, status, sandbox deadline, files and links, code-pool and uploaded-video state, and the owner's agent guide for the campaign. Read-only. The recipient Share button is built in to every Social campaign and appears after a successful claim, not on the initial claim form or waitlist. No enable switch or editable share-button setting exists: do not invent one or ask the owner to find a dashboard-only toggle. get_drop.recipientSharing confirms this capability. It works for file, link, code, redirect and video rewards, including completed standalone question flows. After verified live claims it gives each sharer a personalized opaque link; referred counts distinct email pickup starts and referred_completed counts successful unlocks against the sharer's verified email. First touch wins; repeats, self-referrals and sandbox tests are excluded. Sandbox sharing uses the campaign link without live attribution. Counts are readable with get_drop_referrals. Agents must not claim drops to test this; recipient pickups are human-only.
get_drop_events
ClaudeGet the activity timeline for one of the user's campaigns: pickups, unlock attempts, downloads, edits and status changes. Read-only.
get_drop_receipts
ClaudeGet the signed download receipts recorded for one of the user's campaigns. Read-only. Returns an empty list when no receipts exist.
get_drop_referrals
ClaudeExport referral counts paired with verified claimant emails. referred counts distinct email pickup starts through that person's Share link; referred_completed counts successful unlocks. referrer_email identifies the direct sharer who brought a lead. First touch wins per campaign/email. Repeats, self-referrals and sandbox tests do not count. Available with or without a capture flow. Paginate with limit/offset. Request format:csv for CSV content. Private owner data: do not publish emails in share links.
get_drop_test_results
ClaudeRead masked SANDBOX TEST history for an owner-authorized Social campaign: answers, branching, versioned scores/thresholds, pass/fail, real unlock outcome, simulated rewards/redirects and webhook dry runs. Every record is test data, never a real lead/conversion. Browser-reported messages/links are not screenshot proof. Seven-day retention. Read only: cannot run pickups, allocate codes, send webhooks or clear history. Does not read the separate account-wide webhook email inbox: its private plain-text download is an owner UI action, not an MCP tool. Unsent dry runs do not populate that inbox.
get_echodrop_social_guide
ClaudeStart here: call this first to get the complete standalone ECHOdrop Social Markdown agent guide, including the product overview, full MCP tool reference, owner settings, and operating boundaries. Public and read-only; no sign-in required.
go_live_drop
ClaudeLaunch or relaunch a ready or revoked Social campaign. First launch uses one credit from the owner's shared account balance, available across all their Social workspaces, and starts its 365-day lifetime. No workspace credit allocation is needed. Relaunching a paid campaign consumes no further credit and NEVER changes its current paid deadline. Expired campaigns cannot use free relaunch: direct the owner to Renew campaign on the website for one credit to keep the same link, or duplicate for a different campaign. Renewal is human-only. Requires Go live and revoke permission and Human approval when ON. Disables sandbox and resumes real delivery. Never buys credits. Read get_drop.agentControls: Human approval ON returns a diff and reviewUrl for independent owner approval before repeating with approvalToken; OFF applies permitted actions autonomously. Successful writes return applied:true, appliedVia:owner_approval|autonomous and the authorising agentControls snapshot. Pending review returns applied:false and appliedVia:null. Report the actual receipt, not an earlier controls read. Lifecycle tools additionally require their campaign grant. Agents cannot change these controls.
list_drops
ClaudeList the user's campaigns in one workspace (the connection's default, or the workspace argument). Optional status filter: ready, pending, revoked, consumed. Campaigns the owner has switched agent access off for (agentAccess: "off") show only their name and cannot be read or changed through MCP; the owner can switch access back on from the Your drops page.
list_sandbox_campaigns
Claudelist_workspaces
ClaudeList the user's workspaces: Personal plus any added workspaces (one per brand, offer or client). isDefault marks the workspace this connection uses when a tool call has no workspace argument. Workspace-aware tools accept a workspace's id (or "personal") as workspace. agentAccess: "off" means the owner has switched agents off there: you can only see campaign names in it.
notify_owner
Clauderevoke_drop
ClaudeWithdraw a campaign and stop pickups. Social revocation is reversible: Go live may restore it before the ORIGINAL 365-day deadline, without another credit or extending expiry; sandbox testing can be enabled separately while revoked. Keeps Social reward files. Requires Go live and revoke permission and Human approval when ON. Expired or revoked campaigns may be duplicated as fresh sandboxes. Professional behavior is unchanged; confirm with the user first. Read get_drop.agentControls: Human approval ON returns a diff and reviewUrl for independent owner approval before repeating with approvalToken; OFF applies permitted actions autonomously. Successful writes return applied:true, appliedVia:owner_approval|autonomous and the authorising agentControls snapshot. Pending review returns applied:false and appliedVia:null. Report the actual receipt, not an earlier controls read. Lifecycle tools additionally require their campaign grant. Agents cannot change these controls.
set_campaign_paused
ClaudePause or resume delivery for a Social campaign. Never changes sandbox mode; testing has its own set_campaign_sandbox tool. Resuming never publishes an unpaid campaign or disables testing. Requires Pause and resume permission and Human approval when ON. Does not spend credits or extend expiry. Read get_drop.agentControls: Human approval ON returns a diff and reviewUrl for independent owner approval before repeating with approvalToken; OFF applies permitted actions autonomously. Successful writes return applied:true, appliedVia:owner_approval|autonomous and the authorising agentControls snapshot. Pending review returns applied:false and appliedVia:null. Report the actual receipt, not an earlier controls read. Lifecycle tools additionally require their campaign grant. Agents cannot change these controls.
set_campaign_sandbox
ClaudeTurn Social sandbox testing on or off independently of Pause/Resume and Go live. Required: code and enabled. Pause or revoke an already-live campaign BEFORE enabling sandbox. Tests show on-screen codes and never send real emails, create leads or spend live codes. Disabling sandbox leaves delivery paused and never publishes an unpaid campaign. Paid testing retains the current paid end date, uses no free sandbox slot and is not subject to seven-day deletion. This tool cannot reactivate an expired campaign: direct the owner to Renew campaign on the website for one credit per additional 365 days on the same link, or duplicate into a separate new campaign. Human approval applies when ON. Read get_drop.agentControls: Human approval ON returns a diff and reviewUrl for independent owner approval before repeating with approvalToken; OFF applies permitted actions autonomously. Successful writes return applied:true, appliedVia:owner_approval|autonomous and the authorising agentControls snapshot. Pending review returns applied:false and appliedVia:null. Report the actual receipt, not an earlier controls read. Lifecycle tools additionally require their campaign grant. Agents cannot change these controls.
suggest_agent_guide_edit
ClaudePropose changes to a campaign's agent guide (brandVoice, audience, guardrails, otherInstructions). The suggestion is recorded for the owner to accept or dismiss in the campaign's Agent tab; it has NO effect until accepted. Keep following the current guide (from get_drop) in the meantime. Include only the fields you want to change; null clears a field.
update_drop
ClaudeEdit campaign fields using owner-dashboard validation: headline, copy, images, colours, consent/owner terms, questions/capture flow, redirect/capture keys, video/CTA, limits, sharing and notifications. Read get_drop first. Send only changed fields; null clears nullable fields; edits can remove data. Social Human approval ON: preview the complete diff, wait for the signed-in owner on reviewUrl, then repeat identical arguments with approvalToken. OFF: permitted edits apply autonomously without approvalToken. Cannot launch or change agent permissions. The recipient Share button is built in to every Social campaign and appears after a successful claim, not on the initial claim form or waitlist. No enable switch or editable share-button setting exists: do not invent one or ask the owner to find a dashboard-only toggle. get_drop.recipientSharing confirms this capability. It works for file, link, code, redirect and video rewards, including completed standalone question flows. After verified live claims it gives each sharer a personalized opaque link; referred counts distinct email pickup starts and referred_completed counts successful unlocks against the sharer's verified email. First touch wins; repeats, self-referrals and sandbox tests are excluded. Sandbox sharing uses the campaign link without live attribution. Counts are readable with get_drop_referrals. Agents must not claim drops to test this; recipient pickups are human-only. Read get_drop.agentControls: Human approval ON returns a diff and reviewUrl for independent owner approval before repeating with approvalToken; OFF applies permitted actions autonomously. Successful writes return applied:true, appliedVia:owner_approval|autonomous and the authorising agentControls snapshot. Pending review returns applied:false and appliedVia:null. Report the actual receipt, not an earlier controls read. Lifecycle tools additionally require their campaign grant. Agents cannot change these controls.
update_drop_code_pool
ClaudeCreate BYO/generated single-use codes; append inventory; edit label/lowWaterMark; prune unissued codes; or delete a campaign's code pool, matching the dashboard. Read get_drop.codePool first. Replacing/deleting/pruning needs confirmDestructive:true. Human approval ON requires independent owner website approval; OFF allows permitted actions autonomously. Append preserves issuance history. Does not change campaign launch status. Read get_drop.agentControls: Human approval ON returns a diff and reviewUrl for independent owner approval before repeating with approvalToken; OFF applies permitted actions autonomously. Successful writes return applied:true, appliedVia:owner_approval|autonomous and the authorising agentControls snapshot. Pending review returns applied:false and appliedVia:null. Report the actual receipt, not an earlier controls read. Lifecycle tools additionally require their campaign grant. Agents cannot change these controls.
update_drop_links
ClaudeEdit payoff contents on any campaign, including uploaded-file and mixed campaigns, without changing its code/link. Replaces the complete external-link list; uploads are preserved unless their get_drop.files[].id is explicitly listed in removeFileIds. Removing uploads permanently deletes their contents: explain consequences and obtain owner approval before setting confirmDestructive:true. To replace an uploaded text/PDF payoff with a YouTube video, send that upload's ID in removeFileIds and the video URL in links. An empty list is allowed if retained uploads or another supported payoff remain. Read get_drop.agentControls: Human approval ON returns a diff and reviewUrl for independent owner approval before repeating with approvalToken; OFF applies permitted actions autonomously. Successful writes return applied:true, appliedVia:owner_approval|autonomous and the authorising agentControls snapshot. Pending review returns applied:false and appliedVia:null. Report the actual receipt, not an earlier controls read. Lifecycle tools additionally require their campaign grant. Agents cannot change these controls.
update_drop_video
ClaudeManage an uploaded interactive campaign video: initiate_upload returns a Cloudflare tus URL for size bytes; refresh polls processing; checkpoints replaces the checkpoint list; delete archives video and removes checkpoints (confirmDestructive:true required). Human approval ON requires independent owner website review; OFF allows permitted actions autonomously. Upload actual bytes using tus before refresh; a URL is NOT a completed upload. For YouTube/Vimeo use update_drop videoUrl. Read get_drop.agentControls: Human approval ON returns a diff and reviewUrl for independent owner approval before repeating with approvalToken; OFF applies permitted actions autonomously. Successful writes return applied:true, appliedVia:owner_approval|autonomous and the authorising agentControls snapshot. Pending review returns applied:false and appliedVia:null. Report the actual receipt, not an earlier controls read. Lifecycle tools additionally require their campaign grant. Agents cannot change these controls.
upload_campaign_image
ClaudeHost PUBLIC cover or social-preview artwork in EchoDrop, without an external image host. Not for private/gated reward files. Two steps: initiate_upload with name, mime_type (PNG/JPEG/WebP) and exact size in bytes returns a temporary uploadUrl; PUT actual binary bytes there with returned Content-Type, then complete_upload with uploadId returns a permanent public URL. Max 5 MB per image (or lower workspace limit), 25 million pixels. Library capacity equals workspace package-size limit (normally 50 MB); max 500 stored/pending images. No SVG or animation. Original quality preserved, no resizing/re-encoding. Uploading changes NO campaign. Use the URL in create_drop or update_drop; existing-campaign attachment requires independent website approval when Human approval is ON, and may execute autonomously when OFF. Never expose a gated reward for a cover URL.