How to Use the Kit (ConvertKit) MCP in OpenAI Agents SDK

Q: Can the OpenAI Agents SDK read my Kit (ConvertKit) tags?

Yes. The agent automatically discovers the listalltags tool on startup. It calls this endpoint to understand your audience segmentation before applying any new tags.

Q: Does the Kit (ConvertKit) integration support OpenAI Agents SDK handoffs?

Absolutely. A support agent can look up a user via searchsubscriberbyid. It then hands the resolved user ID to a billing agent that updates their status.

Q: How do I list all subscribers with this MCP setup?

Use the listsubscribers tool. Your agent fetches the current email list and processes the data through its configured guardrails.

Build production-ready email automation agents with the OpenAI Agents SDK and this MCP Server.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Kit (ConvertKit) MCP to OpenAI Agents SDK

Create your Vinkius account to connect Kit (ConvertKit) 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 Kit (ConvertKit) with OpenAI Agents SDK

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Wire the MCP Server to OpenAI Agents

Your agent needs to handle incoming leads without hallucinating email addresses. By connecting this MCP Server, your OpenAI agent gains direct read and write access to your audience lists. It uses `add_subscriber_to_form` to capture new signups directly into your designated funnels. Handoffs work perfectly here. One specialized agent can qualify a lead via chat, then pass the context to a fulfillment agent that triggers `apply_tag_to_subscriber`. You get full tracing in the OpenAI dashboard to confirm exactly when the user entered the automation.

Audit Campaigns Automatically

Marketing teams create forms and sequences constantly. Your code needs to know what exists before acting. The agent calls `list_optin_forms` and `list_email_sequences` to map out the current active campaigns. Guardrails prevent mistakes. You can restrict the agent to read-only operations like `get_account_growth_summary` while testing. Once validated, you flip the switch to allow modifications.

Pull Precise Audience Context

Context windows matter when deciding how to message a user. Before sending an email, your agent executes `get_subscriber_details` or `search_subscriber_by_id` to pull their exact history. It checks their custom fields and active tags. If they need a profile update, the agent runs `update_subscriber` to modify their metadata immediately. No manual syncs are required.

Setup guide

Set up Kit (ConvertKit) 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 Kit (ConvertKit) tools at runtime.
3

Create your Agent

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

Run the agent

Call Runner.run(agent, prompt) to execute. The agent invokes the appropriate Kit (ConvertKit) 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="Kit (ConvertKit) Agent",
            instructions="You have access to Kit (ConvertKit) 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 Kit. 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 Kit (ConvertKit) 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 Kit (ConvertKit) MCP in OpenAI Agents SDK

Initialize MCPServerStreamableHttp with your endpoint URL. Pass it into the mcp_servers array in your Agent constructor. Set cacheToolsList=True to speed up tool discovery.

Yes. The agent automatically discovers the list_all_tags tool on startup. It calls this endpoint to understand your audience segmentation before applying any new tags.

Absolutely. A support agent can look up a user via search_subscriber_by_id. It then hands the resolved user ID to a billing agent that updates their status.

Use the list_subscribers tool. Your agent fetches the current email list and processes the data through its configured guardrails.

This integration accesses PII, specifically subscriber email addresses and custom metadata fields. Vinkius runs the process inside an ephemeral V8 Isolate Sandbox. Once the API call finishes, memory is wiped clean so your audience data never persists on our infrastructure.

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