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-campaignandresume-campaigndon’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?
get-overviewto see what is open.list-audiencesto pick who gets it.create-campaignwith the subject, preview text, audience and body.get-campaignto show the owner the subject, the audience and its size.send-campaign-test, then the owner reads the test.check-send-readinessfor the campaign, and fix what it lists.get-send-timefor a good slot.schedule-campaignorsend-campaign, only when the owner asks.get-campaign-progresswhile it sends, thencampaign-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.