List connections is a WordPress ability from SureMail — usable via Easy MCP AI, which connects Claude, ChatGPT, and any AI assistant to your site.
Install Free Plugin →List connections
Read-onlyLists every configured email-sending connection on the site, with sensitive credentials stripped out.
Requires the SureMail plugin installed on WordPress 6.9+ (for Abilities API support). Every ability also requires the current user to have the 'manage_options' capability. Abilities that create, modify, resend, or delete data are additionally gated behind separate site options: the destructive abilities (delete-connection, delete-email-logs) require the 'suremails_abilities_api_delete' option to be enabled, and the write abilities (add-connection, update-connection, send-test-email, resend-email, update-settings) require the 'suremails_abilities_api_edit' option to be enabled.
What it does
This ability lists every email-sending connection configured in SureMail, returning each connection's ID, provider type (e.g. SMTP, SENDGRID, PHPMAIL), sender email, display name, title, priority/sequence number, force-from flags, and creation date. API keys, passwords, and tokens are never included in the response. An optional type input filters the results to a single provider. An AI assistant should call this first whenever the user asks about their email setup, since it surfaces the connection IDs needed by other abilities like get-connection or send-test-email.
See it in action
You ask your AI assistant
"Show me all the email connections configured on this site, and tell me which provider each one uses."
Inputs
| Name | Type | Required | Description |
|---|---|---|---|
| type | string | No | Filter by provider type (e.g., SMTP, SENDGRID, GMAIL). |
Returns
An object with a connections array (each entry containing id, type, from_email, connection_title, priority, from_name, force_from_email, force_from_name, and created_at) and a total count.
Permission
The current user must have the 'manage_options' capability.
More SureMail abilities
Add new email connection
Creates and authenticates a new email-sending connection against its provider's credentials.
Delete connection
Permanently deletes an email connection by ID, an action that cannot be undone.
Delete email logs
Permanently deletes one or more email log entries and any attachments used only by them.
Get connection details
Retrieves the full non-sensitive details of a single email connection by its ID.
Get default connection
Returns the connection that WordPress is currently using to send all outgoing emails.
Get email delivery statistics
Returns aggregate sent/failed email counts and a daily breakdown for a given date range.