X Ads connector for Claude

Use Porter’s X Ads connector for Claude (formerly Twitter Ads) to rank promoted posts by cost per engagement, pace budgets and build campaigns after you approve.

  • Rank promoted posts by cost per engagement
  • Compare campaigns by objective, each on its own cost
  • Pace budgets and pause ad groups that have gone stale
  • Compare X and LinkedIn Ads costs for B2B
Connect X Ads to Claude free See the 3 steps
G2★★★★★Rated 4.6/5 from 288 Porter Metrics reviews on G2 (October 2026)

By Porter Metrics team · Last updated October 19, 2026

ClaudePorter connected
Show Spend, Impressions, Link clicks and Engagements by Campaign name for the last 7 full days, with CPM and CPE.
Porter / X Ads / Trailgear Demo✓ 4 rows
Promoted – Launch Thread has the lowest cost per engagement at $0.21. Website – Retargeting drives the most link clicks.
Campaign nameSpendLink clicksCPE
Promoted – Launch Thread$420310$0.21
Website – Retargeting$5601,040$0.48
Followers – Brand$30095$0.62
Video – Product$380180$0.55
Demo data, Trailgear Demo account
Watch the setupConnect X Ads to Claude, fast and easyPorter Metrics on YouTube
330 X Ads fields
01Setup

How to connect X Ads to Claude

Porter’s X Ads connector for Claude takes 3 steps, with no code or X developer app. Connect your ad accounts in Porter, add one MCP URL to Claude as a custom connector and ask. The step-by-step X Ads tutorial with screenshots covers Claude Code. MCP (Model Context Protocol) is the open standard Claude uses to connect to tools.

What you need first

  • An X login with access to the ad account in X Ads Manager, as well as a free Porter account and any Claude plan. Agencies, however, sign in with the @username an advertiser gave access to in business.x.com.
  • Custom connectors work in Claude, Cowork and Claude Desktop on Free, Pro, Max, Team and Enterprise plans, but Free allows one (Anthropic’s guide to custom connectors). Porter’s tutorial also covers Claude Code.
  • Works in Claude.ai, Claude Desktop, Cowork and Claude Code, with any Claude model, from Opus to Sonnet and Haiku.

  1. Step 1: Connect X Ads in Porter

    Sign up free at Porter, pick X Ads as the source and then sign in with X. Pick the ad accounts Claude should read, then pick Claude as the destination.

  2. Step 2: Add the X Ads connector to Claude

    Then, in Claude, open Customize > Connectors, click “+ Add”, choose “Add custom connector”, name it Porter Metrics, paste this URL and click Add:

    MCP URL
    https://mcp.portermetrics.com/mcp

  3. Step 3: Ask Claude about X Ads

    Finally, sign in with your Porter account to authorize Claude, then paste this first prompt:

    Prompt
    List my X Ads ad accounts and show Spend, Impressions, Link clicks and Engagements by Campaign name for the last 7 full days. Calculate CPM and CPE yourself.

Guides and videos

app.portermetrics.com / create
Porter's Select accounts window for X Ads with a demo account and the Connect button
First, in Porter, open X Ads and select Connect.
X sign-in screen you see when you connect X Ads to Porter
Then, sign in to X and authorize Porter Metrics.
Claude's Add custom connector window with the name Porter Metrics and Porter's MCP URL filled in
Then, in Claude, add a custom connector with Porter's MCP URL.
Porter's Application Access Request screen asking you to let Claude use the Porter MCP server
When Claude asks, sign in to Porter and select Allow Access.
Porter Metrics listed as a connected connector in Claude with its read-only tools
After that, Porter shows as connected, so you can ask your first question.
If you prefer video, watch the whole X Ads to Claude setup (1:29, no sound).
Interactive walkthrough, so you can click along here
02Use cases and prompts

What you can ask Claude

Here are 8 things to try, from a campaign performance audit to a campaign built from a brief. Each use case comes with a prompt to copy, the fields it uses from the X Ads fields list and who it’s for. The prompts work out CPE and CPM from raw counts, so totals stay right.

