twitter-ads-mcp
MCP server to connect AI with X (Twitter) Ads
Documentation
Twitter Ads MCP by Two Minute Reports
Ask questions about your Twitter Ads performance in plain English โ no X Ads Manager exports needed.
Twitter (X) Ads can drive real results for brand awareness, website traffic, and app installs โ but understanding what's working means navigating a reporting interface that's never been the most intuitive. This MCP server puts your Twitter Ads data one question away.
> _"Which Twitter campaigns had the highest engagement rate last month?"_
>
> _"What is my average cost per click across all active campaigns this quarter?"_
>
> _"Compare my Twitter Ads impressions and spend this month vs last month."_
๐ฌ See It in Action
https://github.com/user-attachments/assets/096063ba-60b4-45cd-af8f-02bbf36c5704
> ๐ฅ _Can't see the video? Watch on YouTube โ_
Why Use This
X Ads Manager is powerful, but its reporting interface has never been the most intuitive, and getting the specific numbers you need means too many clicks and exports. This MCP server cuts through all of that.
What you get:
- Instant Twitter Ads analytics โ ask about impressions, engagement rates, CPC, and conversions without navigating X Ads Manager.
- No setup complexity โ no Twitter Ads API developer credentials or elevated access required; connect through Two Minute Reports in minutes.
- Multi-account support โ analyze multiple Twitter ad accounts from a single conversation.
- Cross-platform context โ combine with 22+ other sources like LinkedIn Ads, Google Analytics 4, and Facebook Ads to benchmark Twitter performance across your full paid media mix.
๐ Learn more about the Twitter Ads connector โ
Quick Start
Prerequisites
- A Two Minute Reports account (trial or paid) with your Twitter Ads account connected. Don't have one? Sign up free โ
- An AI client that supports MCP (e.g., Claude Pro/Team, ChatGPT Plus, or any MCP-compatible app).
Connection Guides
| AI Client | Guide |
|---|---|
| Claude.ai | How to connect on Claude โ |
| ChatGPT | How to connect on ChatGPT โ |
MCP Server URL (you'll need this during setup):
https://mcp.twominutereports.com/mcpWhat You Can Ask
Campaign Performance
Which Twitter campaigns had the highest engagement rate last month?Show me campaigns with impressions over 100,000 but low click-through rates this quarter.Cost & Efficiency
What is my average cost per click across all campaigns this month?Compare my cost per engagement this quarter vs last quarter.Creative Analysis
Which promoted tweets had the highest engagement rate in the last 30 days?How do video ads perform vs image ads by click-through rate this month?Audience Performance
Which audience targeting options drive the lowest CPC this quarter?How does my keyword targeting perform vs interest targeting by cost per engagement?Conversion Tracking
How many website conversions did my Twitter campaigns drive last month?Which campaigns had the highest conversion rate this quarter?Spend & Budget
How much did I spend on Twitter Ads last month?Which campaigns are pacing over budget this week?TMR Twitter Ads MCP vs. Self-Hosted Alternatives
| Feature | TMR Twitter Ads MCP | Self-Hosted |
|---|---|---|
| Twitter Ads API access | โ Handled by TMR | โ Requires Twitter developer elevated access |
| OAuth authentication | โ Secure, one-click | โ Manual token and permission management |
| Multi-account support | โ All ad accounts | โ ๏ธ Per-account configuration |
| AI client compatibility | โ Claude ยท ChatGPT | โ ๏ธ Varies by implementation |
| Natural language queries | โ Ask anything | โ Must write API queries manually |
| Maintenance & updates | โ Managed by TMR | โ Self-maintained |
| Cross-source reporting | โ 22+ connectors | โ Twitter data only |
Who This Is For
- Brand marketers running Twitter Ads for awareness, engagement, and follower growth who want fast performance answers.
- Performance marketers tracking website conversions and app installs from Twitter campaigns.
- B2B marketing teams using Twitter to reach professional and tech-savvy audiences alongside LinkedIn Ads.
- Media and publishing brands promoting content via Twitter who need click and engagement data quickly.
- Agencies managing Twitter Ads for multiple clients who need fast, consolidated reporting.
Security & Privacy
- OAuth 2.0 authentication โ sign in securely with your Google account.
- No data stored by the MCP server โ data flows directly from your sources through TMR to your AI assistant.
๐ Privacy Policy ยท ๐ Data Security ยท ๐ Terms of Service
Support
๐ง support@twominutereports.com ยท ๐ซ Submit a ticket
About Two Minute Reports
Two Minute Reports is a marketing data platform that connects 22+ data sources to Google Sheets, Looker Studio, and AI assistants. Built for agencies, marketers, and ecommerce brands.
๐ twominutereports.com ยท ๐ MCP Server
The conversation is happening on X โ make sure your ads are keeping up. ๐ฆ
Frequently asked questions
What is twitter-ads-mcp?
twitter-ads-mcp is MCP server to connect AI with X (Twitter) Ads
How do I install twitter-ads-mcp?
Open the GitHub repository and follow its README. Most MCP servers are added to your client's MCP config, then called by your agent.
Is twitter-ads-mcp open source?
Yes โ it is hosted on GitHub at https://github.com/twominutereports/twitter-ads-mcp.
Related MCP tools
Model Context Protocol Servers
Pre-indexed code knowledge graph, auto syncs on code changes, for Claude Code, Codex, Gemini, Cursor, OpenCode, AntiGravity, Kiro, CoPilot, and Hermes Agent โ fewer tokens, fewer tool calls, 100% local
an open source, extensible AI agent that goes beyond code suggestions - install, execute, edit, and test with any LLM
The easy-to-use open source Business Intelligence and Embedded Analytics tool that lets everyone work with data :bar_chart:
The Open-Source Multimodal AI Agent Stack: Connecting Cutting-Edge AI Models and Agent Infra
Cognee is the open-source AI memory platform for agents. Give your AI agents persistent long-term memory across sessions with a self-hosted knowledge graph engine.
Run your own MCP server? See who uses it and what to fix.
Measure it with TrackMCP