X Ads (Twitter) MCP. Audit Ad Accounts & Performance Data Instantly
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 Server lets your AI agent manage all aspects of paid advertising on X. It audits ad accounts, lists campaign performance data down to individual line items, and pulls detailed analytics for ROI tracking—all without needing manual dashboard logins.
What your AI agents can do
Get ad account
Gets specific metadata for one X Ads account ID.
Get analytics
Retrieves detailed performance metrics (spend, impressions) for defined ad entities and time periods.
List ad accounts
Lists all X Ads accounts accessible under the connected profile.
The agent retrieves a full roster of every connected X Ads account, providing ID details for subsequent audits.
You can list and review campaigns, then drill down to see specific line items and ads within those campaigns.
The server pulls detailed analytics on spend, engagements, and performance over user-defined date ranges, calculating true ROI.
You can list all promoted tweets and creative assets to ensure your intended ad content is live and correctly published.
The tool lists the financial instruments (like credit cards or prepaid balances) linked to an ad account, confirming operational readiness.
Ask AI about this MCP
Supported MCP Clients
Gemini Waiting for input…
X Ads (Twitter): 8 Tools for Ad Campaign Data
Access ad account details, campaign lists, performance metrics, and creative assets using these eight dedicated tools.
019d849fget ad account
Gets specific metadata for one X Ads account ID.
019d849fget analytics
Retrieves detailed performance metrics (spend, impressions) for defined ad entities and time periods.
019d849flist ad accounts
Lists all X Ads accounts accessible under the connected profile.
019d849flist ads
Retrieves a list of ads associated with a specific ad account.
019d849flist campaigns
Lists all campaigns running under an ad account ID.
019d849flist funding instruments
Shows the payment methods and funding details attached to a specific ad account.
019d849flist line items
Lists all granular line items within an ad campaign, detailing their status and spend.
019d849flist promoted tweets
Retrieves a list of tweets that are currently being run as promoted ads for the account.
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,700+ other servers whenever your AI needs more. One click, no limits.
- Use this MCP plus 4,700+ 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
What you can do with this MCP connector
Your AI client connects directly to your entire X Ads ecosystem using X Ads (Twitter) MCP Server. Your agent doesn't just read data; it runs full audits on ad accounts, lists every campaign running, tracks line item spending down to pennies, and pulls detailed analytics for ROI—all without you having to log into any manual dashboard.
You just tell your agent what you need, and it gets it.
Account Setup and Status Checks
Your first stop is figuring out which accounts are even connected. The agent runs list_ad_accounts immediately, giving you a full roster of every X Ads account accessible under the profile, along with their unique IDs. You can then drill down into any specific setup using get_ad_account, which pulls core metadata for one given account ID.
To confirm operational readiness, the agent executes list_funding_instruments, showing you exactly what payment methods and funding details are attached to an ad account—whether that's a credit card or just a prepaid balance.
Auditing Campaign Structure
Want to know precisely what’s running? The system starts with list_campaigns, listing every single campaign active under a specific ad account ID. From there, you can map out the whole structure by calling list_line_items, which details all granular line items within those campaigns, telling you their status and how much they've spent so far.
You also get list_ads, grabbing an exhaustive list of ads associated with that account ID. Finally, to check your creative assets, the agent uses list_promoted_tweets, giving you a complete list of every tweet currently being run as a paid ad for the account.
Performance and Analytics Deep Dive
When it comes time to know if you're actually making money, the server pulls detailed performance metrics. You use get_analytics to retrieve spend, impressions, and other critical measurements for any defined set of ad entities over a specific date range. This lets you calculate true ROI without manually cross-referencing spreadsheets.
Your agent handles all this heavy lifting, giving you actionable data on what's working and what's bleeding cash.
How X Ads (Twitter) MCP Works
- 1 Subscribe to this server and provide your X Ads Access Token.
- 2 Connect the token to your AI client (Claude, Cursor, etc.).
- 3 Tell your agent what you need: 'List all active campaigns for account XYZ' or 'Get analytics for last week.' The agent executes the required tools.
The bottom line is that your AI client uses the token to make direct API calls against X Ads, translating complex data requests into simple conversations.
Who Is X Ads (Twitter) MCP For?
This server is for anyone whose job involves paid advertising and reporting. If you spend time clicking through multiple dashboards just to answer 'How much did we spend on video last week?' or 'Is Campaign Beta actually live?', this is for you. You're the person who needs data correlation, not pretty charts.
Runs daily checks to verify that new campaigns and promoted tweets are correctly configured and active before launch.
Pulls ad spend reports, audits line item performance, and correlates campaign activity with website traffic goals without leaving the chat interface.
Performs rapid, historical audits of advertising performance to identify trends and bottlenecks in ad spend or engagement rates.
What Changes When You Connect
- Full Visibility: Use
list_ad_accountsto see every single ad profile you manage, eliminating the need to jump between siloed dashboards. - Granular Auditing: Drill down through campaigns using
list_campaigns, then check specific performance details withlist_line_items. You always know where your money is going. - Historical Reporting: The
get_analyticstool pulls comprehensive data over custom date ranges. Get a full ROI picture, not just today's numbers. - Content Verification: Run
list_promoted_tweetsto confirm if the creative content you intended to run is actually live and active on X. - Operational Checkup: Use
list_funding_instrumentsto quickly verify that an account isn't stalled because a payment method expired or failed.
Real-World Use Cases
Checking if a new campaign is live
A manager needs to confirm Campaign Alpha started running. They ask the agent: 'Show me all promoted tweets for account ABC.' The agent uses list_promoted_tweets and confirms the specific creative assets are active, saving them from manually checking the X platform UI.
Diagnosing unexpected ad spend
A growth analyst noticed a sudden spike in cost. They ask the agent to 'Get analytics for the last 48 hours and break it down by line item.' The agent uses get_analytics combined with list_line_items to pinpoint exactly which underperforming ad unit caused the spend creep.
Preparing a quarterly audit report
The team needs to summarize performance across three different accounts. They instruct their agent to 'List all ad accounts' first, and then run get_analytics sequentially for each ID, compiling one master spend/engagement report.
Verifying payment readiness
Before a major launch, an Ops specialist needs to confirm the billing status. They ask: 'What funding instruments are attached to account XYZ?' The agent uses list_funding_instruments and confirms everything is paid up and ready to run.
The Tradeoffs
Looking only at campaign names
A user assumes seeing a 'Video Campaign' listed means all video ads are running. They might just use list_campaigns and assume success.
→
Don’t stop there. You must follow up by using list_line_items to see the granular status of individual ad units, and then run get_analytics with a date range to confirm actual spend.
Asking for 'performance' generally
A user asks: 'How is my performance?' This prompt is too vague because performance covers cost, engagement, dates, and accounts.
→
Be specific. You need to tell the agent which data point you want (get_analytics) AND what date range (start_date, end_date). Always scope your query.
Ignoring account structure
A user tries to get analytics for a campaign without first identifying the parent ad account ID, causing the API call to fail.
→
Always start by running list_ad_accounts to find the correct target ID. Then, use that ID when calling list_campaigns or get_analytics.
When It Fits, When It Doesn't
Use this server if your workflow requires deep data correlation across multiple ad resources—specifically, connecting account status, campaign structure (list_campaigns), and real-time metrics (get_analytics). You should use it when you need to know why the numbers are what they are. Don't use this if all you need is basic content posting or simple platform monitoring; for that, a dedicated publishing API might be better. If your goal is just listing assets without performance context, list_promoted_tweets works well, but remember it doesn't tell you how much those tweets cost.
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.
Available Capabilities
Checking campaign status means jumping through endless dashboards.
Today, checking if a new ad is live is a nightmare. You open the main dashboard, find Account A. Then you click into Campaigns -> Line Items to see Status X. If that's not enough, you have to go to the Creative section just to verify the tweet itself, and finally, check the Analytics tab to make sure it’s actually spending money. It takes five tabs and a half hour.
With this MCP server, you ask your agent: 'Check Campaign Beta.' The agent runs `list_campaigns` for scope, then uses `list_promoted_tweets` for content verification, and finally calls `get_analytics`. You get a single, consolidated answer in chat. Period.
X Ads (Twitter) MCP Server: Get accurate performance data.
Manually compiling ROI reports means exporting CSVs from three different views—one for spend, one for impressions, and a third for engagement rate. You then have to manually join those datasets in Excel, fixing date mismatches every time.
Now, you just tell your agent: 'Give me the total engagement report for Q3.' The server runs `get_analytics` with precise parameters, returning a single, structured data object ready for immediate use. No CSV exports necessary.
Common Questions About X Ads (Twitter) MCP
How do I find out how much money we spent last month using X Ads (Twitter)? +
Use the get_analytics tool. You need to provide it with the start and end dates, and specify 'spend' as a key metric group. Don't forget the date range.
Can I check all my X Ads accounts at once? Which tool do I use? +
Yes, run list_ad_accounts. This command shows you every ad account ID under your profile. You'll need those IDs for any subsequent audit calls.
Does X Ads (Twitter) MCP Server show me the payment methods? How do I check? +
Use list_funding_instruments. This tool connects to an ad account ID and shows all attached billing details, confirming if payments are set up correctly.
I need to see what's running right now. Which X Ads (Twitter) tools list active content? +
You should use list_promoted_tweets. This tool pulls a live manifest of the specific creative assets that are currently published and spending money on your behalf.
How do I audit my current campaign setup using the `list_campaigns` tool? +
The list_campaigns tool provides a structured view of every active and paused campaign for your account. This allows you to confirm names, objectives, and IDs without needing to log into the X Ads dashboard.
If I only need details for one specific ad account, which function should I use? (Using `get_ad_account`) +
Use the get_ad_account tool and pass the ID of the single account you want to check. This action retrieves all core metadata about that specific profile, including its current status.
How do I view the granular cost breakdown using the `list_line_items` tool? +
The list_line_items function details the components beneath a campaign. It lets you verify budget caps and track costs at a hyper-specific level, helping pinpoint spending discrepancies.
If my data pull fails or returns partial information, what's the first thing I should check? (Authentication/Security) +
First, confirm that your X Ads Access Token is active and has full read permissions for all required tools. Most errors stem from expired tokens or insufficient scope.
How do I find my X Ads Access Token? +
You must create a developer account at developer.x.com, create a Project/App, and perform the OAuth flow to generate a Bearer Token. Copy and paste it below.
Can the agent list my promoted tweets? +
Yes. Use the list_promoted_tweets tool providing your Ad Account ID. Your agent will retrieve metadata for all tweets currently being used in your advertising campaigns.
Is it possible to see analytics for specific line items? +
Yes. The get_analytics tool allows your agent to fetch daily performance metrics for specific entity IDs (campaigns, line items, or ads) by providing a date range.
Use it with your favorite AI tools
Connect this server to Cursor, Claude, VS Code, and more.
More in this category
HubSpot CMS Hub
Manage blog posts, site pages, landing pages, authors, tags, and domains through natural conversation.
PreciseFP
Collect client financial data digitally with compliant intake forms designed for wealth management and financial planning firms.
AT&T IoT
IoT Control Center -- Manage SIM devices, activation, data pools, shared plans, and connectivity diagnostics via AT&T IoT API.
You might also like
ClinicalTrials.gov
Search the world's largest registry of clinical research studies — covering diseases, drugs, and experimental therapies across all phases.
Decodo (Smartproxy)
Manage your Decodo (formerly Smartproxy) network infrastructure — list proxy endpoints, monitor bandwidth, and fetch residential proxy configurations with your AI.
MyTime
Manage business operations via MyTime — track appointments, staff, and services directly from your AI agent.