X Ads (Twitter) MCP. Audit accounts, campaigns, and analytics in minutes.
Gemini Works with every AI agent you already use
…and any MCP-compatible client
Just plug in your AI agents and start using Vinkius.
X Ads (Twitter) MCP. This connector lets your AI agent run a full audit of your paid advertising campaigns directly from your workflow.
You can list all ad accounts, check line item performance, retrieve deep analytics for ROI tracking, and review creative assets without logging into any dashboard.
It’s total oversight for advertisers.
What your AI agents can do
Get ad account
Gets specific details for one ad account using its ID.
Get analytics
Retrieves performance metrics and analytics data for advertising entities over time.
List ad accounts
Lists all ad accounts you manage within X Ads.
Gets a list of every connected X Ads account and its basic metadata.
Retrieves structured lists of campaigns, line items, and individual ad creatives within an account.
Pulls detailed advertising analytics for a specified period, letting you calculate ROI.
Lists all accepted payment and billing instruments tied to an account.
Gets a list of all active promoted tweets and creative assets.
Ask AI about this MCP
Supported MCP Clients
OAuth 2.0 Compatible Gemini Waiting for input…
X Ads (Twitter) 8 Tools
Use these tools to access every facet of your X Ads account—from high-level summaries to specific creative assets and historical performance metrics.
Make your AI actually useful.
Add this MCP to Claude, Cursor, or Windsurf and your AI stops guessing. It gets real tools to look things up, take action, and handle the stuff you keep doing by hand.
Start using X Ads (Twitter) on Vinkius019d849fget ad account
Gets specific details for one ad account using its ID.
019d849fget analytics
Retrieves performance metrics and analytics data for advertising entities over time.
019d849flist ad accounts
Lists all ad accounts you manage within X Ads.
019d849flist ads
Retrieves a list of individual ads tied to an account.
019d849flist campaigns
Lists all advertising campaigns for a specific ad account.
019d849flist funding instruments
Retrieves a list of payment methods and funding sources used by an account.
019d849flist line items
Lists the specific line items that make up your ad campaigns for an account.
019d849flist promoted tweets
Gets a list of all promoted tweets and associated creative assets.
Choose How to Get Started
Build a custom MCP for your own tools, or connect a ready-made integration from our catalog.
Build Your Own
Turn any API into an MCP. Import a spec, define Agent Skills, or deploy with MCPFusion.
- Import from OpenAPI, Swagger, or YAML specs
- Create Agent Skills with progressive disclosure
- Deploy to edge with MCPFusion framework
- Built in DLP, auth, and compliance on every call
- Real time usage dashboard and cost metering
- Publish to catalog or keep private
Make Your AI Do More
Start with X Ads (Twitter), then connect any of our 4,800+ other servers whenever your AI needs more. One click, no limits.
- Use this MCP plus 4,800+ others, all in one place
- Add new capabilities to your AI anytime you want
- Every connection is secured and compliant automatically
- Track usage and costs across all your servers
- Works with Claude, ChatGPT, Cursor, and more
- New servers added to the catalog every week
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.
VINKIUS INFRASTRUCTURE
Cloud Hosted
Managed infra
V8 Isolated
Sandboxed per request
Zero-Trust Proxy
No stored credentials
DLP Enforced
Policy on every call
GDPR Compliant
EU data residency
Token Compression
~60% cost reduction
Works with Claude, ChatGPT, Cursor, and more
The Model Context Protocol standardizes how applications expose capabilities to LLMs. Instead of operating in isolation, your AI gains direct access to external platforms, live data, and real-world actions through secure, standardized connections.
This server provides 8 capabilities that interface natively with Claude, ChatGPT, Cursor, and any MCP client. No middleware. No custom integration required.
Sifting through dashboards feels like a full-time job.
Right now, checking your ads means logging into X Ads. You have to click 'Accounts,' then check the status. Then you navigate to campaigns, download CSVs for line items, and finally pull performance analytics from a separate tab. It's tedious, time-consuming, and requires jumping between at least four different views.
With this MCP, it’s just conversation. You ask your agent for 'the ad account status and the last week's spend.' The agent handles all those clicks in the background—it runs get_ad_account, checks list_line_items, and pulls get_analytics into one clean response.
You get full oversight with X Ads (Twitter) MCP.
The granular tools eliminate guesswork. You can use list_ad_accounts to see every account, then list_funding_instruments to confirm payment status, and finally check list_promoted_tweets to ensure the creative is actually ready for prime time.
It means you stop guessing about your ad spend and start acting on concrete data that’s audited and delivered directly into your workspace.
What you can do with this MCP connector
Managing X Ads campaigns used to mean jumping between multiple dashboards, exporting CSVs, and stitching together data points just to figure out where your spend went. This MCP lets your agent orchestrate that entire process in a single conversation. You can ask it to list all ad accounts, audit specific line items for performance status, or pull detailed analytics across flexible date ranges to understand true ROI.
The whole thing becomes a natural dialogue with your ads data.
Because advertising credentials are so sensitive, the system handles everything through a zero-trust proxy—your keys never sit on a disk. This means you get full ad visibility and granular control over complex campaigns, whether you're boosting website traffic or running scaled video views. You can even chain this MCP with other systems in your catalog to build automations that span multiple platforms using the power of Vinkius.
It acts like an always-on ad analyst for your business. Your agent pulls everything together—from account setup details to campaign performance reports—so you never have to manually touch a dashboard again.
019d84a0-339a-734f-96b5-b9abcf625c14 
How X Ads (Twitter) MCP Works
- 1 First, connect your X Ads access token to the MCP via your preferred client (Claude, Cursor, etc.).
- 2 Next, instruct your agent to perform an action, like listing all ad accounts or checking campaign performance.
- 3 Your agent executes the call and returns structured data—like a list of line items or analytics metrics—directly into your conversation.
The bottom line is that you talk to your agent, and it talks to X Ads for you, giving you instant answers about your ad performance.
Who Is X Ads (Twitter) MCP For?
Marketing Ops specialists who are tired of logging into multiple ad platforms just to reconcile spend figures. Growth Analysts who need rapid, deep audits across campaign structures. Digital Marketers whose job involves constant monitoring and reporting on daily spend.
They use this MCP to verify that new campaigns or promoted tweets are correctly configured and live before spending a dime.
They rely on it to pull detailed analytics across different ad types and accounts for weekly performance reviews.
They use the MCP to run rapid audits of historical advertising data, pinpointing exactly where ROI dropped off last quarter.
What Changes When You Connect
- Instead of manually checking line item performance, you can ask the agent to list line items for a specific account, giving you immediate visibility into which efforts are working.
- You don't have to click through multiple dashboards. You can get detailed advertising analytics using get_analytics just by specifying date ranges and metric groups in your prompt.
- The MCP lets you audit not just campaigns, but also individual ads via list_ads, ensuring every piece of creative is accounted for before scaling up spend.
- Need to know the account status? You can use get_ad_account or list_ad_accounts to check metadata and funding instruments without ever touching the X Ads dashboard.
- It helps keep your content governance tight. Use list_promoted_tweets to quickly verify if a specific creative asset is correctly published and active.
Real-World Use Cases
Diagnosing poor campaign ROI after launch
The manager asks, 'Why did our Q2 engagement rate drop?' The agent responds by running get_analytics for the last 90 days and cross-referencing the data with list_line_items to pinpoint which specific ad format or spending segment failed.
Preparing an audit before a budget review
The analyst runs a full sweep by calling list_ad_accounts, then using get_ad_account on each one. This builds a comprehensive report of all accounts and their associated funding instruments for the finance team.
Checking compliance for promoted content
The operations specialist needs to confirm that every new tweet is live. They use list_promoted_tweets, which quickly lists all active assets, confirming correct deployment across the platform.
The Tradeoffs
Treating ad data as a single blob
Asking 'Give me everything about my ads.' This results in a massive, unusable dump of raw JSON that doesn't answer the core question.
→ Don’t ask for everything. Break it down: First, list_ad_accounts to narrow the scope. Then, use list_campaigns on that account ID. Finally, run get_analytics with specific date parameters.
Ignoring the asset level
Thinking that knowing a campaign exists means you know it's running correctly. You might miss stale or deactivated ads.
→ Always check list_ads and list_promoted_tweets after listing campaigns. This confirms not just if the campaign was set up, but if the creative is actually live.
When It Fits, When It Doesn't
Use this MCP if your core need is diagnostic auditing: you need to answer 'where did my money go?' or 'why did performance drop here?'. You must be able to trace data flow from a high-level account down to a specific line item and its associated metrics. Don't use this if you just need simple reporting; instead, build an automated pipeline that chains list_ad_accounts with get_analytics for continuous monitoring.
Avoid using this if your goal is predictive modeling (e.g., 'how much will we spend next month?'). This MCP excels at retrospective analysis of past performance. For simple data retrieval, listing tools like list_campaigns are perfect; but when you need the meaning behind the numbers, you must follow up with get_analytics.
Common Questions About X Ads (Twitter) MCP
How do I list all my X ads accounts using the list_ad_accounts tool? +
You simply ask your agent to 'list all ad accounts.' The agent runs list_ad_accounts and returns a structured list of every account ID you manage, letting you know exactly what's available for auditing.
Can I get historical performance data using the get_analytics tool? +
Yes. You tell your agent which ad entity (like a campaign or line item) you want to check and specify the date range, and it runs get_analytics for the metrics you need.
What is the difference between list_campaigns and list_line_items? +
List_campaigns provides a high-level view of your efforts. List_line_items dives deeper, showing the specific ad units that make up those campaigns, giving you more precise control.
Does this MCP help me check my payments? +
Yes. You can use list_funding_instruments to see exactly what payment methods are tied to your account and get_ad_account for general status checks.
How is my ad data kept secure when I use the get_ad_account tool? +
Credentials pass through a zero-trust proxy, so your keys aren't ever stored on disk. The entire connection runs within Vinkius’s sandbox environment, ensuring every call maintains an auditable and tamper-proof trail.
What can list_promoted_tweets help me monitor about my content? +
It lists all promoted tweets for a given account. This lets your agent audit creative assets directly, verifying that the right content is published and currently active on X.
If I only want details on one ad account, should I use list_ad_accounts or get_ad_account? +
You should use get_ad_account. While listing ads accounts gives you a directory, getting the account details provides specific metadata like its current status and funding instrument information.
Does list_line_items show me enough detail about my budgets? +
Yes, list_line_items is designed to give detailed visibility into your ad spending structure. It lists the individual line items within an account so you can manage and audit specific budget allocations.
Use it with your favorite AI tools
Connect this server to Cursor, Claude, VS Code, and more.