Free X Ads MCP: No-Code Setup

Q: Is there an official X Ads MCP?

Yes. X hosts the X Ads MCP at https://ads-api.x.com/mcp, with 74 tools and setup recipes for Grok and Claude Code. It needs your own X developer app. Porter's X Ads MCP runs at https://mcp.portermetrics.com/mcp, signs in with X and adds your other channels and dashboards. Both can sit in Claude.

Q: What is the X Ads MCP server URL?

Porter's X Ads MCP server URL is https://mcp.portermetrics.com/mcp. X's own server uses https://ads-api.x.com/mcp. Paste one into Claude, ChatGPT or another AI client as a custom connector. Porter's asks you to sign in with X, while X's asks for your app's OAuth 2.0 Client ID first.

Free forever plan: unlimited connected accounts, up to 30 days of history (15 days in AI chats) and 100 automation credits a month.
One X sign-in: no developer app, client ID or token refresh to manage.
Run X Ads end to end: campaigns, ad groups, promoted posts, reports and live dashboards.
Safe by default: new campaigns and ad groups start paused, and every change waits for your approval.

Try free

By Kashmala Malik · Last updated November 5, 2026

Use cases

Run X Ads end to end from your favorite AI chat

Porter Metrics connects X Ads, formerly Twitter Ads, to Claude, ChatGPT and other AI clients through one MCP server. MCP is the Model Context Protocol, the open standard AI apps use to reach other tools. Ask which posts earn engagement, which ad groups miss your cost per click or what drove last week’s spend, and the answer comes from your live ad account.

Campaign management

Campaigns and ad groups: create, edit or delete them, with objective, placements, bid, daily or total budget and schedule.
Promoted posts: write a promoted-only post as the ad creative, or promote a post you already published.
Pause and resume: change the status of any campaign or ad group, and change budgets, bids and end dates.
Setup lookups: funding instruments and targeting options such as locations, interests and platforms.
Multi-account and cross-channel: every ad account your X login reaches, next to Meta and Google Ads. Start with the Meta Ads MCP.

Reporting and engagement

330 fields: delivery, engagement, video, conversion and audience breakdowns, all in the X Ads fields list.
Engagement that costs: Engagements, Engagement rate and Cost per engagement (CPE) next to Link clicks and Cost per link click.
Followers: Follows, Follow rate and Cost per follow for follower campaigns.
Video: Video views, 6s video views and the 25%, 50% and 75% marks through Video completions.
Who sees it: results by Age, Gender, Country, Platform, Placement and Keyword.

Conversions and app installs

Website conversions: Web purchases, Web purchases (Sale amount), Web sign ups and Site visits.
View and engagement credit: post-view and post-engagement versions of each conversion, such as Web purchases (Post view).
Apps: Mobile installs, App clicks and Cost per app click.
Leads: Leads, Lead rate and Cost per lead.

X next to your marketing

X next to Meta and Google: spend, clicks and conversions by platform in one table, with the Google Ads MCP beside Meta.
Traffic next to spend: GA4 sessions by source next to X Spend, through the GA4 connector for Claude.
Pipeline next to spend: HubSpot deals next to X Spend by month, through the HubSpot MCP.

Reports and alerts

Live dashboards: one link that stays current. Start from the free X Ads dashboard templates.
Scheduled delivery: a dashboard emailed to you or a client on the day and hour you pick.
Weekly summary: what moved spend, which posts earned engagement and what to check next, written in the chat.

Reference

X Ads MCP server reference

One server, every X ad account: Porter connects X Ads to the AI clients, fields and workflows paid social teams already use. The same Porter server URL works in Claude, ChatGPT and any MCP client that supports remote servers. Porter’s X actions call the X Ads API with your X sign-in, so Claude reads campaigns, ad groups and promoted posts as they stand right now.

AI clients

Only one AI app?

ClaudeX Ads connector

ChatGPTX Ads connector

X Ads fields

Account objects: ad accounts · funding instruments · campaigns · ad groups · promoted posts · targeting criteria

Campaign setup: Campaign name · Campaign status · Objective · Ad Group name · Ad Group status · Bid type · Bid amount · Placement