Can Claude find the promoted posts that earn engagements cheapest?

The problemA post that did well organically can flop once you pay to promote it, so it’s hard to know which messages deserve budget.

What Claude doesClaude ranks promoted posts by CPE and engagement rate, next to each post’s text. Then you see which messages get people to interact and which only collect impressions.

What you getYou know which messages to back next, with post text and CPE in one table instead of an export.

Prompt
For the last 30 days, by Campaign name, Ad Group name, Promoted Tweet id and Tweet text, show Spend, Impressions, Engagements, Billed Engagements and Link clicks. Calculate CPE (Spend ÷ Engagements), engagement rate (Engagements ÷ Impressions) and link click rate. Rank the 15 posts with the most Spend by CPE and flag posts above 5,000 Impressions with engagement rate under 1%.

For: in-house paid social managers · agencies · B2B marketers

Fields used: Campaign nameAd Group namePromoted Tweet idTweet textSpendImpressionsEngagementsBilled EngagementsLink clicks

Can Claude compare campaigns by objective, including followers campaigns?

The problemYou run awareness, engagement and follower campaigns side by side, but each is bought on a different cost, so nothing lines up.

What Claude doesClaude groups campaigns by objective, then works out the cost each one is bought on. That’s CPM for awareness, CPE for engagements, cost per link click for website clicks and cost per follower for followers.

What you getEach objective gets judged on its own cost, so you can decide which ones keep their budget.

Prompt
For the last 30 days, by Objective and Campaign name, show Spend, Impressions, Clicks, Link clicks, Engagements and Follows. Calculate CPM, cost per link click, CPE and cost per follower for each campaign and for each objective, and tell me which objective gives the cheapest result for what it's bought on.

For: in-house paid social managers · agencies · brand marketers

Fields used: ObjectiveCampaign nameSpendImpressionsClicksLink clicksEngagementsFollows

Can Claude show which X video ads get watched and what each view costs?

The problemYour videos rack up views in a fast-scrolling feed, but you can’t tell if anyone really watched.

What Claude doesClaude ranks video posts by video views, 3-second full-screen views and 6-second views per impression, then works out cost per view. Since X changed how it counts video views in August 2026, a view means 100% in view for 3 seconds or a click to play.

What you getYou see which videos hold attention for the money before you brief the next batch.

Prompt
For the last 30 days, by Promoted Tweet id and Tweet text, show Spend, Impressions, Video starts, Video views, 3s/100% video views and 6s video views. Calculate cost per video view, 3s/100% view rate and 6s view rate (each ÷ Impressions), and rank the 10 video posts with the most Spend.

For: brand and video marketers · agencies

Fields used: Promoted Tweet idTweet textSpendImpressionsVideo startsVideo views3s/100% video views6s video views

Can Claude tell you which ages, genders and platforms your X ads reach best?

The problemNobody on the team knows who on X engages with your ads, or whether they’re on the app or desktop.

What Claude doesClaude splits spend, impressions, engagements and link clicks by one audience dimension per question, then flags segments that spend without engaging.

What you getYou can move spend toward the ages and platforms that engage, instead of reading three separate exports.

Prompt
For the last 30 days, show Age, Spend, Impressions, Engagements and Link clicks. Calculate CPE and cost per link click per age group and list age groups with more than $200 Spend and CPE at least 30% above the average of all age groups.
Then ask
Prompt
Run the same breakdown by Gender, then by Platform, as separate tables.

For: in-house paid social managers · agencies · B2B marketers

Fields used: AgeGenderPlatformSpendImpressionsEngagementsLink clicks

Can Claude pace campaign budgets and change them?

The problemA post tied to a live event or trending topic spends faster than planned, so the monthly budget runs out before the month does.

What Claude doesClaude reads daily spend by campaign plus each campaign’s daily and total budget, then projects month-end spend from the last 7 days. After that, it changes the campaign or ad group budget you pick.

