How to Use the X Ads (Twitter) MCP in Cursor

Q: How do I get ad account details using X Ads (Twitter) and Cursor?

Just prompt the agent to call getadaccount. The AI will execute the tool, receive the real data payload, and let you work with it immediately in your code block.

Q: What specific metrics can I pull for X Ads (Twitter) using Cursor?

You use getanalytics to get performance metrics. This covers spending totals, impressions, and click counts across the ad entities you specify in your query.

Q: Can I list promoted tweets using X Ads (Twitter) in Cursor?

Yes, the listpromotedtweets tool lets you pull a record of all active or past promoted tweets associated with an ad account ID.

Write code that interacts with X Ads (Twitter) using Cursor's live context.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect X Ads (Twitter) MCP to Cursor

Create your Vinkius account to connect X Ads (Twitter) to Cursor and route execution through our secure gateway. The platform manages server hosting, runtime updates, and security layers. Configuration requires no manual server provisioning.

GDPR Free for Subscribers

Setup X Ads (Twitter) with Cursor

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Live data injection for ad accounts in Cursor

Writing code that needs current ad account info is tough. With the MCP Server, you just call `get_ad_account` and get a real JSON response. The AI agent then injects that live data directly into your file. You don't have to copy-paste mock variables anymore. Your generated Python or JavaScript code uses actual ad account IDs.

Scripting campaign listings with Cursor

Need a loop that iterates through all campaigns? Use `list_campaigns` and let the AI handle the structure. The agent mode calls this tool, gets the list, and builds out the surrounding code for you. This makes complex data gathering—like listing campaign IDs—a single prompt away from working code.

Auditing ad assets using MCP Server

When building an audit tool, you'll hit multiple endpoints. Start with `list_ads` to get the initial list of ads. Then, if a record is missing data, call `get_analytics` for that specific ID in your script. This process creates a dynamic, multi-step workflow entirely within your editor.

Setup guide

Set up X Ads (Twitter) MCP in Cursor

Prerequisites

Cursor installed (macOS, Windows, or Linux)
Active Vinkius subscription with a valid endpoint token

1

Open MCP Settings

Go to Cursor Settings → MCP or open the Command Palette (Cmd+Shift+P / Ctrl+Shift+P) and search for "MCP: Add Server".
2

Add the X Ads (Twitter) MCP

Cursor will create or open .cursor/mcp.json in your project root. Paste the JSON snippet on the right. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Enable Agent mode

Open Composer (Cmd+I / Ctrl+I) and switch to Agent mode using the dropdown at the top. MCP tools are only available in Agent mode.
4

Verify the connection

Ask Cursor something like "List my recent X Ads (Twitter) transactions." If the MCP tools are loaded correctly, Cursor will call the X Ads (Twitter) tools automatically. You can also check Settings → MCP for a green status indicator.

.cursor/mcp.json

{
  "mcpServers": {
    "x-ads-twitter-mcp": {
      "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    }
  }
}

Get your connection token →

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.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect X Ads (Twitter) now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about X Ads (Twitter) MCP in Cursor

Just prompt the agent to call `get_ad_account`. The AI will execute the tool, receive the real data payload, and let you work with it immediately in your code block.

You use `get_analytics` to get performance metrics. This covers spending totals, impressions, and click counts across the ad entities you specify in your query.

Absolutely. Since the agent mode calls tools with live API responses, it handles complex, multi-step data gathering required for enterprise projects.

The server touches ad account details, line item structures (`list_line_items`), and campaign metadata. You're working with Ad Account IDs and Campaign Names.

Yes, the `list_promoted_tweets` tool lets you pull a record of all active or past promoted tweets associated with an ad account ID.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python