# Maropost MCP > Maropost MCP connects your favorite AI agent directly to your marketing automation platform. Manage contacts, check campaign performance, and audit workflows using natural conversation. It turns complex CRM data into simple prompts, letting you run reports or update records without ever leaving your chat window. ## Overview - **Category:** ecommerce - **Price:** Free - **Tags:** audience-engagement, email-marketing, contact-management, marketing-cloud, customer-journey ## Description Need full control over your marketing efforts without logging into a dashboard? This MCP connects any AI agent to Maropost, giving you direct access to all your campaign and contact data. Instead of digging through menus, you just ask the questions—like 'What's the open rate for the last newsletter?' or 'Add this new user to the VIP list.' It gives your agent the power to handle everything from basic contact creation to pulling detailed performance reports. Because it runs through Vinkius, you connect once and gain access to Maropost alongside thousands of other tools. You can manage lists, view campaign configurations, or even retrieve complex workflow details just by talking to your AI client. ## Tools ### create_contact Creates a new user profile or modifies an existing one in Maropost. ### get_campaign_details Retrieves the full configuration and status for a specific campaign ID. ### get_contact Fetches all details about one person using their email address. ### get_list_details Gets information on a contact list, including its rules and membership size. ### get_report_details Retrieves the specific data points from a performance report using its ID. ### get_workflow_details Fetches detailed information about how an automated customer workflow operates. ### list_campaigns Provides a list of all available marketing campaigns in your account. ### list_contacts_in_list Returns a roster of contacts who belong to a designated mailing list. ### list_lists Provides an inventory of every contact list you manage in Maropost. ### list_reports Lists all available reports and their IDs, so you know what data is accessible. ### list_workflows Provides a summary of every automated workflow that runs in your account. ## Prompt Examples **Prompt:** ``` Find contact details for john.doe@example.com. ``` **Response:** ``` Fetching contact info... I found John Doe in your database. He is currently subscribed to 2 lists. ``` **Prompt:** ``` List all active campaigns in Maropost. ``` **Response:** ``` Querying campaigns... You have 5 campaigns listed, including 'Weekly Newsletter' and 'Holiday Promotion'. ``` **Prompt:** ``` Show performance report for campaign ID 987. ``` **Response:** ``` Retrieving report... Campaign 987 had a 25% open rate and a 5% click-through rate. ``` ## Capabilities ### Manage contact records Create new contacts or update existing user information using the agent. ### List and query contact groups Get details about specific mailing lists, or retrieve all contacts belonging to a particular group. ### Review campaign status View high-level summaries of campaigns and pull detailed configuration for any given ID. ### Analyze performance reports Fetch specific metrics, like open rates or click-through numbers, from historical marketing reports. ### Understand automation flows List and retrieve detailed information about complex customer workflows and automations. ## Use Cases ### Auditing a campaign's reach A Marketing Manager needs to know how many people received the 'Summer Sale' email and if there were any errors. They ask their agent, which calls `list_campaigns` first, then uses `get_campaign_details` on the correct ID to confirm the total send count. ### Cleaning up old user data A CRM Admin notices a contact is missing from an important list. They run `get_contact` by email, confirming the details, and then use `create_contact` to manually update or re-add them to the correct group. ### Checking workflow logic A specialist wants to verify if the welcome sequence runs correctly. They prompt the agent to list workflows, find the specific 'Welcome' automation, and then call `get_workflow_details` to map out every step. ### Segmenting contacts for a new promotion The team wants to target only premium users. They first use `list_lists` to find the 'Premium Members' list, then prompt the agent to pull all names using `list_contacts_in_list`. ## Benefits - Instant reporting: Instead of digging into the analytics dashboard to find performance data, you can simply ask your agent for details using `list_reports` and then retrieve the specifics via `get_report_details`. - Precision contact management: Need to update a single user's status or add them somewhere new? You use `create_contact`, making sure every piece of customer data is accurate without opening a web form. - Clear list segmentation: Instead of guessing who belongs where, you can call `list_lists` and then immediately get the full membership roster for any group using `list_contacts_in_list`. - Campaign oversight: Get a quick view of everything running. Use `list_campaigns` to see all active efforts, followed by `get_campaign_details` to check the status of one specific initiative. - Automation visibility: Stop guessing how your nurturing sequence works. Your agent lets you list workflows and then use `get_workflow_details` for a full breakdown of the steps involved. ## How It Works The bottom line is, you talk to your agent like talking to an employee who already has access to your entire Maropost dashboard. 1. Subscribe to this MCP on Vinkius. 2. Enter your Maropost Account ID and API Key into the settings for your AI client. 3. Start a conversation in your preferred chat interface; your agent uses the tools to pull data or execute actions. ## Frequently Asked Questions **How can I use Maropost MCP to find contact details for one person?** You simply ask your agent for the contact's info using their email address. The agent automatically calls `get_contact` and returns their current status, list memberships, and other details. **Can I see all my available marketing campaigns with Maropost MCP?** Yes, you just ask the agent to list them. The tool handles this by calling `list_campaigns`, giving you a full overview of everything running in your account. **What if I need to update a contact record using Maropost MCP?** You use the agent and instruct it on the change. It executes this by calling `create_contact`, ensuring the data is updated accurately and immediately in Maropost. **How do I check if a workflow is running correctly with Maropost MCP?** The agent lets you list all available workflows using `list_workflows`. From there, you can request specific details on any one of them by calling `get_workflow_details`. **Can I get a summary report for last quarter’s marketing efforts with Maropost MCP?** You first ask the agent to list available reports using `list_reports`. Once you know which report ID is correct, you call `get_report_details` to pull the full metrics.