Creative: Tweet text · Tweet URL · Tweet image · Tweet type · UTM campaign · UTM source

X Ads metrics

Delivery: Spend · Impressions · Total audience reach · Average frequency · Cost per 1k impressions

Clicks: Clicks · Link clicks · Link click rate · Cost per link click · App clicks

Engagement: Engagements · Engagement rate · Cost per engagement (CPE) · Likes · Replies · Retweets · Follows · Cost per follow

Video: Video views · 6s video views · Video played 25% · Video played 50% · Video played 75% · Video completions · Cost per video view

Conversion: Web purchases · Web purchases (Sale amount) · Web sign ups · Site visits · Mobile installs · Leads · Cost per lead

Porter has 330 ready-made X Ads fields, 202 metrics and 128 dimensions. Each one is in the full X Ads field reference.

Dimensions and segments

Campaign: Account Name · Campaign name · Ad Group name · Objective · Tweet text

Audience: Age · Gender · Country · City · Language

Targeting: Keyword · Audience · Conversation · Event · TV show

Placement and device: Placement · Platform

Time: Date · Week · Month · Quarter · Year · Day of week (Mon - Sun)

Other destinations

The same X Ads connection also sends data to Data Studio (formerly Looker Studio), BigQuery and Google Sheets, at no extra cost.

Placement reads ALL_ON_TWITTER for ads on X itself and PUBLISHER_NETWORK for ads shown off X. Ask for one audience breakdown per table, such as Age or Gender, so each answer stays easy to read.

Security and trust

Safety and security

Porter’s X Ads MCP signs in with X, creates new campaigns and ad groups paused and asks before anything changes in Ads Manager. Reporting, lookups and drafting are separate from changes. An AI client working through Porter touches only as much of your X ad account as the task needs and you approve.

Reporting first

Ask about campaigns, posts and results without writing anything back to X. Reporting runs apart from changes, so a spend question never edits an ad group.

Paused by default

Porter creates campaigns and ad groups paused, and Claude shows you the plan before it calls the create. Turn them on when you’re ready: campaign first, then ad group.

Budgets checked before they apply

Claude shows the new daily or total budget in your account currency and waits for your yes. Nothing spends until you approve the change and turn the campaign on.

Promoted-only posts stay off your timeline

Posts Claude writes as ad creatives are promoted-only, so followers don’t see them on your profile. X keeps them once made, so to stop one running, Claude removes it from the ad group instead.

Deletes are permanent

Deleting a campaign, an ad group or a promoted post can’t be undone. Claude asks first, so pause rather than delete when you might want it back.

X sign-in, no developer app

X’s own Ads MCP asks you to register an app in the X Developer Console and add Ads API access, per X’s Ads MCP docs. Porter handles that part, so you sign in with X and pick the ad accounts.

Your X role decides what changes

Claude works only with the ad accounts your X login can reach, and only within the access your user has on each one. You pick the accounts when you sign in.

Reporting priced per account

Reporting is billed per connected X ad account. One more question about the same account adds nothing to the bill.

Setup

How to set up the X Ads MCP server

Porter’s X Ads MCP uses one server URL in every AI client, plus an X sign-in you complete once. Claude takes Porter as a plugin or a custom connector. ChatGPT takes it through the Porter Metrics app or developer mode. Both reach the same X ad accounts.

https://mcp.portermetrics.com/mcp

How to install X Ads MCP in Claude

Use the Claude plugin for the guided setup. Claude keeps the Porter plugin synced when new tools ship.

Open Claude Settings → Customize → Plugins.
Click Add → Add marketplace → Add from a repository.
Paste portermetrics/porter.
Confirm Use portermetrics/porter.
Keep Sync automatically turned on.
Install the Porter Metrics card from the Directory.
Connect the Porter connector and sign in with X.
Ask Claude for an X Ads report, an engagement check or a paused campaign.

Anthropic’s guide to custom connectors using remote MCP walks through the same path, and custom connectors work on Free plans with a limit of one. The Claude-specific setup and use cases live on the X Ads connector for Claude page.