What you getYou rein in a fast-spending campaign mid-month, while there’s still budget to move.

Prompt
This month, by Date and Campaign name, show Spend. Then, in a separate table, show Campaign name, Campaign daily budget and Campaign total budget. Using the last 7 days' average Spend, which campaigns will finish the month more than 10% over or 20% under their total budget, and by how much?
Then ask
Prompt
Lower the daily budget of the campaign most likely to overspend so it lands on budget. Show me the new amount before you change it.

For: agencies (add Account Name for one row per client) · in-house paid social managers

Fields used: DateCampaign nameSpendCampaign daily budgetCampaign total budgetAd Group total budget
Actions: campaign_update · lineitem_update (budgets in micros)

Can Claude spot tired X ad groups and pause them?

The problemThe X feed moves fast, so a promoted post goes stale quickly and CPE creeps up.

What Claude doesClaude pulls weekly spend, impressions, engagements and link clicks per ad group, then works out CPE, CPM and link click rate. It also flags ad groups whose CPE rose two weeks in a row and pauses the ones you choose.

What you getStale ad groups stop eating budget before their CPE drags up the campaign average.

Prompt
For the last 6 weeks, by Week, Campaign name and Ad Group name, show Spend, Impressions, Engagements and Link clicks. Calculate weekly CPE, CPM and link click rate, and flag ad groups where CPE rose and link click rate fell two weeks in a row.
Then ask
Prompt
Pause the flagged ad groups after I confirm, and list each one first.

For: in-house paid social managers · agencies

Fields used: WeekCampaign nameAd Group nameSpendImpressionsEngagementsLink clicks
Action: lineitem_update (status PAUSED)

Can Claude build a campaign from a brief?

The problemThe launch post is written, but setting up the campaign, ad group and promotion in X Ads Manager takes longer than writing it did.

What Claude doesClaude finds your funding instrument, creates the campaign with its budget, and then adds an ad group with objective, placements and bid. It also writes a Promoted-only post and promotes it in that ad group.

What you getYou review a finished setup instead of clicking through X Ads Manager for each part.

Prompt
Create a campaign 'Spring launch' with a $50 daily budget on my funding instrument, starting {date}. Add one ad group with the Website clicks objective, promoted posts, all placements on X and a $1.50 maximum bid. Write a Promoted-only post with the text '{copy} {URL}' and promote it in that ad group. Keep everything paused and show me each item before you create it.

For: agencies · in-house paid social managers

Actions: fundinginstrument_list · campaign_create · lineitem_create · tweet_create · promotedtweet_create · read-back campaign_list · lineitem_list · promotedtweet_list

Can Claude compare X and LinkedIn Ads for B2B?

The problemMost of your B2B budget sits on LinkedIn, but someone asks if X could reach the same buyers for less.

What Claude doesWith both platforms in Porter, Claude puts spend, impressions, clicks and link clicks side by side by platform and campaign. Then it works out CPC, CPM and cost per link click, so you see where the next B2B dollar goes further.

What you getOne cost table answers whether X deserves a share of the B2B budget.

Prompt
Compare my X Ads and LinkedIn Ads accounts for the last 30 days: ad spend, impressions, clicks and link clicks by platform and campaign name. Calculate CPC, CPM and cost per link click for each platform, and tell me which three campaigns should get more budget.

For: B2B marketers · agencies · marketing leads

Fields used: Blended Ad SpendBlended Ads impressionsBlended ClicksBlended Link ClicksBlended Campaign Name
03Why Porter

Why Porter for X Ads in Claude

Porter brings X Ads into Claude, Cowork and Claude Desktop on any plan, next to your other ad platforms under one set of field names. X’s official X Ads MCP also covers targeting, custom audiences, cards and media. Pick X’s MCP when an agent in Claude Code needs to change those.

✓

No developer app

Sign in with X in Porter and paste one URL in Claude. X’s own MCP first needs an X developer app with Ads API access, a callback and a Client ID.

⊞

