X Ads (Twitter) MCP. Audit Campaigns & Performance Metrics Instantly
X Ads (Twitter) MCP lets your AI agent manage every part of your advertising operation through natural conversation. Audit ad accounts, pull detailed performance metrics for specific campaigns or line items, and verify creative assets without opening the ads manager. It's a full audit suite designed to answer complex marketing questions instantly.
Give Claude and any AI agent real-world access
Check if an ad account is active and gather its core metadata before running any reports.
Retrieve a full structure of every campaign, including details on the targeting and bidding strategy for each line item.
Generate reports showing daily spending, engagement rates, and conversion numbers across specific ads or campaigns over custom date ranges.
View all media creatives, including images and videos, that are currently running or paused on the account.
List attached payment methods and funding instruments to confirm that ad spending is covered.
Ask an AI about this
Waiting for input…
What AI agents can do with X Ads (Twitter) MCP: 13 Tools
Use these tools to access every aspect of your X Ads account, from listing all campaigns and line items to pulling detailed performance metrics for specific ads.
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) MCPGet Ad Account
Use this to get detailed metadata for a specific X Ads account, confirming its activity status.
List Ad Accounts
Lists all accessible X (Twitter) Ads accounts, providing their IDs, names, and...
List Ads
Retrieves a list of every individual ad, showing which line item and creative asset...
List Campaigns
Lists all campaigns within an X Ads account, including their status, budget, and...
List Funding Instruments
Provides a list of payment methods and billing sources attached to the ad account...
List Line Items
Lists all line items across campaigns, which define the targeting rules and bidding strategies used.
Get Analytics
Pulls performance reports for ads, lines, or campaigns over specified date ranges using various metrics (e.g., engagement, billing).
Get Campaign
Fetches the full details of a single campaign when you know its ID.
Get Line Item
Retrieves all specific details for one line item, provided you have its unique ID.
List Media Creatives
Lists every media asset (images or videos) used in the account to help audit current...
List Promoted Tweets
Verifies which tweets are actively running or paused, listing all promoted content...
List Tailored Audiences
Lists custom audiences used for retargeting and matching against CRM data.
List Targeting Criteria
Shows all specific targeting rules that have been applied to a particular line item, requiring both account and line item IDs.
Security and governance baked right in.
Pick your AI client below to get set up. Just create a Vinkius account, subscribe, and you're instantly up and running. We handle the entire backend infrastructure, delivering out-of-the-box support for HTTPS Streamable, SSE, and OAuth2—zero messy routing required.
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 each 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 5,200+ other servers whenever your AI needs more. One click, no limits.
- Use this MCP plus 5,200+ others, all in one place
- Add new capabilities to your AI anytime you want
- Connections are secured and governed automatically
- Track usage and costs across all your servers
- Works with Claude, ChatGPT, Cursor, and more
- New servers added to the catalog weekly
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 CLOUD
Cloud Hosted
Managed infra
V8 Isolated
Sandboxed per request
Zero-Trust Proxy
No stored credentials
DLP Enforced
Policy on each call
GDPR Compliant
EU data residency
Token Compression
~60% cost reduction
Ad campaigns are messy; checking them used to require an army of tabs.
Today, pulling a quarterly performance review means logging into the ads manager. You click on 'Campaigns,' then filter by date range, export the data, jump to a second tab to check billing status using a different section, and finally, copy-paste all those metrics into a spreadsheet for your boss. It's time-consuming, prone to manual error, and takes up half a workday.
With this MCP connected through Vinkius, you simply ask your agent: 'Pull the total engagement metrics for Q2.' The system handles the credential management, runs the necessary internal calls—like checking `list_campaigns` and then running `get_analytics`—and delivers a clean, ready-to-use summary in plain text. You just get the answer.
X Ads (Twitter) MCP: Full Visibility Into Your Ad Performance
You no longer have to manually cross-reference which specific ads are running, which line items they belong to, or what their current budget constraints are. You can ask for a full audit of promoted tweets and assets from one prompt.
The difference is that you move from data retrieval (copy/paste) to intelligence gathering (asking questions). This MCP lets your agent interpret the ad structure for you.
What X Ads (Twitter) MCP does for your AI
Managing paid social campaigns shouldn't feel like clicking through five different dashboards just to get a summary report. This MCP connects your X Ads account directly to your AI client, letting you run an entire advertising operation using simple conversation. Instead of manually pulling reports for spending or engagement, you ask the question—like, 'Show me the CTR difference between retargeting and lookalike audiences last month'—and get a structured answer back immediately.
It gives you full visibility into your ad accounts, letting you list everything from active campaigns to specific ads running under line items. You can analyze performance across custom date ranges, selecting metrics like video views or web conversions on demand. When you connect this MCP via Vinkius, it becomes another powerful tool in your agent's toolkit, giving you access to X Ads data alongside dozens of other services without needing complex API calls.
019d84a0-339a-734f-96b5-b9abcf625c14 How to set up X Ads (Twitter) MCP
The bottom line is that you treat the entire X Ads platform like a single source of truth within your chat window.
Subscribe to this MCP on Vinkius, then input your X Developer Portal credentials (API Key, Secret, Token) into your AI client.
Your agent uses the provided authentication to connect and audit the live ad accounts, ensuring all data requests are signed with OAuth 1.0a.
You prompt your AI client in natural language—for example, 'What was our engagement metric for Q2?'—and receive an immediate, structured report.
Who uses X Ads (Twitter) MCP
This MCP is for performance marketing specialists and ad operations teams who are tired of switching between dashboards, exporting CSVs, and manually correlating campaign data. If you spend hours every week pulling metrics just to answer 'how did we do?', this tool saves your time.
Runs detailed reports comparing line item performance across multiple campaigns, identifying which audiences need budget reallocation.
Verifies campaign configurations and checks the status of promoted tweets or ad accounts to ensure everything is running correctly before a launch date.
Audits multiple client accounts from one interface, pulling summaries of spend and engagement without ever leaving their primary workflow tool.
Benefits of connecting X Ads (Twitter) MCP
Stop leaving the ads manager. You can now pull complex reports, like comparing line item performance across different campaigns using get_analytics, all from your chat interface.
Instantly audit account health. Use list_ad_accounts to see every account ID and status without needing manual logins or API calls.
Deep-dive into spending details. Check billing setup with list_funding_instruments before any major campaign launch to avoid payment delays.
Manage content inventory easily. Run list_promoted_tweets to verify exactly which tweets are running, and use list_media_creatives to check the asset library.
Compare targeting strategies. You can list all criteria using list_targeting_criteria, helping you decide if your retargeting efforts need adjusting.
X Ads (Twitter) MCP use cases
Reviewing Monthly ROI
An Account Manager needs to show a client their overall ad performance for the last quarter. They ask their agent: 'Give me the total web conversion and engagement metrics across all line items from January 1 to March 31.' The agent uses get_analytics and delivers a clear, comprehensive breakdown.
Debugging Campaign Failures
A marketer notices low CTR on one campaign. They ask their agent: 'What are the targeting criteria for line item XYZ?' The agent executes list_targeting_criteria, immediately showing if the audience settings were recently changed, solving the mystery fast.
Pre-Launch Checklist
An Ops Lead is launching a major campaign. They ask their agent to confirm everything: 'List all ad accounts, check funding instruments, and list promoted tweets.' The agent runs list_ad_accounts and list_funding_instruments, confirming readiness in seconds.
Auditing Creative Assets
A Growth Lead wants to see if the right creative is running. They ask: 'Which media creatives are active, and are there any promoted tweets we need to review?' The agent runs list_media_creatives followed by list_promoted_tweets, providing a complete content audit.
X Ads (Twitter) MCP tradeoffs
What to watch out for, and the recommended way to handle each one.
Assuming data is available
Asking the AI, 'Tell me about my campaign performance.' The agent will fail because it doesn't know which account or dates you mean.
Start by calling list_ad_accounts to get the ID. Then, use list_campaigns with that ID, and finally call get_analytics specifying the exact metric group and date range.
Confusing line items and campaigns
Asking for performance metrics without knowing if you should be looking at a campaign level or a specific line item level.
Use list_campaigns to get the overview, then use list_line_items. When pulling data, always specify which context (Campaign ID or Line Item ID) you want get_analytics to run against.
Skipping credential verification
Telling your agent to audit accounts without first verifying the account ID is active.
Always use get_ad_account first. This confirms the account metadata and makes sure subsequent calls, like those for list_campaigns, will succeed.
When to use X Ads (Twitter) MCP
Use this MCP if your job involves cross-referencing ad data points—for example, linking a low CTR (from get_analytics) to an outdated creative asset (checked via list_media_creatives) running under a specific line item (reviewed using list_line_items). It's best for deep audits and performance analysis.
Don't use this if you just need basic, non-ad related information, like checking your personal email or accessing general HR documents. For those tasks, stick to dedicated communication or document management tools. If your goal is simple reporting without needing specific metrics (like just listing account names), a simpler catalog tool might suffice, but if the data lives in X Ads, this MCP is necessary.
Frequently asked questions about X Ads (Twitter) MCP
How do I use X Ads (Twitter) MCP to check my accounts? +
You start by calling list_ad_accounts. This tool returns all accessible account IDs and their current statuses, letting you pick the right ID for deeper analysis.
Can I compare different ad audiences with X Ads (Twitter) MCP? +
Yes. You can use list_tailored_audiences to see what custom lists are available for retargeting, which is crucial before running a campaign.
What metrics does get_analytics support in X Ads (Twitter) MCP? +
The analytics tool supports five core metric groups: Engagement, Billing, Video, Web Conversion, and Mobile Conversion. You specify which group you need when making the request.
Does the X Ads (Twitter) MCP help me find my ad creative? +
Yes. You can use list_media_creatives to list all images and videos, or run list_promoted_tweets to see exactly which tweets are currently running.
Is X Ads (Twitter) MCP secure? +
Yes. The system signs every request with OAuth 1.0a at runtime, and your credentials remain encrypted at rest; they never get exposed to the agent or visible in logs.