Download PDFMarkdown Version
ClaudeChatGPTPerplexityGeminiMicrosoft CopilotRaycastMeta AIGrokZ.aiQwenKimi
DeepSeekMistralCursorVS CodeWindsurfJetBrainsClineLovableVercel AI SDKLangChain

Use X Ads (Twitter) with your AI.

Connect your account once and let the AI you already use work with it, without building another integration. Connect your X Ads account to any AI agent. audit campaigns, analyze line item performance, and pull engagement reports through natural conversation.

Included with plan

Ask AI about this Connector

Developed, maintained, and hosted by Vinkius.

MCP VERIFIED · PRODUCTION READY · VINKIUS GUARANTEED

Waiting for input…

Works with modern AI clients that support MCP, including ChatGPT, Claude, Cursor, and more.

ChatGPTClaudeCursorPerplexityGeminiMicrosoft CopilotRaycastMeta AI

Complete set · 13 capabilities

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

    List ad accounts

    Returns account IDs, names, statuses, and approval states. The account ID returned here is required by all other capabilities. List all X (Twitter) Ads accounts accessible by the authenticated user

  2. 02

    List line items

    Line items define the targeting and bidding strategy within a campaign. List all line items across campaigns in an X Ads account

  3. 03

    List promoted tweets

    Use this to verify which tweets are actively being promoted. List all promoted tweets currently running or paused in an X Ads account

  4. 04

    List targeting criteria

    Requires both the account ID and line item ID. List all targeting criteria applied to a specific line item

Capability set02 / 04

05-07

3 capabilities in this set.

Part of 13 available through X Ads (Twitter).

  1. 05

    Get analytics

    Metric groups: ENGAGEMENT, BILLING, VIDEO, WEB_CONVERSION, MOBILE_CONVERSION. Dates must be ISO 8601 format (e.g., 2026-06-01T00:00:00Z). Pull performance analytics for campaigns, line items, or ads over a date range

  2. 06

    Get campaign

    Use list_campaigns first to find the campaign ID. Get full details for a specific campaign by its ID

  3. 07

    Get line item

    Use list_line_items first to find the line item ID. Get full details for a specific line item by its ID

Capability set03 / 04

08-10

3 capabilities in this set.

Part of 13 available through X Ads (Twitter).

  1. 08

    List campaigns

    Each campaign includes its name, status, funding instrument, daily budget, and total budget. Use list_ad_accounts first to get the account ID. List all campaigns within an X Ads account

  2. 09

    List funding instruments

    Useful for verifying billing is set up before launching campaigns. List payment methods and billing sources attached to an X Ads account

  3. 10

    List media creatives

    Use this to audit which creative assets are currently active. List all media creative assets (images and videos) used in an X Ads account

Capability set04 / 04

11-13

3 capabilities in this set.

Part of 13 available through X Ads (Twitter).

  1. 11

    List tailored audiences

    Useful for understanding retargeting strategy. List custom audiences (tailored audiences) for retargeting and CRM matching

  2. 12

    Get ad account

    Use this to verify an account is active before querying campaigns. Get detailed metadata for a specific X Ads account

  3. 13

    List ads

    Each ad references the line item it belongs to and the creative (tweet) it promotes. List all individual ads within an X Ads account

Observed, not estimated

867ms average. Fast in production.

X Ads (Twitter) is checked daily against the live service.

Daily averagePeak 1059ms
Aug 20Today
Fastest day
728ms
Slowest day
1059ms
14-day trend
Slowing+13%

Connect your client

One URL. Every client.

Activate the Connector, copy your link, and paste it into the client you already use. 13 capabilities arrive ready to run.

Preview access · not provider authentication

The vk_preview_* token belongs to Vinkius preview infrastructure. It lets Claude discover and display the capabilities of X Ads (Twitter), so you can see the experience inside your AI.

It does not authenticate your account with X Ads (Twitter). Actions requiring credentials or live account data may not run until you activate the Connector and authorize the service.

X Ads (Twitter) Connector

You're all set. Choose your MCP client and follow the setup instructions.

Connector linkhttps://edge.vinkius.com/vk_preview_AMJVyeGCfq0vPLBC1wmdUfiKMYbxtDJq5cZlKLun/mcp

Claude Desktop

Follow the steps below to connect in seconds.

  1. 1In Claude Desktop, open Settings → Connectors.
  2. 2Click “Add custom connector” and paste the connector link above as the remote MCP server URL.
  3. 3Click Add and start a new chat — X Ads (Twitter) capabilities are ready to use.
Configuration · claude_desktop_config.jsonCopy
{
  "mcpServers": {
    "x-ads-twitter-mcp": {
      "url": "https://edge.vinkius.com/vk_preview_AMJVyeGCfq0vPLBC1wmdUfiKMYbxtDJq5cZlKLun/mcp"
    }
  }
}
  • Claude
  • ChatGPT
  • Cursor
  • VS Code
  • Windsurf
  • Claude Code
  • JetBrains
  • Cline

Step-by-step instructions for each client are in the guide. How to connect

FAQ

Questions X Ads (Twitter) owners ask.

  • 01

    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.

  • 02

    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.

  • 03

    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.

Explore

More in Industry Titans

Suggestions