Changes only after you approve

Claude lists each campaign, ad group, budget or post change and waits for your yes before Porter writes it. It also converts X’s budget micros for you.

⚙

330 ready-made fields

Claude gets named fields for engagements, link clicks, video views, followers, web conversions, budgets, UTM tags, age, gender and platform, then works out CPE and CPM from raw counts.

Aa

X next to LinkedIn and Meta

Ask about X Ads next to LinkedIn Ads, Meta Ads, Google Ads and GA4 in the same chat, so a budget split between platforms starts from one table.

↻

A sign-in that stays valid

Porter’s X access stays valid until you revoke it. A token from X’s MCP lasts about 2 hours before it has to refresh.

✓

A year of X Ads in one ask

X’s Ads API serves stats 7 days per call, or 90 days per async job. On paid plans Porter answers up to a year in one question, so Claude compares months without stitching exports.

⊞

One connection, every destination

One X ad account connected in Porter also feeds ChatGPT and Data Studio at no extra cost, so you don’t reconnect for each tool.

⚙

Live dashboards, not only chat answers

Ask Claude for a dashboard and Porter’s AI dashboards publish it at its own link, synced automatically and ready to share. Official MCP servers answer inside the chat and stop there.

04Dashboard

Dashboard template

Start from a ready-made X Ads template, or ask Claude to build a live one with AI dashboards.

AI dashboards

Build a live X Ads dashboard from the chat

Describe the dashboard in one sentence and Porter builds it. A client-ready dashboard in minutes, with no chart dragging and no BI tool to learn. Ask Claude:

Prompt
Build a live X Ads dashboard for my account with the last 30 days, the main KPIs and a weekly trend.
Live URLEach dashboard at its own link: no login, no app, no download
Auto-syncFresh X Ads data, nobody re-exports each period
Scheduled deliveryEmail or PDF sends on a set day
White labelYour logo and branding for clients
Sharing permissionsView or edit access per person

Or start from a template

→X Ads dashboard templates ↗Ready-made layouts for X AdsDashboard templates for every source ↗Ads, social, SEO, ecommerce and CRMPorter's template gallery ↗Every Porter template in one place
05Pricing

Pricing

You can start free, since Porter’s X Ads connector for Claude comes with every plan. Use the calculator for your number of accounts, or see Porter pricing for every plan.

What you get

  • Free plan: never expires, with unlimited connected accounts and the last 15 days of data in Claude (30 days in Data Studio and Sheets)
  • Reporting: from $12.50 per account a month billed annually, or $15 month to month for one account
  • Billing: each connected X ad account counts as one account, with volume discounts and no per-seat fee
  • Changes: 1 AI credit per completed change; failed tasks are free, and the Free plan includes 100 credits a month
  • Trial: 14 days of full access, no card

See full pricing and plans

Price calculator

$33.33/mo$6.67 per account

An account is one ad account, Stripe account, store, page or GA4 property. The Free plan never expires and has unlimited accounts, with the last 15 days of data in AI chats.

Start free
06Data and actions

X Ads data Claude can use

The X Ads connector gives Claude 330 fields: campaigns, ad groups, promoted posts, spend, delivery, engagements, followers, video, conversions, budgets, UTM tags and audience breakdowns. It also adds 18 actions to read, create, change and delete. The full X Ads field reference has the rest, while Claude works out CPE, CPM, CTR and engagement rate from raw counts.

The 12 X Ads fields Claude uses most

Most questions need only these 12.