Watch the Claude plugin demo

Click-by-click Claude plugin demo:

Use manual MCP setup in Claude

Use manual setup when Claude asks for a custom connector instead of a plugin.

Click + in the chat composer.
Open Manage connectors.
Click + to add a connector.
Choose Add custom connector.
Name the connector Porter.
Paste https://mcp.portermetrics.com/mcp.
Click Add, then return to the chat.
Ask for your X ad accounts and follow the prompt to sign in with X.

X Ads to Claude demo:

How to install X Ads MCP in ChatGPT

Use the Porter Metrics app for the fastest ChatGPT route.

Open the Porter Metrics app in ChatGPT.
Click + or Add files and more.
Choose Add sources.
Select Porter Metrics.
Allow ChatGPT to use Porter Metrics.
Connect X Ads with your X sign-in.
Ask an X Ads question, like “Show Spend, Link clicks and Engagements by Campaign name for the last 7 days.”
Click Allow when ChatGPT asks permission to create or change something.

OpenAI documents connected apps in ChatGPT and custom MCP servers in ChatGPT developer mode. The X Ads connector for ChatGPT page covers the ChatGPT side in full.

Watch the ChatGPT app demo

Click-by-click X Ads to ChatGPT demo:

Use advanced MCP setup in ChatGPT

Use developer mode when you want the full Porter setup in ChatGPT: connector plus skill.

Open ChatGPT Settings → Connectors → Advanced.
Enable Developer mode.
Create a new app.
Name the app Porter Metrics.
Paste https://mcp.portermetrics.com/mcp as the MCP Server URL.
Download https://mcp.portermetrics.com/skill.zip.
Upload skill.zip to your ChatGPT project.
Ask ChatGPT for an X Ads report, an engagement check or a campaign draft.

How to install X Ads MCP in Claude Code, Cursor, VS Code and Codex

Pick your coding agent. Each one uses the same server URL and a Google sign-in, so no API key or credentials file sits in a config.

Run this in your terminal. Add --scope user to use Porter in every project.
claude mcp add --transport http porter https://mcp.portermetrics.com/mcp
Start Claude Code and type /mcp.
Pick porter → Authenticate. Your browser opens: sign in with the Google account you use in Porter.
Check: /mcp shows porter as connected. Ask: “Which X Ads accounts can you see?”

Open Cursor Settings → Tools & Integrations and click New MCP Server. Cursor opens mcp.json.
Paste this and save.
{ "mcpServers": { "porter": { "url": "https://mcp.portermetrics.com/mcp" } } }
Click Connect next to porter and sign in with the Google account you use in Porter.
Check: porter shows a green dot in Tools & Integrations. Open an Agent chat. Ask: “Which X Ads accounts can you see?”

Open the Command Palette (Ctrl/Cmd+Shift+P) and run MCP: Add Server → HTTP.
Paste https://mcp.portermetrics.com/mcp, name it porter and choose Global. Or add it to .vscode/mcp.json:
{ "servers": { "porter": { "type": "http", "url": "https://mcp.portermetrics.com/mcp" } } }
Allow the sign-in prompt and sign in with the Google account you use in Porter.
Check: open Copilot Chat in Agent mode; Porter’s tools appear under the tools icon. Ask: “Which X Ads accounts can you see?”

Add Porter from your terminal.
codex mcp add porter --url https://mcp.portermetrics.com/mcp
Sign in. Your browser opens: sign in with the Google account you use in Porter.
codex mcp login porter
Check: codex mcp list shows porter as logged in. Start codex. Ask: “Which X Ads accounts can you see?”

The same URL works in Windsurf, Cline, Zed and any client that supports remote MCP servers over HTTP.

Official X Ads MCP server URL

X hosts its own server, the X Ads MCP, at one URL:

https://ads-api.x.com/mcp

X’s docs list 74 tools and setup recipes for Grok, Grok Build and Claude Code. You first register an app in the X Developer Console, enable Ads Project access and paste its OAuth 2.0 Client ID. Use Porter’s URL for X next to your other channels, with a plain X sign-in.

Guides and videos

→

TutorialHow to connect X Ads to Claude

