mailerpress/manage-settings reads and writes MailerPress plugin settings through a single surface. The action parameter picks the operation.
Six operations, and the provider ones are the consequential half.
At a glance
| Ability | mailerpress/manage-settings |
| Toolset | MailerPress — toolset/mailerpress |
| Group | MailerPress › Settings & Delivery |
| Requires | AcrossAI Pro, plus MailerPress active on the site |
| Capability | manage_options |
| Safety | Writes data |
| Repeatable | Idempotent — running it twice leaves the same result |
| Ships in | AcrossAI Pro 0.9.16 and later |
How it works
get-active-provider reads which email service MailerPress is currently sending through. Everything the plugin sends goes through it, so it is the first thing to check when email stops arriving.
connect-provider adds or updates one and set-primary-email-service chooses which is active. Switching provider changes the sending path for every campaign, every transactional email and every workflow action at once.
disconnect-provider drops the active provider, which leaves the site with no sending path — campaigns queue and nothing is delivered.
export-settings and import-settings dump and restore the configuration. An export is the only rollback available before a provider change, and worth taking.
Sub-parameters depend on the action, and provider credentials are involved in the connect operation — which makes it the one to run deliberately rather than exploratively.
Idempotent for the read and the set operations.
Input
| Name | Type | Required | What it is |
|---|---|---|---|
action | string | Yes | get-active-provider, connect-provider, disconnect-provider, set-primary-email-service, export-settings or import-settings. |
provider | object | For the provider actions | Provider configuration. |
settings | object | For import | A previously exported settings payload. |
What comes back
| Name | Type | What it is |
|---|---|---|
result | object | The outcome, shaped by the action. |
success | boolean | Whether the call completed. |
message | string | A one-line summary of what happened, suitable for showing a human. |
error_code | string | Present only on failure — a stable machine-readable reason, such as a missing field, a wrong field type or an unmet confirmation. |
Example
Ask your assistant:
Which email provider is this site using?
It resolves to one call:
{
"ability": "mailerpress/manage-settings",
"parameters": {
"action": "get-active-provider"
}
}Worth knowing
- Everything MailerPress sends goes through the active provider.
- Disconnecting leaves the site with no sending path at all.
- Export before changing provider — it is the only rollback.
- Switching provider affects campaigns, transactional email and workflows at once.
Related abilities
- MailerPress Send Raw Email — test the active provider
- MailerPress Get Campaign Email Logs — which service handled each email
Get the plugins:
AcrossAI Abilities Manager · AcrossAI MCP Manager
Browse the rest: Every ability, by category