FieldWhat it's for
Date · Weektwitter_ads_date · twitter_ads_weekDaily trends and weekly fatigue checks
Account Nametwitter_ads_account_nameOne row per ad account or client
Campaign name · Ad Group nametwitter_ads_campaign_name · twitter_ads_ad_group_nameRankings by campaign or ad group
Objectivetwitter_ads_objectiveComparing campaigns bought on the same result
Promoted Tweet id · Tweet texttwitter_ads_promoted_tweet_id · twitter_ads_tweet_textPost-level rankings with the copy
Spendtwitter_ads_spendEvery cost Claude calculates: CPM, CPE, CPC
Impressionstwitter_ads_impressionsCPM and every rate
Clicks · Link clickstwitter_ads_clicks · twitter_ads_link_clicksCTR and cost per link click
Engagements · Billed Engagementstwitter_ads_engagements · twitter_ads_billed_engagementsCPE and engagement rate
Followstwitter_ads_followsCost per follower (check against X Ads Manager)
Video views · 3s/100% video views · 6s video viewstwitter_ads_video_views · twitter_ads_video_3s100pct_views · twitter_ads_video_6s_viewsCost per view and view rates
Age · Gender · Platformtwitter_ads_age · twitter_ads_gender · twitter_ads_platformsAudience splits, one per question

Can Claude create, pause or change X Ads campaigns?

Yes. Claude creates campaigns with budgets and dates, as well as ad groups with objective, product type, placements, bid and budget.

It also creates Promoted-only posts from text, or from media and cards already in your X account. Then it promotes a post in an ad group or removes it. In addition, it pauses or resumes campaigns and ad groups, changes names, budgets, bids and end dates, and deletes campaigns and ad groups.

Media uploads, cards, custom audiences, targeting and promotion edits stay in X Ads Manager, where you handle them as usual.

How fresh is the data, and how far back?

Totals reach Claude in near real time. Most metrics are final after 24 hours, per X's notes on when ad metrics are final. Spend, however, can stay an estimate for up to 3 days. Age, gender and platform splits can also lag up to an hour.

Ask for a year or less per question. Paid Porter plans have no history cap, while the free plan reads 15 days in AI chats (30 days in Data Studio and Sheets).

Product stats

WhatX Ads connector
Fields330 across campaigns, ad groups, promoted posts, delivery, engagements, video, conversions, budgets and audience splits
Actions18 to read, create, change and delete; media, cards, custom audiences and targeting stay in X Ads Manager
FreshnessNear real time; most metrics final after 24 hours, spend can stay an estimate for up to 3 days
HistoryNo cap on paid plans, a year or less per question; 30 days on the Free plan, 15 in AI chats
Rate limits250 analytics requests per 15 minutes per user, set by X
BreakdownsAge, gender or platform, one per question
AccessX's own sign-in; valid until you revoke it

See all 330 X Ads fields

07Security

Is it safe?

Yes, with approvals: the X Ads connector for Claude shows every change before Porter sends it, so nothing changes until you confirm. Deletes and removed promotions are permanent, so pausing is the safer fix. Porter signs in with X's own OAuth, so it only gets the access your X user already has on the ad account.

How approvals work

Claude lists each campaign, ad group, budget or post change, then waits for your yes before Porter writes it. Budgets and bids travel in X's micros (1,000,000 per currency unit), and Claude converts them for you.

Deleting a campaign, ad group or promotion is permanent, so pause when you might want it back. A live promotion stays as you approved it, so review it first. Each completed change also uses 1 AI credit.

What the connector needs from X Ads

When you connect, use an X user with access to the ad account. Agencies can also work through access an advertiser grants their @username, as X's guide to ad account access explains.