→

TutorialHow to connect X Ads to ChatGPT

Try this one once you’re connected:

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.

Prompts

X Ads MCP prompts

Each X Ads skill in Porter’s MCP is a ready-made prompt for one job an X advertiser does every week. A skill turns live ad account data into a report, an engagement check, a cross-channel answer or a paused draft. Copy a prompt into Claude or ChatGPT, then change the dates, accounts or thresholds to fit yours.

Reporting skills

Connection test

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.

Posts that earn engagement

For the last 30 days, by Tweet text, show Spend, Impressions, Engagements, Engagement rate, Link clicks and Cost per link click. Rank the 15 promoted posts with the most Spend and flag the ones below the account’s Engagement rate.

Ad group cost check

For the last 30 days, by Campaign name and Ad Group name, show Spend, Link clicks, Cost per link click and Web purchases. Flag ad groups whose Cost per link click runs more than 20% above the account’s.

Video drop-off

For the last 14 days, by Ad Group name, show Video views, 6s video views, Video played 25%, Video played 50%, Video played 75% and Video completions. Show where each video loses people.

Conversions and sales

For the last 8 weeks, by Week and Campaign name, show Spend, Web purchases, Web purchases (Sale amount) and Web purchases (Post view). Calculate return on spend from Sale amount and explain how much of it came from views.

Audience breakdown

For the last 30 days, show Spend, Link clicks and Web purchases by Age. Then run the same table by Gender and by Platform, and list segments that spend without converting.

Client account comparison

Compare every ad account by Account Name with Spend, Engagements, Link clicks and Cost per link click for the last 30 days, worst first.

Research skills

X next to Meta and Google

Compare my X Ads, Meta Ads and Google Ads accounts for the last 30 days: spend, clicks and conversions by platform and campaign.

Spend to sessions

For the last 8 weeks, put X Spend by Week next to GA4 sessions from x.com and t.co by Week. Flag weeks where spend rose without more sessions.

Spend to pipeline

For the last 6 months, put X Spend by Month next to HubSpot deals created and deal amount won by Month.

Keyword and interest ideas

Look up X targeting interests and locations for ‘B2B SaaS’ and ‘marketing analytics’, and list the ones that fit a campaign aimed at marketers in the United States.

The research skills blend X with your ad, analytics and CRM accounts, so connect Meta Ads, Google Ads, GA4 or HubSpot in Porter first.

Automation skills

Pause weak ad groups

From the ad group cost check, pause the ad groups I approve, and list each one before you change it.

Budget pacing

This month, by Date and Campaign name, show Spend. Project month-end Spend from the last 7 days and propose new daily budgets, but don’t apply them until I approve.

Campaign from a brief

Create a paused Website Clicks campaign with a $40 daily budget on my main funding instrument, plus one paused ad group on ALL_ON_TWITTER with automatic bidding. Write a promoted-only post from the copy I paste next and promote it in that ad group. Show me everything first.

Promote a post that’s working

Promote my post at the link I paste next in the ad group I name, and show me the change before you make it.

Weekly report by email

Build an X Ads dashboard with Spend, Engagements, Link clicks and Cost per link click by Campaign name, and email it to me every Monday at 8 a.m.

Monthly client recap

On the 1st of every month, email my client a dashboard with last month’s Spend, Engagement rate, Web purchases and Cost per link click by campaign.

Who this is for

Paid social teams who build X campaigns as well as report on them get the most from Porter’s MCP. Agencies, paid social managers, B2B and SaaS growth marketers and app marketers use it to turn an X question into a ranked report, a paused draft or a dashboard in one chat.

For marketers who report on X and then act on it.

Agencies and freelancers

Your client isn’t asking about impressions. They’re asking whether X earned its slice of the budget.

Every client account: one question across every ad account your X login reaches, with Account Name as a column.
Client reports: a live dashboard the client opens on Monday that nobody rebuilt.
Launch drafts: a brief becomes a paused campaign, waiting for review.
Cross-channel: X next to Meta and Google Ads in the same answer.

Paid social managers

