Which ad networks does it cover?

It queries the creative data that is already in your Segwise account, so it covers whichever ad networks and MMPs you have connected. Competitor analysis uses ads already stored in Segwise from the Meta, TikTok, LinkedIn and Google ad libraries. The MCP does not search those public libraries directly.

How many tools does the MCP expose?

Three: list_segwise_organizations retrieves the organizations you can access, start_segwise_query creates a background query job, and get_segwise_query checks that job and retrieves its answer. The list and get tools are read-only. The start tool creates state and may save conversation history, so it is not read-only even though it cannot change your advertising data.

Can it change anything in my account?

It creates temporary query jobs and may save conversation history so you can ask follow-up questions. It cannot create or edit reports, change campaigns, budgets, tags or settings, generate ads, or publish to your ad networks.

Does the MCP search the public web?

No. MCP queries use your authorized Segwise data and stored competitor catalog. The MCP agent does not have public web-search or page-fetching tools.

Can it write briefs or generate ads for me?

Not yet, and this one is coming. Generation and brief writing through the MCP are on the way. Today the MCP returns data, and generation stays inside Segwise where your team reviews and approves every ad before it goes anywhere.

Does everyone on my team need their own connection?

Yes. Each person connects their own AI tool with their own Segwise login.

The MCP is enabled per account. Speak to your Segwise account manager and they will switch it on and send you the server URL along with the connection steps for your client. If you are not a Segwise customer yet, book a demo to get started.

Integration Docs

Integration Guide

Connect Segwise to Claude, ChatGPT, Cursor and Codex

The Segwise MCP server connects your creative analytics to the AI tools your team already works in, so you can ask about your creative data without opening a dashboard. To get it switched on for your account, speak to your Segwise account manager.

View as Markdown

What is MCP

MCP, the Model Context Protocol, is an open standard for connecting a tool like Segwise to an AI client like Claude. Connect once and your AI tool can query your Segwise data directly, so you ask a question in the window you are already typing in and get an answer built from your own account, with no copy-pasting and no switching between tabs.

What you can do with the Segwise MCP

You ask in plain language and your AI tool works out which data it needs, so you never have to name any of this directly. These analyses do not change your advertising data.

What you can doWhat that reaches

Analyse your creative performance: Ask about your top and bottom performers across your connected ad networks, sorted by the metric you care about and filtered to any date range. Impressions, clicks, installs, spend, CPI, CTR, CVR, ROAS and your custom events.
Query at the tag level: Ask which hook scenes, CTAs, characters or visual styles drive performance instead of just which creative IDs spent. Your custom tags and the ones pulled from your naming conventions come through too, so answers use your team's vocabulary.
Bring in post-install and MMP data: Attribution from AppsFlyer, Adjust, Branch and Singular, mapped down to the creative and the tag rather than stopping at the campaign.
Research your competitors: Analyse the stored ads of competitors you track in Segwise, tagged with the same AI as your own ads, so their hooks, CTAs and messaging can be compared against yours.
Work from your saved reports: Start a question from a report your team already built in Segwise, so the answer begins from a view you trust rather than from scratch.

Available tools

The Segwise MCP exposes three tools. Listing organizations and retrieving answers are read-only; starting a query creates a background job and may save conversation history. Your AI client handles the calls based on what you ask, so there are no tool names to remember.

ToolWhat it does

List organizationsRead-onlylist_segwise_organizations: Returns the Segwise organizations you have access to. If you work across more than one, your AI client shows you the names and confirms which account to query before it asks anything.
Start a queryStarts a jobstart_segwise_query: Creates a temporary background job to answer your question and returns a job ID. Segwise analyses your creative performance, tag-level results, post-install metrics, stored competitor creatives or saved reports. It may save conversation history for follow-up questions, but cannot change your campaigns or advertising data.
Get the answerRead-onlyget_segwise_query: Checks the existing job and retrieves its answer when ready. Deeper questions can take several minutes, so your AI client keeps checking the same job. Checking a job does not start another query or extend its deadline.

Every question takes the same path: pick the organization, start the query, collect the answer. Your AI client never has to choose between a dozen narrow tools, so you can ask a broad question, then keep drilling in with follow-ups, without knowing how your data is organised.

What it does not do

Your AI tool can analyse your creative data and report back on what it finds. Query jobs and conversation history support that analysis. The MCP cannot:

Create or edit reports and dashboards.
Change campaigns, budgets, tags, custom tags or account settings.
Generate ads, change your ad networks or push anything live.
Search the public web or fetch arbitrary web pages. Competitor analysis uses the stored catalog in Segwise.