X access tokens stay valid until you or the account admin revoke the app (X's OAuth FAQ on access tokens). If an account shows no data, reconnect X Ads in Porter.

08FAQ

FAQ

Before they connect, X Ads buyers usually ask about ChatGPT and Claude Code and agency accounts. They also ask about website conversions, Data Studio (formerly Looker Studio) and the API version. The last three answers fix numbers that don't match Ads Manager, missing accounts and failed questions.

Does Porter work in ChatGPT and Claude Code too?

Yes. The MCP URL behind the X Ads connector for Claude also works in ChatGPT and Claude Code. Then you can ask about the same X campaigns in either. If you use ChatGPT, follow the guide to connect X Ads to ChatGPT. Porter's X Ads tutorial for Claude also covers Claude Code.

Can I connect several X ad accounts, like an agency?

Yes. One X login brings in every ad account that user can reach, including advertisers who gave your @username access. If you add Account Name as a column, Claude compares them in one answer. Porter bills each ad account once it's connected.

Can Claude report website conversions and purchases?

Yes. Claude gets purchases, sign ups, site visits, downloads and custom conversions, split by post view and post engagement, including sale amount. Conversions come from the X Pixel or Conversion API events on your site (X's web conversions docs).

I already use Porter for Data Studio. Do I need to reconnect?

No. One X ad account connected in Porter feeds every Porter destination, including Claude, at no extra cost. If your reports already run through Porter's X Ads connector for Data Studio, just add the MCP URL to Claude and ask.

Does Porter use X's official Ads API?

Yes. Porter reads and writes through version 12 of X's Ads API (X Ads API versions) and signs in with X's own login. X's official MCP uses the same Ads API, so both see the same data.

Troubleshooting

Why don't Claude's X Ads numbers match X Ads Manager?

Compare the same dates in the ad account's time zone and check the last day, and Claude's X Ads numbers through Porter should line up with Ads Manager. X's API treats the end date as exclusive, while Ads Manager includes it. Ads Manager also adds Spotlight and Trend placements, recent spend is still an estimate, and breakdowns don't add up to totals.

Why does Claude return no data for one X ad account?

Reconnect the X ad account in Porter with X sign-in, then ask Claude again. Claude returns no data for an account added to Porter without signing in with X, or when its access was revoked, even though it shows as connected. A re-authorized account can also show up twice with the same data.

Why did an X Ads question fail in Claude?

Ask for raw counts and let Claude work out the rates, ask one breakdown per question, keep ranges to a year or less and use Week instead of Month and year. Leave out reach and frequency too. An X Ads question fails when it asks for a field or shape outside what the connector returns.

09Next

More Claude connectors

Porter brings more than X Ads into Claude, and also sends X Ads to more places than Claude. Browse all Claude connectors for another ad platform, or pick free Data Studio dashboard templates or a warehouse or spreadsheet route for your X data. Each page also lists that connection's setup and data.

→Meta Ads connector for Claude→Google Ads connector for Claude→Google Analytics 4 connector for Claude→TikTok Ads connector for Claude→LinkedIn Ads connector for Claude

Not only Claude. Send X Ads data anywhere

The same Porter account and connection also send X Ads data to these destinations, at no extra cost.

→X Ads to ChatGPT→X Ads to Data Studio→X Ads to Google Sheets→X Ads to BigQuery→X Ads connector for any AI tool (MCP)
Free Twitter Ads dashboard templatesImport Twitter Ads to Google Sheets

Try it on your own account

To try the X Ads connector for Claude, connect your account, add one URL and ask. For example, start with your cheapest promoted posts, the campaigns heading for overspend or the ad groups that have gone stale. Then act on the answer in the same chat.

Connect X Ads to Claude free

Free plan · 14-day trial · No card

Paid social managers: CPE, CPM and pacing for every campaign in one chat, and the pause or budget change made right there.

B2B marketers: X and LinkedIn costs side by side, so the next budget split has numbers behind it.

Agencies: one prompt covers every advertiser that granted your @username access.

About the author: Porter Metrics team. The team builds Porter's marketing data connectors and recorded the X Ads setup short on this page.Last updated October 19, 2026

Automate marketing reporting and analysis with AI like it's 2026.

LinkedIn YouTube TikTok
G2 Momentum Leader Badge - Porter Metrics rated 4.6 out of 5 stars G2 Best Estimated ROI Badge - Porter Metrics G2 Best Relationship Badge - Porter Metrics

Destinations

Data Warehouse

Reporting

Alerts & Notifications

  • Slack iconSlack
  • Zapier iconZapier

Chat

  • Claude AI iconClaude
  • Google Gemini iconGemini
  • ChatGPT iconChatGPT

Connectors

Templates

Resources

© 2026 Porter Metrics. All rights reserved.