Pacing: month-end spend projected while there’s still time to move budget.
Weak ad groups: high cost per click flagged before it eats another week.
Creative check: the promoted posts that earn engagement, ranked.
Quick changes: pause, resume or re-budget from the chat, after your yes.

B2B and SaaS growth marketers

Sign-ups and leads: Web sign ups and Cost per lead by campaign.
Pipeline: X spend next to HubSpot deals.
View credit: how much of a conversion came from a view, before you defend the budget.
Traffic: GA4 sessions next to spend, week by week.

App marketers

Installs: Mobile installs and Cost per app click by campaign.
Platform split: results by Platform, so iOS and Android costs sit side by side.
Video: where viewers drop off before the install.
Weekly email: the dashboard arrives every Monday without anyone building it.

When to use X’s own instead

You run X only and want custom audiences, conversion pixels, website cards or media uploads from the chat. X’s server covers those jobs, and you can run it next to Porter.

Comparison

Official X Ads MCP vs. Porter

X’s own X Ads MCP and Porter’s MCP both connect X ad accounts to AI clients. X’s Ads MCP docs describe 74 tools for reads, analytics, targeting, audiences, creatives and campaign writes, created paused. Porter covers the core X job without a developer app and adds every other channel, dashboards and scheduled reports.

X’s MCP hands your AI the whole X Ads toolbox. The Porter MCP hands it the marketing job: every channel, the reporting and skills that already know the work.

Both are hosted, use one URL and create campaigns and ad groups paused. Here is where they part.

	Porter	X Ads MCP
Same job, different reach
Server	Hosted by Porter at `mcp.portermetrics.com/mcp`	Hosted by X at `ads-api.x.com/mcp`
Sign-in	X login; Porter handles the app	Your own X developer app with Ads Project access and its OAuth 2.0 Client ID
Staying signed in	Lasts until you revoke it	Tokens last about 2 hours unless you add the offline.access scope
Several AI clients	The same sign-in works in Claude, ChatGPT and Cursor	One live sign-in per app and user; a second client revokes the first, so X suggests one app per client
Campaign management	Campaigns, ad groups and promoted posts, created paused, approval before every write	Campaigns, ad groups, targeting, promoted posts and activation, created paused
Audiences, pixels, cards, media	You do these in X Ads Manager as usual	Custom audiences, web event tags, cards and the media library
Reporting	330 ready-made fields, next to your other channels	Account stats and campaign reach tools
Price	Included in every Porter plan, the free plan too	No price listed
Only one side
Other channels	30+ data sources: Meta Ads, Google Ads, GA4, HubSpot and more	—
Cross-channel in one conversation	Yes	—
Live dashboards on your own branding	Yes	—
Scheduled reports by email	Yes	—
Data Studio, Google Sheets, BigQuery	Yes	—
Skills: whole X Ads tasks, already written	Yes	—

X’s column follows X’s Ads MCP docs (as of November 2026).

Use X’s own if you run X only and want audiences, pixels, cards or media uploads from the chat. Everything under Only one side is what happens when X is one channel of several. Both connectors can sit in the same Claude account.

X MCP or X Ads MCP?

Most servers called “X MCP” or “Twitter MCP” post, search and read tweets for a personal or brand account. They answer what people say on X, not what your ads did.

X and Twitter MCP servers: post, reply and search tweets, usually through X’s main API.
X Ads MCP servers: read and change your ad accounts through the X Ads API.
Porter: your X Ads results and campaign changes next to your other channels, in any MCP client.

And the third-party X Ads MCPs?

Plenty of them rank for this search, and they split three ways. The job tells you which one you’re looking at.

Reporting connectors: they read X Ads data into the chat and write nothing back.
Campaign controllers: they create and edit, usually as drafts you approve.
Open-source servers: free to download and yours to host. You keep the token and patch it when X changes the API.

Porter does reporting and approved changes from one hosted server, starting on the free plan.

X Ads MCP pricing

The X Ads MCP is included in every Porter plan, the free-forever plan too. Reporting is billed per connected account.

