Tools
The tools the Mailly MCP server exposes, grouped by area.
Each tool is backed by the same API as the CLI. Tools that change the workspace require confirmed=true, which the assistant should set only when you asked for that exact change. Saving configuration never activates it.
Account and inbox
| Tool | What it does |
|---|---|
mailly_account | Account email, credit balance and granted permissions, with an optional overview |
mailly_list_inbox_addresses | Inbox addresses and available domains |
mailly_list_threads | Conversations, newest first; searches metadata, not bodies |
mailly_read_thread | Bodies of the latest messages in a conversation |
mailly_read_message | One inbound or sent email body, as Markdown by default |
mailly_wait_for_mail | Wait up to 25 seconds for new mail matching an address, sender or subject; can pull out a verification code or link |
mailly_load_image | An inline or external image referenced by an email |
mailly_set_thread_read_state | Mark a conversation read or unread |
mailly_create_inbox_address | Create a receiving address |
mailly_delete_inbox_address | Delete an address and all of its stored mail |
mailly_delete_message | Delete one stored email |
mailly_release_message | Move a quarantined email back to the inbox |
Drafts and sending
| Tool | What it does |
|---|---|
mailly_save_draft | Save a reply or follow-up draft for review, without sending |
mailly_update_draft | Edit an unapproved draft at its current revision |
mailly_discard_draft | Discard a draft awaiting review |
mailly_list_drafts | Pending, sent or discarded drafts. With send permission, each pending draft has a review_url you can open on any device to send or discard it without signing in |
mailly_approve_draft | Send a draft after you confirm the exact text and recipients |
mailly_send_email | Send a new email; always validated with dry_run first |
mailly_forward_message | Forward an email from the address that received it |
mailly_list_sent_messages | Sent emails with sending and delivery status |
mailly_get_sent_message | One sent email with its attempts and delivery events |
mailly_list_delivery_events | Delivered, bounced and complained events |
mailly_replay_delivery_event | Post a delivery event to your webhook again |
Domains and webhooks
| Tool | What it does |
|---|---|
mailly_list_domains | Custom domains with sending and receiving status |
mailly_add_domain | Submit a domain for ownership review |
mailly_setup_domain | Verify inbound MX and set up sending for an approved domain |
mailly_get_inbox_webhooks | Default and per-address inbound webhooks |
mailly_save_inbox_webhook | Set the workspace default inbound webhook |
mailly_save_inbox_webhook_endpoint | Add or update an address's webhook endpoint |
mailly_remove_inbox_webhook | Remove an endpoint or the default webhook |
mailly_test_inbox_webhook | Send a signed webhook.test event |
mailly_get_workspace_settings | Marketing footer and delivery webhook settings |
mailly_save_marketing_settings | Brand name and postal address for marketing mail |
mailly_save_delivery_webhook | Create or update the delivery-event webhook |
Contacts, templates, campaigns and workflows
| Tool | What it does |
|---|---|
mailly_list_contacts, mailly_get_contact | Contacts and their subscription status |
mailly_save_contact, mailly_import_contacts | Create or update contacts, one or many |
mailly_delete_contact, mailly_suppress_contact | Delete or suppress a contact |
mailly_get_subscription_status, mailly_resubscribe_recipient | Check or lift a recipient's unsubscribe |
mailly_list_audiences, mailly_save_audience, mailly_delete_audience, mailly_preview_audience | Static and dynamic audiences |
mailly_list_templates, mailly_get_template, mailly_render_template | Read and render templates |
mailly_save_template_draft, mailly_manage_template, mailly_send_template_test | Edit, publish and test templates |
mailly_list_campaigns, mailly_get_campaign, mailly_list_campaign_recipients | Campaigns and their reports |
mailly_prepare_campaign, mailly_update_campaign_content, mailly_manage_campaign, mailly_resend_campaign_failures | Prepare, edit, pause, resume and retry campaigns |
mailly_list_workflows, mailly_get_workflow, mailly_list_workflow_runs | Workflows and their runs |
mailly_save_workflow_draft, mailly_manage_workflow, mailly_cancel_workflow_run | Edit, publish and cancel workflows |
Hosted agents
| Tool | What it does |
|---|---|
mailly_list_agents, mailly_save_agent | Read and edit hosted agent profiles |
mailly_list_agent_runs | Agent runs, including drafts waiting for review |
mailly_review_agent_draft | Approve or discard a reply an agent drafted |