How to Use the ActiveCampaign MCP in OpenAI Agents SDK

Connect your OpenAI Agent to ActiveCampaign for guarded, production-ready CRM actions. Stop prototyping and ship.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect ActiveCampaign MCP to OpenAI Agents SDK

Create your Vinkius account to connect ActiveCampaign to OpenAI Agents SDK and route execution through our secure gateway. The platform manages server hosting, runtime updates, and security layers. Configuration requires no manual server provisioning.

GDPR Free for Subscribers

Setup ActiveCampaign with OpenAI Agents SDK

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Manage Contacts with Guardrails

This toolset lets your agent modify your ActiveCampaign contacts directly. You can add new people with `create_contact` or subscribe existing ones to new campaigns using `add_contact_to_list`. The real point here is safety. OpenAI's built-in guardrails mean your agent has to get explicit approval before it modifies your CRM data. No more worrying about an agent going rogue and messing up your contact lists. You see the plan, you approve it, then the action runs.

Full Tracing for Sales Pipeline Actions

Give your agent the ability to check on your sales pipeline. The `list_deals` tool pulls active opportunities from your ActiveCampaign account so the agent can reason about next steps. Every action your agent takes with this MCP Server is logged in the OpenAI tracing dashboard. You can see exactly which deals it looked at, what data it found, and why it decided to tag a related contact. It's a clear audit trail for every automated decision.

Segment Leads with Specialized Agents

Automate your lead segmentation. An agent can use the `add_tag_to_contact` tool to apply tags based on its analysis of a user's behavior or profile data. This works especially well with OpenAI's agent handoffs. You could have one agent that analyzes new signups, tags them, and then passes the contact ID to another agent that specializes in nurture sequences. It's how you build a proper multi-agent system that interacts with your CRM.

Setup guide

Set up ActiveCampaign MCP in OpenAI Agents SDK

Prerequisites

Python 3.10+ installed
openai-agents package (pip install openai-agents)
Active Vinkius subscription with a valid endpoint token

1

Install the SDK

Run pip install openai-agents to install the OpenAI Agents SDK. The MCP integration is built-in — no extra dependencies needed.
2

Connect via SSE transport

Use MCPServerSse with your Vinkius endpoint URL. Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com. The SDK auto-discovers all ActiveCampaign tools at runtime.
3

Create your Agent

Pass the MCP to Agent(mcp_servers=[server]). The agent receives ActiveCampaign tools as native definitions — JSON schemas resolve automatically.
4

Run the agent

Call Runner.run(agent, prompt) to execute. The agent invokes the appropriate ActiveCampaign tools and returns structured results. Copy the full example on the right to get started.

agent.py

import asyncio
from agents import Agent, Runner
from agents.mcp import MCPServerSse

async def main():
    async with MCPServerSse(
        url="https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    ) as server:
        agent = Agent(
            name="ActiveCampaign Agent",
            instructions="You have access to ActiveCampaign tools.",
            mcp_servers=[server],
        )
        result = await Runner.run(agent, "List recent transactions")
        print(result.final_output)

asyncio.run(main())

Get your connection token →

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by ActiveCampaign. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect ActiveCampaign now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about ActiveCampaign MCP in OpenAI Agents SDK

You just need to point the SDK to the Vinkius MCP endpoint. The agent discovers the tools—`list_contacts`, `create_contact`, etc.—automatically. Set `cacheToolsList=True` in the server config so it doesn't have to re-discover them on every run.

The safety guardrails. Your agent proposes a plan, like 'add contact 123 to list 456,' and you get to approve or deny it before it executes. This is critical when you're giving an AI access to your customer data in ActiveCampaign.

Yes, but you do it through your agent's instructions, not the MCP Server itself. The server exposes all the tools. You tell your agent in its system prompt which ones it is allowed to use for a given task.

You'll see the agent's tool calls, which is what you care about. The trace shows the agent deciding to use `list_deals` and the data it got back from ActiveCampaign. It makes debugging your agent's logic much simpler.

Your agent will handle contact information like names and emails, plus deal data from your sales pipeline. Vinkius provides an ephemeral, zero-trust sandbox for the server. The connection is secured, and we don't persist your ActiveCampaign data.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript