Please wait...

Enable and use the MCP server

The MCP server allows AI tools to talk to MailWizz in a simple way. Once enabled, it can expose useful actions for things like lists, subscribers, campaigns and templates.

If you want to connect MailWizz to an MCP-compatible AI client, this is the feature you will use.

1. Enable the extension

Log in to your MailWizz backend area and go to Extensions. Enable the MCP Server extension.

Once enabled, MailWizz will expose an MCP endpoint through the API application and will also add a dedicated API key permission called Access MCP server.

2. Create or choose a customer API key

Log in to the customer area and go to API Keys. You can create a new API key or use an existing one.

If permissions are enabled for that API key, make sure you allow:

  • Access MCP server
  • the API permissions for the resources you want to use, such as lists, subscribers, campaigns and templates

If you only want to test the connection, starting with a fresh API key is usually the easiest option.

3. Find your MCP endpoint

Your MCP endpoint is your MailWizz API URL with /mcp added at the end.

For example:

  • https://your-domain.com/api/index.php/mcp
  • https://your-domain.com/api/mcp

The exact form depends on how your API URLs are configured.

If you open this URL in the browser, you should receive a small JSON response with server details. This is a quick way to confirm that the endpoint is available.

4. Connect it in your MCP client

Open your MCP-compatible client and add a new MCP server connection.

Use:

  • the MCP endpoint URL from the previous step
  • your MailWizz customer API key

Different clients have slightly different setup screens, but the idea is always the same: point the client to the MailWizz MCP URL and authenticate with your API key.

5. Start using it

After the connection is ready, your AI client should be able to discover the available MailWizz tools automatically.

You can then ask for things such as:

  • show my mailing lists
  • find a subscriber by email address
  • create a new subscriber in a list
  • show my campaigns
  • create or update an email template

It is usually best to start with simple read-only actions first, just to confirm everything is working as expected.

Use it together with the AI Assistant

If you also want the built-in MailWizz AI Assistant to use these MailWizz tools, enable the following extensions as well:

  • AI Assistant
  • AI Assistant Tools

After that, make sure the AI Assistant is enabled for customers from its settings page in the backend area.

This allows customers to use plain language in the MailWizz assistant while the assistant can use MailWizz tools behind the scenes when needed.

A small tip

For safety, only grant the API permissions that you really need. This keeps your MCP connection simple and helps avoid unexpected access.