# X Ads (Twitter) MCP for AI Agents AI Agent Connect > X Ads (Twitter) lets you connect your X Ads account to any AI agent. You can audit campaigns, analyze line item performance, and pull engagement reports through natural conversation. It handles the heavy lifting of navigating the X Ads dashboard so you can focus on strategy instead of clicking through tabs. Use it to verify funding, check targeting, and get real-time metrics without the manual effort. ## Overview - **Category:** industry-titans - **Price:** Free - **Endpoint:** https://edge.vinkius.com/undefined/ai-agent-connect - **Tags:** ad-campaigns, performance-analytics, marketing-audit, real-time-bidding, social-advertising, roi-tracking ## Description X Ads (Twitter) lets you connect your advertising account to your AI agent so you can manage your entire marketing operation through natural conversation. If you're tired of jumping between different tabs to check if a campaign is spending correctly or if a specific line item hit its target, this Connector handles the heavy lifting for you. You can ask your agent to audit your active ads, pull performance metrics for specific dates, or verify that your funding instruments are set up properly before a launch. It turns a manual process of hunting for data into a simple request for a summary. You'll find this Connector fits perfectly into the Vinkius catalog, giving your agent a direct line to the data it needs to help you make better decisions. Instead of copy-pasting numbers into a spreadsheet, you can just get the answers you need in seconds. It's built for anyone who wants to spend less time in the dashboard and more time on strategy. You can quickly see which promoted tweets are running, check your custom audience sizes for retargeting, and review the specific targeting criteria applied to your line items. This means you can spot underperforming assets or configuration errors in seconds rather than minutes. It's about moving from manual data entry to high-level oversight. ## Tools ### get_line_item Get the full details of a line item by its ID. This shows you the exact targeting and bidding for that segment. ### list_ad_accounts See every ad account tied to your profile. It gives you the account IDs you need for all other actions. ### list_campaigns Browse all campaigns within an account. You can quickly see names, budgets, and statuses in one list. ### list_funding_instruments Review your payment methods and billing sources. Use this to make sure your account is funded before you launch. ### list_media_creatives Audit the images and videos used in your account. It helps you track which assets are currently running. ### list_tailored_audiences View your custom audiences for retargeting. Use this to understand your CRM and lookalike matching. ### get_analytics Pull performance data like engagement or spend for specific dates. It helps you see how your ads are actually performing. ### get_campaign Fetch every detail for a specific campaign using its ID. Use this to see the full scope of a single marketing effort. ### list_line_items List all line items across your campaigns. This lets you see the different targeting groups you have active. ### list_promoted_tweets See which tweets are being promoted right now. This is great for verifying your live content. ### list_targeting_criteria See the specific targeting rules for a line item. This helps you double-check your reach and audience settings. ### get_ad_account Get the metadata for a specific account. Use this to verify an account is active before you start querying it. ### list_ads List all individual ads within an X Ads account. This shows the connection between your ads and your creatives. ## Prompt Examples **Prompt:** ``` Which of my campaigns had the best engagement last week? ``` **Response:** ``` Here is the engagement breakdown for your campaigns from last week: | Campaign | Impressions | Clicks | CTR | |---|---|---|---| | Summer Sale | 45,000 | 1,200 | 2.6% | | Brand Awareness | 120,000 | 800 | 0.6% | | Retargeting | 30,000 | 2,100 | 7.0% | The **Retargeting** campaign is your top performer in terms of CTR. ``` **Prompt:** ``` Are my promoted tweets running correctly? ``` **Response:** ``` I've checked your promoted tweets. Here is what's currently live: - "Get 20% off today" (Linked to Summer Sale) - "New feature alert" (Linked to Brand Awareness) - "Limited time offer" (Linked to Retargeting) All three are active and correctly linked to their respective campaigns. ``` **Prompt:** ``` Check my funding for the SaaS account. ``` **Response:** ``` I checked the funding instruments for your SaaS account. You have one active payment method: - **Visa ending in 4242** (Active) Your account is ready to spend. ``` ## Capabilities ### Audit campaign statuses Check if your ads are active, paused, or in draft mode instantly. ### Pull performance metrics Get engagement, spend, and conversion data for any period. ### Inspect line item targeting Review bidding strategies and delivery status for specific ads. ### Verify billing sources Check your funding instruments to ensure your account is ready to spend. ### Review promoted tweets See exactly which pieces of content are currently being pushed. ### Analyze custom audiences Look at your custom audiences for retargeting and CRM matching. ## Use Cases ### Weekly Performance Review A growth lead asks for a table of engagement metrics for all line items from last week. The agent uses `get_analytics` to pull the data and formats it into a clear comparison table. ### Campaign Audit An ad ops person wants to check if all promoted tweets are correctly linked to the right campaigns. The agent uses `list_promoted_tweets` to verify the content and its campaign associations. ### Budget Reallocation A marketer compares line item performance across three campaigns to see where to move spend. The agent uses `list_line_items` and `get_analytics` to find the best opportunities. ### Account Onboarding An agency lead lists all ad accounts to verify which ones have active funding instruments. The agent uses `list_ad_accounts` and `list_funding_instruments` to confirm the status of every client. ## Benefits - Stop manual reporting by using `get_analytics` to pull spend and conversion data for any custom date range. - Verify your live content faster by using `list_promoted_tweets` to see exactly what's running on your account. - Audit targeting rules across multiple campaigns using `list_line_items` and `list_targeting_criteria` to ensure reach. - Manage billing more efficiently by checking funding sources with `list_funding_instruments` before launching new ads. - Analyze your retargeting strategy by pulling your custom audience lists with `list_tailored_audiences`. - Get a high-level view of your entire portfolio by using `list_ad_accounts` to see every account in one list. ## How It Works The bottom line is you get a conversational interface for your entire X Ads account without leaving your favorite AI client. 1. Subscribe to the X Ads (Twitter) MCP on Vinkius. 2. Enter your API Key, API Secret, Access Token, and Access Token Secret from the X Developer Portal. 3. Start auditing campaigns and pulling reports from Claude, Cursor, or any MCP-compatible client. ## Frequently Asked Questions **Can X Ads (Twitter) MCP help me with reporting?** Yes, it lets you pull engagement, spend, and conversion data for any campaign or line item. You can specify custom date ranges to get exactly the report you need without manual exports. **How do I use X Ads (Twitter) MCP to check my budget?** You can ask your agent to check your funding instruments. It will look at the payment methods and billing sources attached to your account to confirm you're ready to spend. **Can X Ads (Twitter) MCP audit my targeting?** Yes, it can list the targeting criteria for any specific line item. This helps you verify that your ads are reaching the right audience and that your bidding strategy is correct. **Does X Ads (Twitter) MCP support custom date ranges?** It does. You can ask for performance metrics for any specific period, and the Connector will pull the data for those exact dates so you can see trends over time. **Can I manage multiple accounts with X Ads (Twitter) MCP?** Yes, it can list all ad accounts tied to your profile. This makes it easy to audit multiple clients or internal accounts from one place. **How does X Ads (Twitter) MCP handle my credentials?** Your credentials are encrypted at rest and are only used to sign requests at runtime. It uses OAuth 1.0a for secure access to your X Ads data. **Where do I find the four credentials I need?** In the [X Developer Portal](https://developer.x.com/), open your App under your Project. Under **Keys and Tokens**, you will find the **API Key** (Consumer Key) and **API Key Secret** (Consumer Secret). Below that, generate your **Access Token** and **Access Token Secret**. All four are required because the X Ads API uses OAuth 1.0a request signing. **Do I need Ads API approval from X?** Yes. The X Ads API is access-gated. You need to apply through the [X Developer Portal](https://developer.x.com/) and receive explicit approval before your credentials will work with Ads endpoints. Standard developer accounts only have access to the general X API. **Can I pull analytics for a specific date range?** Yes. The analytics tool accepts start and end dates in ISO 8601 format along with metric groups such as Engagement, Billing, or Video. Just ask your agent something like 'show me engagement metrics for campaign X from June 1 to June 15' and it will build the right query.