MCP integration

Bring your ad performance into Claude.

Peachblue's MCP server exposes the same 23 tools that power Agent Peach to any MCP client: Claude Desktop, claude.ai, and Claude Code. Rankings, comparisons, patterns, fatigue, and risk, over your Meta, TikTok, Google Ads, and Amazon DSP data.

Other ad tools ship MCP servers for inspiration libraries or competitor research. Peachblue's is the only creative analytics MCP that serves your own cross-platform performance data, including Amazon DSP.

7-day trial · From $79/mo · Cancel anytime · MCP included on Pro and up

A question asked of a sample account through Peachblue's MCP server, "Show me my top five creatives this week": the Peachblue tool call that answered it, get_creatives with limit 5 over the last 7 days, and Peachblue's creative card, a ranked grid of 5 creatives led by #1 Little can. Big mood. at score 96 and #2 Found my new fave fizz at 95.

Ask in plain language.

Claude calls Peachblue's tools and reasons over the results. Answers match the app, because they run on the same engine, and every number states the time window it came from.

What were my top 5 creatives by composite score last month?
Compare our two hero videos head to head.
Which hooks drove the most ROAS on Meta this quarter?
Where is spend concentrated right now, and what looks fatigued?
How did last week compare to the week before, and what moved?

Connected in three steps.

1

Copy your connection URL

In Peachblue, open Settings and go to the MCP tab. Your workspace's connection URL is right there.

2

Add it to your client

Claude Desktop, claude.ai, Claude Code, or any client that speaks the Model Context Protocol. Paste the URL as a custom connector.

3

Approve with OAuth

The first connection opens a sign-in where you approve access with your Peachblue account. No API keys to create, rotate, or leak.

Access follows your Peachblue login: workspace scoping, tier gating, and instant revocation from the same Settings tab. Full client-by-client instructions are in the setup docs.

23 tools, five jobs.

Performance and rankings

Account summaries, ranked creatives, deep dives, and head-to-head comparisons decided by composite score.

Patterns and dimensions

Creative archetypes, 31-dimension tag analysis, and copy variant performance across every ad.

Time and risk

Daily trends, period-over-period change attribution, spend concentration, and fatigue candidates.

Audience and brand

Demographics, placements, keyword search across your library, and Reddit brand sentiment.

Pacing and reporting

Amazon DSP flight pacing against budget, supplier breakdowns, daily spend, and client-by-client comparison for agencies.

Every tool is read-only and scoped to your workspace. See the full list in the MCP tool reference.

How do you connect Peachblue to Claude?

Copy your connection URL from Settings, MCP tab, add it to Claude as a custom connector, and sign in with your Peachblue account. Nothing needs installing.

Claude Desktop and claude.ai

  1. Open Customize, then Connectors, and click the plus button.
  2. Choose Add custom connector, name it Peachblue, and paste your connection URL.
  3. Complete the Peachblue sign-in, then ask "what were my top 5 creatives by composite score last month" to check it works.

Custom connectors work on every Claude plan, and the free plan allows one. On Team and Enterprise an owner adds the connector first, then each member connects with their own Peachblue login. Claude asks before it calls a tool unless you choose to always allow it, and you can switch tools off for a conversation in its Search and tools menu.

Claude Code

One command, then sign in when Claude Code first uses it:

claude mcp add --transport http peachblue <your-connection-url>

Other MCP clients

Any client that supports remote MCP connectors connects the same way. The server speaks Streamable HTTP with an OAuth sign-in, so there is never an API key to paste. The setup docs carry the latest steps.

What can each tool answer?

Each of the 23 tools answers one kind of question, and Claude picks the tools for you. Every one is read-only, returns its data with the time window it covers, and runs on the same engine as the app, so a number in Claude matches the number on the Performance page.

ToolAsk it
get_performance_summaryHow are we doing overall, and what should we do next?
get_creativesWhat are my top five creatives this week?
get_creative_detailWhy is this creative working, and who does it reach?
rank_adsWhich individual ads have the worst CPA?
get_ad_detailsShow me everything about this one ad.
view_creativeShow me the image for this creative.
compare_adsWhich of these two creatives wins?
get_patternsWhat do my winners have in common?
filter_by_tagsWhich hook styles and tones return the most for us?
get_copy_performanceWhich headlines and body copy return the most?
get_google_ads_rsa_performanceWhich headlines win and lose inside each responsive search ad?
get_ad_trendHow has this ad done day by day?
get_digestWhat happened yesterday, and how is the week going?
get_campaignsWhich campaigns carry the spend, at what ROAS and CPA?
compare_periodsWhat changed since last week, and which creatives moved it?
get_risk_summaryWhere is spend concentrated, and what is fatiguing?
get_audience_insightsWhich age, gender, and placement segments are cheapest?
search_creativesWhich of our ads mention zero sugar?
get_pacingWhich Amazon DSP flights are behind pace?
get_supplier_breakdownWhere is our DSP spend going, supplier by supplier?
get_daily_spendWhat did we spend each day in September?
compare_clientsWhich client has the best CPA this month?
get_brand_mentionsWhat is Reddit saying about us and our competitors?

Pacing and supplier answers need Amazon DSP connected, and the roster comparison an agency workspace. Arguments and return fields are in the MCP tool reference.

What do the answers look like?

Real data, already worked out. Four questions asked of the sample account, Fizzli, the fictional drinks brand behind every product picture on this site. Claude writes the sentences; Peachblue supplies the numbers, the ranking, and the verdicts.

In clients that support MCP Apps, creative results also arrive as inline cards with thumbnails and scores, like the one at the top of this page.

Are there ready-made workflows?

