# ActiveCampaign MCP > ActiveCampaign MCP connects your AI agent directly to your marketing automation and CRM data. Use natural conversation to create, update, and manage every element of your customer lifecycle—from adding new contacts and segmenting them into specific lists, to tracking deal progress through the sales pipeline. This lets you run complex campaigns and audit automations without ever leaving your chat interface. ## Overview - **Category:** growth-engine - **Price:** Free - **Tags:** cxa, contact-management, deal-pipelines, email-campaigns, marketing-automation, customer-lifecycle ## Description Your agent handles everything from creating a brand-new contact profile to moving deals through the sales pipeline, all based on natural conversation. Need to update someone's tags or see who's subscribed to which mailing list? You just ask. This MCP lets you manage contacts and oversee your entire marketing ecosystem without navigating complex dashboards. You can also audit existing automations to make sure customer journeys are running smoothly across the board. By connecting this via Vinkius, you get access to all of ActiveCampaign’s functionality from any compatible AI client, making it feel like a single conversation with your data. ## Tools ### list_contacts Searches for active contacts within your system, allowing you to filter results by email address. ### create_contact Adds a new person to your ActiveCampaign account using only basic profile details and an email. ### list_deals Retrieves all active opportunities from your sales pipeline so you can see deal status across different stages. ### add_contact_to_list Subscribes an existing contact to a specific mailing list, requiring both the Contact ID and List ID. ### add_tag_to_contact Applies a precise tag to a contact's profile after confirming both the Contact ID and Tag ID. ## Prompt Examples **Prompt:** ``` Search for a contact with email 'john.doe@example.com'. ``` **Response:** ``` I've found the contact John Doe. He is currently subscribed to 2 lists and has 3 active deals in your sales pipeline. Would you like to see the details of his recent interactions? ``` ## Capabilities ### Building new profiles Add entirely new people to your account using just an email address. ### Updating contact details Apply specific tags or assign existing contacts to targeted mailing lists. ### Reviewing the sales funnel Retrieve a list of active opportunities and track their status across different deal stages. ### Finding customer records Search for specific contacts by email and pull up their history or associated technical metadata. ### Auditing campaign flows Check the status of active automations to ensure they are running correctly. ## Use Cases ### A prospect needs immediate follow-up The SDR finishes a call and asks the agent, 'Find John Doe's record and add him to the High Priority list.' The agent executes `list_contacts` and then uses `add_contact_to_list`, ensuring the lead gets the right communication immediately. ### The quarterly audit of automations Marketing Ops needs to confirm that the welcome sequence is still active. They prompt, 'Audit all customer journeys.' The agent handles checking for smooth automation oversight so no campaigns fail silently. ### Moving a deal through the pipeline A sales rep confirms a major client signed off on a scope change and asks, 'Update Deal X to the Closed-Won stage.' The agent uses `list_deals` to confirm the deal ID and updates its status in one go. ### Onboarding new bulk leads A small business owner dumps a spreadsheet of 50 names. They ask, 'Add these people from this list.' The agent cycles through `create_contact` for every entry and then groups them using `add_tag_to_contact` based on the source. ## Benefits - Instantly segment your audience. You can run the `add_tag_to_contact` tool to apply specific tags, allowing you to narrow down groups for targeted campaigns without leaving your agent. - Keep sales moving fast. Instead of jumping between tabs, ask your agent to use `list_deals` and get a real-time snapshot of every active opportunity in the pipeline. - Zero manual list uploads. You can tell your agent to execute `add_contact_to_list`, immediately subscribing new leads to relevant mailing lists with simple instructions. - New contacts are easy to onboard. Use the `create_contact` tool—all you need is an email address, and your agent handles creating the profile record in ActiveCampaign. - Quick data lookups mean better service. Your agent uses `list_contacts` to pull up customer history or technical metadata instantly when needed for sales outreach. ## How It Works The bottom line is you tell your AI client what to do using plain language, and it handles the API calls to ActiveCampaign for you. 1. Subscribe to this MCP and enter your ActiveCampaign API URL along with your required API Token. 2. Select this connector within your preferred AI client, giving your agent full access to the marketing data. 3. Ask your agent a question like, 'Create a contact for Jane Smith' or 'List all active deals in the software category.' The agent executes the command and reports back with the results. ## Frequently Asked Questions **How do I use the ActiveCampaign MCP to create a contact?** You ask your agent directly. Just say something like, 'Create a new contact for David Jones using david@example.com.' The agent uses the `create_contact` tool and handles the rest. **Can I track sales deals with ActiveCampaign MCP?** Yes, you can. Use the `list_deals` tool to retrieve all active opportunities from your pipeline. This lets you see who is stuck in which deal stage without logging into the CRM. **What if I need to change a contact's list membership?** You tell your agent, 'Move John Doe to the Partner List.' The agent handles the required IDs and runs `add_contact_to_list` for you. **Does ActiveCampaign MCP handle tagging contacts?** Yes. You can apply specific tags using the `add_tag_to_contact` tool, which is useful for segmenting users who need special attention or marketing focus. **Is this better than exporting data to update lists?** Absolutely. Exporting and re-importing is slow and risky. Using the agent means you are making live, single commands (like `add_contact_to_list`) that execute immediately. **How do I add a tag to a contact?** Use the `add_tag_to_contact` tool and provide the contact ID and the tag ID. Your agent will associate the tag with that specific contact in ActiveCampaign. **What is the API rate limit for ActiveCampaign?** ActiveCampaign enforces a standard limit of 5 requests per second per account. Exceeding this returns a 429 error code. **Should I use API version 1 or 3?** While version 1 is still technically supported, we always recommend (and this agent defaults to) RESTful API version 3 for performance and stability.