14-day trial: everything unlimited, no credit card.
Free forever: unlimited connected accounts, 30 days of history (15 days in AI chats), 100 automation credits a month.
Paid Reporting: from $15 per account a month, or $12.50 billed annually.
Unlimited questions: AI chats, queries and dashboards are included. Reads are free; each completed change uses 1 automation credit.

How many accounts will you connect?

5 accounts

Monthly billing

$40

Annual billing, per month

$33.33

Per account

$8.00

Reporting price for connected accounts, in USD. AI chats, queries and dashboards are unlimited. Annual billing is 10 months for 12.

The more accounts you connect, the lower the price per account. See the full calculator on Porter pricing.

Frequently asked questions

Is there an official X Ads MCP?

Yes. X hosts the X Ads MCP at https://ads-api.x.com/mcp, with 74 tools and setup recipes for Grok and Claude Code. It needs your own X developer app. Porter's X Ads MCP runs at https://mcp.portermetrics.com/mcp, signs in with X and adds your other channels and dashboards. Both can sit in Claude.

What is the X Ads MCP server URL?

Porter's X Ads MCP server URL is https://mcp.portermetrics.com/mcp. X's own server uses https://ads-api.x.com/mcp. Paste one into Claude, ChatGPT or another AI client as a custom connector. Porter's asks you to sign in with X, while X's asks for your app's OAuth 2.0 Client ID first.

Is the X Ads MCP free?

Porter's X Ads MCP is included in every Porter plan, the free-forever plan too. The free plan covers unlimited connected accounts, up to 30 days of history, 15 days in AI chats and 100 automation credits a month. Paid Reporting starts at $12.50 a month per data source account, billed annually, and the 14-day trial needs no card.

Is this the same as Twitter Ads?

Yes. X Ads is the ad platform formerly called Twitter Ads, at ads.x.com. Some fields still carry the old names, like Tweet text and Retweets. Claude reads them the same way, so a Twitter Ads question works with the same prompts.

Can it post to my X timeline?

Porter's X Ads MCP writes promoted-only posts for ads, which stay off your timeline and your followers' feeds. To post, reply or search tweets from your profile, use an X MCP server built on X's main API, next to Porter in the same Claude account.

Can I connect several X ad accounts?

Yes. One X login brings every ad account that user can reach, and you pick the ones Claude should use. Claude compares them in one answer with Account Name as a column. Reporting is billed per connected ad account, and the free plan connects unlimited accounts.

How do I connect Claude to X Ads?

Install the Porter plugin from Claude Settings → Customize → Plugins. Add the portermetrics/porter marketplace, install Porter Metrics from the Directory and sign in with X when the connector asks. Then ask Claude for your X ad accounts.

What is MCP? Is MCP an agent?

MCP is the Model Context Protocol, an open-source standard for connecting AI applications to external systems like X Ads. MCP isn't the agent. Claude and ChatGPT are the agents, and Porter's MCP is how they reach your X ad accounts.

Troubleshooting

Why don't the numbers match X Ads Manager?

Check the dates and the field first. Impressions, Link clicks and Video views include earned results that X doesn't bill, so they can run above what you paid for. Conversions split into total, post-view and post-engagement versions. Ask Claude for the same version Ads Manager shows.

Why can't Claude add an image or video to my ad?

Upload the image or video to your X media library, or build the website card, in X Ads Manager first. Claude then writes a promoted-only post with text and attaches that existing media or card. Text-only promoted posts work straight from the chat.

Why did creating an ad group fail?

Check three things. Every campaign needs a funding instrument, which Claude lists for you. Every ad group in a campaign shares one objective and product type. The placement has to fit that objective, so ALL_ON_TWITTER is the safe choice for promoted posts.

Start free

Connect X Ads to Claude or ChatGPT and start with engagement reports, live dashboards and campaigns that wait for your approval.

Start free: unlimited connected accounts on the free-forever plan, or a 14-day trial with everything unlimited and no card.

Start free

Agencies: every client's X account answers to one prompt.
Paid social managers: pacing, weak ad groups and the budget change sit in one chat.
B2B and SaaS growth marketers: X spend sits next to the pipeline it brought.
App marketers: installs and cost per app click arrive every Monday by email.