# Listmonk MCP for AI Agents AI Agent Connect > Listmonk lets you handle your newsletter and mailing list management through an AI agent. You can create subscribers, organize lists, and track your email campaigns without jumping between different tabs. It connects your existing Listmonk instance directly to your favorite AI client for faster marketing workflows, more accurate audience segmentation, and instant transactional messaging. ## Overview - **Category:** marketing-automation - **Price:** Free - **Endpoint:** https://edge.vinkius.com/vk_preview_Ig3I1AI4VMZYYZS1xtwthf4BxOy9dXKHEPDlu6b8/ai-agent-connect - **Tags:** newsletter-management, mailing-lists, subscriber-management, email-campaigns, self-hosted, data-filtering ## Description Listmonk lets you manage your entire email marketing operation through a simple conversation with your AI agent. Instead of logging into a dashboard to find specific people or tweak a campaign, you just tell your agent what needs to happen. You can pull subscriber lists based on specific criteria, create new campaigns from scratch, or send out high-priority transactional messages instantly. It handles the heavy lifting of organizing your audience and managing your assets like templates and media files. Since Vinkius makes it easy to connect these tools, you can keep your marketing moving while staying in your primary workspace. It is built for people who want to treat their newsletter like a data set rather than a chore. ## Tools ### list_bounces Retrieve bounce records. See which emails failed to deliver recently. Use this to troubleshoot delivery issues. ### create_campaign Create a new campaign. This lets you set up a new newsletter or marketing blast. You can then move it from a draft to a live send. ### create_list Create a new list. Use this to organize your subscribers into specific segments. It helps you keep your audience targeted. ### create_public_subscription Create a public subscription. This lets people sign up for your content easily. It simplifies your lead capture process. ### create_subscriber Create a new subscriber. Add new people to your database with a single command. This is great for manual entries. ### create_template Create a template. Build new email designs and save them for later use. This keeps your branding consistent across sends. ### delete_bounces Delete multiple bounce records. Clean up your list by removing failed email deliveries. It keeps your sender reputation healthy. ### delete_campaign Delete a campaign. Remove old marketing efforts from your history. This keeps your campaign dashboard tidy. ### delete_list Delete a list. Get rid of mailing segments you no longer need. Use this to prune old data from your account. ### delete_media Delete a media file. Remove old images or files from your asset library. This helps you manage your storage space. ### delete_subscriber Delete a specific subscriber. Remove a single person from your database. This is useful for handling privacy requests. ### delete_template Delete a template. Clear out old email designs from your library. It helps you keep only your best designs active. ### get_campaign Retrieve a specific campaign. Pull up the details of a campaign you want to check. This is perfect for status audits. ### get_subscriber Retrieve a specific subscriber. Look up the details of an individual person in your list. This helps with customer support. ### list_campaigns Retrieve all campaigns. View a full list of your marketing history. This gives you a bird's-eye view of your work. ### list_lists Retrieve all lists. See every segment you have created for your audience. This helps you organize your marketing strategy. ### list_media Get uploaded media files. Browse the images and files you have stored for emails. This lets you see what assets are ready. ### list_public_lists Retrieve public lists. See the lists available for public signups. This helps you manage your public-facing content. ### list_subscribers Query and retrieve subscribers. Use SQL-like filters to find specific people in your lists. This is the core of your audience management. ### list_templates Retrieve all templates. See every email design you have saved in your account. Use this to find the right look for your next send. ### patch_subscriber Partially update a subscriber. Change specific details for a user without overwriting everything. This is great for quick edits. ### send_transactional_message Send transactional messages to one or more subscribers using a template. Send urgent alerts like password resets instantly. ### stop_import Stop an ongoing import. Halt a subscriber list upload if you notice an issue. This prevents bad data from entering your system. ### update_subscriber Update a specific subscriber. Change the information for an individual person in your database. This is useful for profile updates. ### update_template Update a template. Edit the design or content of an existing email template. Use this to refresh your recurring newsletters. ### get_import_status Retrieve import status. Check if your latest subscriber list upload is finished. This saves you from guessing if it worked. ### update_campaign_status Change campaign status. Move a campaign from draft to sent or vice versa. This keeps your workflow moving without extra clicks. ### update_list Update a list. Modify the details of an existing mailing list. Use this to keep your list metadata current. ## Prompt Examples **Prompt:** ``` Find all subscribers in list 5 who are currently enabled. ``` **Response:** ``` I've queried your subscribers in list 5. Here are the results: | Name | Email | Status | | :--- | :--- | :--- | | Jane Doe | jane@example.com | Enabled | | John Smith | john@example.com | Enabled | | Alice Wong | alice@example.com | Enabled | Would you like to export this list or filter it further? ``` **Prompt:** ``` Create a draft campaign for the July newsletter. ``` **Response:** ``` Done! I've created a new campaign draft for you: **Campaign Name:** July Newsletter **Status:** Draft You can now tell me to assign lists to it or update the content. ``` **Prompt:** ``` Show me my available templates. ``` **Response:** ``` You have 3 email templates ready to use: * **Default** * **Newsletter-V2** * **Transactional-Simple** Which one would you like to use for your next message? ``` ## Capabilities ### Filter and list subscribers Query your mailing list to find specific people based on custom criteria. ### Create new mailing lists Build new segments and public subscriptions for your audience. ### Build and launch campaigns Move your email newsletters from draft to sent status through natural language. ### Send immediate transactional emails Trigger high-priority messages like password resets or order confirmations instantly. ### Manage templates and media Organize your library of email designs and hosted media files in one place. ## Use Cases ### Segmenting a list A marketer asks the agent to find all users in a specific list who haven't opened a recent email. The agent pulls the data immediately. ### Transactional alerts A dev tells the agent to send a "subscription confirmed" email using a specific template. The message goes out without a manual trigger. ### Campaign audit A creator asks the agent to list all active campaigns and check their current statuses. This helps them see what is currently live. ### Media cleanup A manager asks the agent to delete old media files to keep the library tidy. This keeps the asset folder organized and useful. ## Benefits - Query subscribers instantly using `list_subscribers` to find specific people without manual filtering. - Launch campaigns faster by using `create_campaign` to move from idea to draft in seconds. - Send urgent messages immediately with `send_transactional_message` for things like password resets. - Organize your assets by pulling up specific templates with `list_templates` whenever you need them. - Keep your list clean by using `delete_bounces` to remove failed deliveries automatically. - Manage public subscriptions with `create_public_subscription` to let people sign up easily. ## How It Works The bottom line is you get a direct line of communication between your AI agent and your email marketing platform. 1. Subscribe to the Connector and provide your Listmonk URL and API token. 2. Connect your preferred AI client to the Vinkius catalog. 3. Start giving commands like "find everyone in list 2" or "send a welcome email." ## Frequently Asked Questions **Can I use Listmonk MCP to manage my mailing lists?** Yes, you can create, list, and delete mailing lists to keep your audience organized. This allows you to manage your segments entirely through your AI agent. **Does Listmonk MCP support sending transactional emails?** Yes, it lets you send high-priority messages like order confirmations or password resets instantly. You just tell your agent which template to use. **How do I filter subscribers with Listmonk MCP?** You can use natural language to find specific people based on your list criteria. Your agent handles the query logic so you don't have to write complex filters. **Can I manage my email templates with Listmonk MCP?** Yes, you can list and update your existing templates directly through your AI client. This makes it easy to see what designs you have available. **Can Listmonk MCP help me with campaign statuses?** Yes, you can update the status of your campaigns from draft to sent without opening the dashboard. It keeps your workflow moving smoothly. **Is Listmonk MCP good for newsletter creators?** It is perfect for creators who want to manage their media, lists, and campaigns through simple commands. It removes the need to click through a complex dashboard. **Can I search for subscribers using specific SQL-like attributes?** Yes! Use the `list_subscribers` tool with the `query` parameter. You can use SQL expressions to filter by attributes, names, or email patterns directly through the agent. **How do I send a one-off transactional email to a user?** Use the `send_transactional` action. You just need to provide the subscriber's email or ID and the template ID you wish to use for the message. **Can I stop an ongoing subscriber import if I notice an error?** Absolutely. Use the `stop_import` tool to immediately halt any active subscriber import process in your Listmonk instance.