PlugPress

Mailpuff

Every Mailpuff Tool for AI Agents

The full list of what an AI agent can do in Mailpuff, tool by tool, with which ones ask for your approval first.

Everything an AI agent does in Mailpuff, it does through one of the tools on this page. They cover subscribers and imports, tags and segments, signup forms, campaigns from first draft to final report, automatic emails, sending and settings. Every tool needs an administrator account and runs the same code as the Mailpuff admin screens, so an agent and a person get the same result.

What are the tools called?

Each tool is registered as a WordPress ability under mailpuff/. The name your AI app shows depends on how you connect.

Where you call it Name to use
WordPress Abilities API (PHP or REST) mailpuff/create-campaign
Saddle saddle-mailpuff-create-campaign
MCP Adapter’s default server The adapter’s run tool with "ability_name": "mailpuff/create-campaign"

The tables below use the short name, such as create-campaign. Setup for both is in Connect an AI agent to Mailpuff. The tools say “contact” where the admin says “subscriber”. They are the same records.

Which tools ask for your approval?

Most tools read, or change a draft, and run at once. Two kinds wait for you:

  • Asks you first. Tools that send email, replace an email, delete something, or change how email goes out. With Saddle, each one shows you a preview and waits for your OK before it runs.
  • Needs the send switch. send-campaign, schedule-campaign and resume-campaign don’t exist for an agent until you turn on AI agents can send campaigns in Mailpuff → Settings → MCP & API. Only you can change that switch.

What an AI agent can and can’t do explains every check.

Which tools does Mailpuff have?

Mailpuff has 82 tools, grouped below by job. Mailpuff Pro adds more for automations, listed in Build automations with an AI agent.

Subscribers

Tool What it does Your approval
list-contacts Lists subscribers with their status, tags and field values. Filter by status, search, tag or segment.
get-contact Reads one subscriber in full: status, where they signed up, tags, fields and recent activity.
add-contact Adds one subscriber, with a tag and field values if you like.
update-contact Changes a subscriber’s name and field values.
unsubscribe-contact Unsubscribes one person who asked for it. Asks you first
import-contacts Adds up to 500 people at once with a note on how they agreed, with tags if you like.
withdraw-tracking-consent Stops counting one person’s opens and clicks when they ask.
set-post-delivery Sets how one subscriber gets new posts: each post, the digest or none.
get-site-users Shows whether your site’s user accounts are in Mailpuff.
get-inactive-subscribers Counts the subscribers who stopped opening your emails.
cleanup-inactive-subscribers Tags or unsubscribes the inactive subscribers. Asks you first

Imports from other plugins

Tool What it does Your approval
list-import-sources Lists the newsletter and CRM plugins on your site Mailpuff can import from.
import-from-plugin Imports everyone from MailPoet, The Newsletter Plugin, FluentCRM or Groundhogg.
get-import Shows how an import is going.

Subscriber fields

Tool What it does Your approval
list-fields Lists your own subscriber fields, such as City or Birthday.
create-field Makes a new field.
update-field Renames a field.
delete-field Deletes a field and every value in it. Asks you first

Tags and segments

Tool What it does Your approval
list-audiences Lists everyone a campaign can go to: all subscribers, each tag and each segment, with counts.
create-tag Makes a tag.
update-tag Changes a tag.
delete-tag Deletes a tag and takes it off everyone. Asks you first
update-tag-members Gives a tag to people, or takes it off them.
create-segment Saves a filter as a segment that stays current.
update-segment Renames a segment or changes its filter.
delete-segment Deletes a segment. Asks you first

Signup forms and spam protection

Tool What it does Your approval
list-forms Lists your signup forms.
list-form-templates Lists the signup form templates.
get-form Reads one form in full.
create-form Makes a signup form: inline, pop-up, slide-in, bar or below posts.
update-form Changes a form, or turns it on or off.
delete-form Deletes a form. Asks you first
list-form-plugins Lists the forms made with Contact Form 7, WPForms and other form plugins on your site.
connect-form-plugin Makes one of those forms sign people up.
get-spam-protection Shows how signups are protected and what was refused lately.
check-signup-email Checks whether the signup forms would accept an address.

Campaigns

