How to Use the X Ads (Twitter) MCP in OpenAI Agents SDK

Q: Can I list all X Ads (Twitter) accounts using OpenAI Agents SDK?

Yep. You just call listadaccounts. It gives you a definitive roster of every ad account linked to the API, letting your agent start its audit from scratch.

Q: If I want to see recent promotions in X Ads (Twitter) with OpenAI Agents SDK, what tool do I use?

Use listpromotedtweets. It's specifically designed to pull the data on tweets that have been boosted. Your agent handles the request and returns a clean list of those promoted assets.

Run full audit cycles on X Ads (Twitter) using your OpenAI Agents SDK.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect X Ads (Twitter) MCP to OpenAI Agents SDK

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Audit Ad Accounts and Line Items

Need to see exactly what accounts are running ads? You can list all available ad accounts with `list_ad_accounts`, then drill down into specific setups. From there, you'll get a full picture using `list_line_items` to check out every active piece of creative or budgeting. This workflow lets your agent systematically audit the whole setup—it checks both the parent ad account and the smaller line items underneath it. You can also track which campaigns are running by calling `list_campaigns`, keeping your entire advertising stack visible.

Track Promoted Tweets and Ads

This server lets your agent manage content promotion directly. Use `list_promoted_tweets` to see every tweet that's been boosted on X, giving you visibility into the actual creative running. You can then get detailed ad information for a specific setup using `get_ad_account`. If you want to know what ads are currently live under a given account, calling `list_ads` shows it all. This is crucial for auditing content strategy because it lets your agent verify that the right tweets are actually getting promoted.

Get Detailed Performance Analytics

Performance tracking requires specific calls. Your agent can pull raw metrics using `get_analytics` against ad entities, giving you numbers on clicks and impressions. Beyond general data, you can also use `list_ads` to get a list of ads tied to an account. For financial checks, the server includes `list_funding_instruments`, letting your agent confirm what payment methods are attached to the ad account. This provides the necessary operational context when reviewing performance metrics.

Setup guide

Set up X Ads (Twitter) 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 X Ads (Twitter) tools at runtime.
3

Create your Agent

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

Run the agent

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

You pass the server endpoint to your Agent constructor. The agent automatically discovers all available tools, like `list_ad_accounts` and `get_analytics`. It's zero config; you just tell it what job needs doing.

This server touches ad account details, including campaign names and line items. The agent only accesses this information via secure API calls; it doesn't store or retain your credentials.

Yep. You just call `list_ad_accounts`. It gives you a definitive roster of every ad account linked to the API, letting your agent start its audit from scratch.

Use `list_promoted_tweets`. It's specifically designed to pull the data on tweets that have been boosted. Your agent handles the request and returns a clean list of those promoted assets.

Yes. You provide one endpoint token, and the MCP Server manages the secure connection to execute your calls—whether you're listing ads or checking analytics.

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