Yes, four. In clients that support MCP prompts, Peachblue offers them as starting points: each one calls the right tools in order and asks for a structured write-up.

  • Weekly creative review. Top creatives to scale, underperformers to pause, the best headlines by ROAS, and what Reddit is saying, for the last 7, 14, or 30 days.
  • Generate creative brief.A brief built from your winners' tags, audiences, and copy themes, with what to avoid.
  • Cross-platform audit. Spend share and scores by platform, the best creatives on each, and the creatives winning on more than one.
  • Competitive landscape. Your Brand Intel from Reddit beside what is working in your account, to find the angles the market wants and your ads miss.

What can it see, and what can it change?

It sees your workspace's synced ad data and Brand Intel, and it can change nothing. Every tool is read-only, and Peachblue itself only ever reads from Meta, TikTok, Google Ads, and Amazon DSP, so no step between Claude and your ad accounts creates, edits, or pauses anything.

  • A sign-in, not a key. You approve access with your Peachblue account over OAuth. There is no API key to create, share, or leak.
  • Scoped like the app. Each person connects with their own login and sees only their workspace, and agency calls stay inside the client you name. Disconnect from the same Settings tab and access ends at once.
  • Your data stays yours. It is never shared across workspaces, never sold, and never used to train models for other customers. See data access and deletion.

What are the limits?

  • Plan. MCP is on Pro and up; Amazon DSP data needs Scale.
  • Platforms. Answers cover what Peachblue syncs: Meta, TikTok, Google Ads (Search, Display, and Video), and Amazon DSP. Performance Max, LinkedIn, Pinterest, Snapchat, and YouTube as a channel of its own are not covered.
  • Read, not act. Peachblue cannot pause an ad or move a budget; that stays in the ad platform or its own connector.
  • Freshness. Data is as current as the last daily sync.
  • Fair use. A rate limit per workspace guards the server, and normal analysis never reaches it. Questions use no credits: credits pay for creative analysis.

How does it work for agencies?

Agency workspaces get the same server, with every call scoped per client. Name a client in the question ("how are Fizzli's DSP flights pacing?") and the tools answer for that client alone; leave the name out and they answer across the roster. Clients are your Amazon DSP advertisers and Meta ad accounts.

  • The roster in one table.One row per client with spend, CPM, CTR, results, and CPA, so "which client is the problem" is one question.
  • Pacing and suppliers per client. Every DSP flight against its budget and blended CPM, and spend supplier by supplier.

Agency workspaces are on the Agency plan, priced to your client roster. The Amazon DSP page has the pacing and reporting side.

How is it different from the ad platforms' own MCP servers?

A platform's own server reaches one platform's raw account, and most of them can act on it. Peachblue's reaches four platforms' data with the analysis already done, and cannot act. They work well together: the platform server acts, and Peachblue tells Claude what deserves acting on.

ServerPlatformsChanges campaignsSetupPrice
Meta ads AI connectorsMetaYes; new ads start pausedHosted; Facebook sign-inNo fee listed (open beta)
TikTok for Business MCP ServerTikTokYes; campaigns, budgets, bidsHosted; no developer credentialNot stated
Google Ads MCP serverGoogle AdsNo; query tools onlySelf-run; Google Cloud project and Ads API accessOpen source
Amazon Ads MCP serverAmazon Ads, including DSPYes; create, update, deleteHosted; an approved Amazon Ads API appNo fee listed (open beta)
PeachblueMeta, TikTok, Google Ads, Amazon DSPNo, read-onlyHosted; Peachblue sign-inFrom Pro at $199 a month

From each platform's own documentation: Meta verified October 9, 2026, Amazon October 15, Google and TikTok November 1.

None of the platform servers documents a tool that tags a creative's hook, format, or angle, or recognizes the same asset across ads and platforms; Peachblue does both at sync. For data connectors and other creative analytics servers, see the best MCP servers for ad data.

Frequently asked questions

What is the Peachblue MCP server?

A remote MCP server that gives Claude, and any client that supports remote MCP connectors, 23 read-only tools over your own Meta, TikTok, Google Ads, and Amazon DSP data: the tools Agent Peach uses in the app. It is included on Pro and up.

Where do I find the Peachblue MCP server URL?

In Peachblue, open Settings and go to the MCP tab: your workspace's connection URL is there to copy. Add it to Claude as a custom connector and sign in with your Peachblue account when prompted.

Is the Peachblue MCP server read-only?

Yes. Every tool reads and none writes, and Peachblue itself only ever reads from your ad platforms. Claude can rank, compare, and explain through it, but it cannot pause an ad or change a budget.

Which Peachblue plan includes MCP?

Pro at $199 a month and every plan above it. Amazon DSP data arrives from Scale at $499, and agency workspaces with per-client scoping are on the Agency plan, priced to your client roster. Pro starts with a 7-day trial.

Does it work with ChatGPT?

The server is built on the open standard ChatGPT uses for custom MCP servers, Streamable HTTP with OAuth sign-in, but we have not verified a ChatGPT connection yet. The documented clients today are Claude Desktop, claude.ai, and Claude Code.

Do questions in Claude use Peachblue credits?

No. Credits pay for creative analysis, which happens when a creative syncs; asking about the results does not use them. A fair-use rate limit per workspace guards the server.

How is it different from Meta's or Google's own MCP server?

A platform's own server reaches that platform's raw account data, and Meta's, TikTok's, and Amazon's can also change campaigns. Peachblue's reaches all four platforms with the analysis done: creatives grouped across ads, scored, and tagged across 31 dimensions. Many teams connect both.

Your data, wherever you think.

MCP access is included on Pro and up. Connect a platform, let the first sync land, and ask Claude about your own ads.

7-day trial · From $79/mo · Cancel anytime