Coming soon: generation and brief writing through the MCP. Today generation stays inside Segwise, where your team reviews and approves every ad before it goes anywhere.

Before you connect

A Segwise account. You will authenticate with your existing Segwise login when you connect the server.
At least one connected ad network or MMP, so there is creative data for your AI tool to query.
An MCP-compatible client, such as Claude, ChatGPT, Cursor or Codex. MCP is an open standard, so one connection works across every tool that supports it.

Questions you can ask

Copy any of these straight into your AI tool, or use them as a starting point. You ask in plain language and your AI tool works out which data it needs.

Find what is working

“What were my top 10 creatives by ROAS last month, and which tags do they have in common?”
“Which hook scenes drove the most installs in the last 30 days?”
“Which creative elements have the best CTR on TikTok compared with Meta?”
“Which of my playables has the best IPM, and what mechanic does it use?”
“Show me the CTAs that appear most often in my top 20 creatives by spend.”

Work out what is not

“Which creatives spent more than $5,000 last month with below-average ROAS?”
“Compare my worst performers this month with my best. What do the weak ones have in common?”
“Which of my top creatives are starting to decline on ROAS?”
“Which tags show up in my low performers and almost never in my winners?”

Compare against competitors

“What creative angles are my tracked competitors running that I am not?”
“How does my hook mix compare with my competitors'?”
“Which messaging themes are my competitors using most often right now?”

Pull a view for your team

“Summarise my saved Q3 creative report for a leadership update.”
“How is my spend split across networks, and how does creative performance differ on each?”
“Give me the five creatives I should talk about in this week's review, and why.”

Tips for better answers

Name the date range. Last 7 days, this month or an explicit range will always beat an open-ended question.
Use your own tag names. If your team has set up custom tags in Segwise, referencing them directly gets you a sharper answer.
Say which network you mean. Asking about Meta, TikTok or AppLovin specifically avoids a blended average that hides the real story.
Start broad, then drill in. Open with your top creatives by ROAS, then follow up on the ones worth a closer look.
Ask it to show its working. Requesting the creatives or tags behind a claim lets you check the answer against Segwise itself.

Supported clients

Because MCP is an open standard, the same server URL works everywhere. Your account manager sends the setup steps for whichever of these your team uses.

Claude
ChatGPT
Cursor
Codex

Security and data privacy

Queries read your advertising data without changing campaigns, budgets, reports, tags or settings. Starting a query creates a temporary job and may save conversation history for follow-ups.
You connect with your own Segwise login, and each person connects individually.
Each request is checked against your Segwise organization access. Query jobs and their results are restricted to the user and client that started them.
You can disconnect at any time from your AI tool's settings, which revokes access immediately.

FAQs

Which ad networks does it cover?: It queries the creative data that is already in your Segwise account, so it covers whichever ad networks and MMPs you have connected. Competitor analysis uses ads already stored in Segwise from the Meta, TikTok, LinkedIn and Google ad libraries. The MCP does not search those public libraries directly.
How many tools does the MCP expose?: Three: list_segwise_organizations retrieves the organizations you can access, start_segwise_query creates a background query job, and get_segwise_query checks that job and retrieves its answer. The list and get tools are read-only. The start tool creates state and may save conversation history, so it is not read-only even though it cannot change your advertising data.
Can it change anything in my account?: It creates temporary query jobs and may save conversation history so you can ask follow-up questions. It cannot create or edit reports, change campaigns, budgets, tags or settings, generate ads, or publish to your ad networks.
Does the MCP search the public web?: No. MCP queries use your authorized Segwise data and stored competitor catalog. The MCP agent does not have public web-search or page-fetching tools.
Can it write briefs or generate ads for me?: Not yet, and this one is coming. Generation and brief writing through the MCP are on the way. Today the MCP returns data, and generation stays inside Segwise where your team reviews and approves every ad before it goes anywhere.
Does everyone on my team need their own connection?: Yes. Each person connects their own AI tool with their own Segwise login.
How do I get access?: The MCP is enabled per account. Speak to your Segwise account manager and they will switch it on and send you the server URL along with the connection steps for your client. If you are not a Segwise customer yet, book a demo to get started.

How to get set up

The MCP is switched on per account. Speak to your Segwise account manager and they will enable it and send you the server URL along with the connection steps for your client. Setup guides are also going into the Segwise Help Center.

Want the MCP switched on?

Speak to your Segwise account manager and they will enable it for your account. Not a customer yet? Book a demo and we will show you what your creative data can answer.

Book a Demo Start Free Trial

Other integrations