Skip to content
Vinkius

X Ads (Twitter) Connector for AI agents.

13 live capabilities

Audit X ad campaigns and pull performance reports instantly.

Live agent request X Ads (Twitter) / Connector

Waiting for input…

AI Agent

Why people use X Ads (Twitter)

X Ads (Twitter) for X Ad Campaign Audits

With this Connector, you can just ask your agent to summarize last week's spend or tell you which line items are underperforming. It pulls the data for you and presents it in a clean format. You get a clear view of your performance without ever having to leave your chat interface.

  • Claude
  • ChatGPT
  • Gemini
  • Cursor
  • Visual Studio Code
  • Windsurf

What Vinkius changes

You get a conversational interface for your entire X Ads account without leaving your favorite AI client.

Use it from Claude, ChatGPT, Cursor or another AI client you already have.

One account · 5,900+ Connectors

  1. Real-world use case 01

    Weekly Performance Review

    A growth lead asks for a table of engagement metrics for all line items from last week.

  2. Real-world use case 02

    Campaign Audit

    An ad ops person wants to check if all promoted tweets are correctly linked to the right campaigns.

  3. Real-world use case 03

    Budget Reallocation

    A marketer compares line item performance across three campaigns to see where to move spend.

Complete set · 13capabilities

The complete X Ads (Twitter) capability set.

These are the exact actions your AI can choose when you ask it to work with X Ads (Twitter).

Capability set01 / 04

01—04

4 capabilities in this set.

Part of 13 available through X Ads (Twitter).

  1. 01 Capability

    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.

  2. 02 Capability

    List ad accounts

    See every ad account tied to your profile. It gives you the account IDs you need for all other actions.

  3. 03 Capability

    List campaigns

    Browse all campaigns within an account. You can quickly see names, budgets, and statuses in one list.

  4. 04 Capability

    List funding instruments

    Review your payment methods and billing sources. Use this to make sure your account is funded before you launch.

Capability set02 / 04

05—07

3 capabilities in this set.

Part of 13 available through X Ads (Twitter).

  1. 05 Capability

    List media creatives

    Audit the images and videos used in your account. It helps you track which assets are currently running.

  2. 06 Capability

    List tailored audiences

    View your custom audiences for retargeting. Use this to understand your CRM and lookalike matching.

  3. 07 Capability

    Get analytics

    Pull performance data like engagement or spend for specific dates. It helps you see how your ads are actually performing.

Capability set03 / 04

08—10

3 capabilities in this set.

Part of 13 available through X Ads (Twitter).

  1. 08 Capability

    Get campaign

    Fetch every detail for a specific campaign using its ID. Use this to see the full scope of a single marketing effort.

  2. 09 Capability

    List line items

    List all line items across your campaigns. This lets you see the different targeting groups you have active.

  3. 10 Capability

    List promoted tweets

    See which tweets are being promoted right now. This is great for verifying your live content.

Capability set04 / 04

11—13

3 capabilities in this set.

Part of 13 available through X Ads (Twitter).

  1. 11 Capability

    List targeting criteria

    See the specific targeting rules for a line item. This helps you double-check your reach and audience settings.

  2. 12 Capability

    Get ad account

    Get the metadata for a specific account. Use this to verify an account is active before you start querying it.

  3. 13 Capability

    List ads

    List all individual ads within an X Ads account. This shows the connection between your ads and your creatives.

Set up in minutes

One URL. Then ask X Ads (Twitter) to work.

Claude and ChatGPT only need the Connector URL. Copy it once, add it in settings, and use X Ads (Twitter) from the conversation.

Choose your client

Live preview
Advanced clients IDE · CLI

Claude · Web + desktop

Official guide ↗

Connector URL · ready to paste

Streamable HTTP
https://edge.vinkius.com/vk_preview_AMJVyeGCfq0vPLBC1wmdUfiKMYbxtDJq5cZlKLun/mcp
  1. Step 01

    Open Connectors

    In Claude Web or Claude Desktop, open Settings and choose Connectors.

  2. Step 02

    Add the URL

    Choose Add custom connector, name it X Ads (Twitter), and paste the URL above.

  3. Step 03

    Turn it on in chat

    Select +, open Connectors, and enable X Ads (Twitter) for the conversation.

Where the request belongs

Work X Ads (Twitter) can move forward.

Built around the request

The performance marketer who spends their Sunday night manually copying spend data into a spreadsheet is the primary user here. It's for ad ops leads who need to verify campaign settings across ten different accounts without clicking through dozens of menus. If you're tired of hunting for line item details or checking funding status across different profiles, this is for you.

01

Performance Marketer

They use this to pull weekly spend and engagement summaries without having to open the Ads Manager manually.

02

Ad Ops Team Member

They use this to verify campaign configurations and promoted tweet statuses in seconds across multiple accounts.

03

Growth Lead

They use this to compare line item performance across campaigns to find where to reallocate budget quickly.

04

Agency Account Manager

They use this to audit multiple client accounts from a single AI interface to ensure everything is running smoothly.

Build the capability set

Add more capabilities.

Each Connector adds new actions and data without changing how you work.

Browse Connectors
Meta Ads logo
01 10 capabilities

Meta Ads

Equip your AI agent with direct access to Meta Ads. manage Facebook and Instagram campaigns, track ad performance, and optimize spend without opening Meta Ads Manager.

View Connector
Facebook Ads logo
02 12 capabilities

Facebook Ads

Manage your Facebook and Meta Ads via AI. list campaigns, track performance insights, and update ad status directly through your agent.

View Connector
Google Ads logo
03 8 capabilities

Google Ads

Equip your AI agent with direct access to Google Ads. manage search, display, and shopping campaigns, track conversions, and optimize ad spend without opening the Google Ads console.

View Connector
Moloco logo
04 10 capabilities

Moloco

Manage machine learning-powered advertising via Moloco. track campaigns and get analytics directly from your AI agent.

View Connector
AdButler logo
05 10 capabilities

AdButler

Serve and manage display ads, track impressions, and optimize ad zones across your digital properties with precision.

View Connector
Amazon Ads logo
06 8 capabilities

Amazon Ads

Advertising management. manage Sponsored Products, brands, and performance reports via AI.

View Connector

Bring your own AI

Change the model, client or framework. Keep X Ads (Twitter) connected.

  • Claude
  • ChatGPT
  • Gemini
  • Cursor
  • VS Code
  • Windsurf
  • ZCode
  • Cline
  • Zed
  • Continue
  • Kiro
  • Roo Code
  • Zencoder
  • Goose
  • Void
  • Augment Code
  • Amp
  • Qodo
  • Tabnine
  • Pieces
  • Sourcegraph Cody
  • JetBrains
  • Warp
  • Amazon Q
  • Antigravity
  • BoltAI
  • Raycast
  • Jan
  • LM Studio
  • AnythingLLM
  • Open WebUI
  • Msty
  • Cherry Studio
  • LibreChat
  • TypingMind
  • Chorus
  • 5ire
  • n8n
  • LangChain
  • LlamaIndex
  • CrewAI
  • Vercel AI SDK

Before you connect

Questions about X Ads (Twitter).

The practical details behind the request, access and result.

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, 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 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 capability 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.

One connection away

Give your agent a direct line to X Ads (Twitter).

Connect X Ads (Twitter) once. Keep it beside 5,900+ managed Connectors when the next task needs more.

Explore every Connector No credit card required · Free tier available