Tool What it does Your approval
list-campaigns Lists campaigns.
get-campaign Reads one campaign in full, its email included.
create-campaign Makes a draft campaign.
update-campaign Changes a draft’s subject, preview text, sender or audience.
set-campaign-content Writes or replaces a draft’s whole email. Asks you first
set-campaign-style Changes how a campaign looks: its theme, fonts and colours.
list-email-themes Lists the email themes.
list-templates Lists your saved email templates.
save-template Keeps a campaign’s email as a template.
delete-template Deletes a template. Asks you first
send-campaign-test Sends one test copy. Asks you first
check-send-readiness Runs the pre-send checklist, for one campaign or in general.
get-send-time Finds a good time to send.
schedule-campaign Schedules a campaign for later. Asks you first, and needs the send switch
unschedule-campaign Takes a scheduled campaign back to a draft.
send-campaign Sends a campaign to its whole audience now. Asks you first, and needs the send switch
stop-campaign Stops a send in progress.
resume-campaign Goes on with a stopped send from where it stopped. Asks you first, and needs the send switch
cancel-campaign-send Ends a stopped send for good. Asks you first
resend-to-unopened Makes a new draft for the people who did not open a campaign.

Reports and the newsletter archive

Tool What it does Your approval
campaign-stats Reads a campaign’s results: opens, clicks for each link and more.
get-campaign-progress Shows how a send is going right now.
list-campaign-recipients Lists who got a campaign and what each person did.
set-web-version Puts a campaign on your website, or takes it down.
list-web-issues Lists the campaigns in your newsletter archive.

Automatic emails and signup emails

Tool What it does Your approval
get-automatic-emails Shows the emails Mailpuff sends on its own and whether each is on.
get-automatic-email Reads one automatic email’s template.
set-automatic-email-content Rewrites an automatic email, a tag’s welcome email included. Asks you first
send-automatic-email-test Sends you a test of an automatic email. Asks you first
get-confirmation-email Reads the confirmation email, or one tag’s own.
set-confirmation-email Sets the confirmation email’s look and words. Asks you first
get-post-email Shows what happens to one post’s email.
set-post-email Ticks or unticks “Email this post” on one post.

Sending and PostShiba

Tool What it does Your approval
get-delivery Shows how email is sent and whether it is ready.
connect-postshiba Connects PostShiba with your API key and Team ID. Asks you first
refresh-postshiba Reads your PostShiba limits and domain status again.
verify-sending-domain Asks PostShiba to check a domain’s DNS records now.
set-warmup Turns warm-up on or off. Asks you first
disconnect-postshiba Disconnects PostShiba. Asks you first
send-delivery-test Sends one short test email to check delivery. Asks you first

Overview, settings and connections

Tool What it does Your approval
get-overview Shows where Mailpuff stands: open setup steps and recent numbers.
get-settings Reads every setting with its value.
update-settings Changes settings, except the ones only you control.
get-woocommerce Shows where Mailpuff stands with WooCommerce.
list-api-keys Lists the API keys other apps use. It never shows a key.
list-webhooks Lists your webhooks and how each one’s last call went.

How an agent writes an email as blocks is covered in How AI agents write emails in Mailpuff.

What order should an agent use for a send?

  1. get-overview to see what is open.
  2. list-audiences to pick who gets it.
  3. create-campaign with the subject, preview text, audience and body.
  4. get-campaign to show the owner the subject, the audience and its size.
  5. send-campaign-test, then the owner reads the test.
  6. check-send-readiness for the campaign, and fix what it lists.
  7. get-send-time for a good slot.
  8. schedule-campaign or send-campaign, only when the owner asks.
  9. get-campaign-progress while it sends, then campaign-stats.

What limits apply to the tools?

Limit Value
Contacts in one list-contacts page 100
Campaigns in one list-campaigns page 50
People in one import-contacts call 500
Blocks in one email body 200
Characters in one block 5,000
Plain-text body returned by get-campaign 20,000 characters

Can I run the tools without an AI app?

Yes. They are ordinary WordPress abilities. In PHP, run one with the Abilities API:

$ability = wp_get_ability( 'mailpuff/campaign-stats' );
$stats   = $ability->execute( array( 'campaign_id' => 42 ) );

The tools are also open to the WordPress REST API for a signed-in administrator. The Abilities API handbook covers running abilities over REST.

FAQ

Can I turn off single tools?

With Saddle, yes. Mailpuff keeps one switch of its own, “AI agents can send campaigns”, which decides whether the sending tools exist at all.

Which settings can’t an agent change?

The ones that let email go out by itself or decide who is tracked. update-settings refuses them. The full list is in What an AI agent can and can’t do.

What happens when a tool gets a bad input?

WordPress checks every call against the tool’s input rules before it runs, and refuses anything that doesn’t fit. update-settings also checks values the way the settings screen does and names the field and the reason.