Segwise
Integration Docs

Integration Guide

Connect Segwise to Claude, ChatGPT, Cursor, Codex and Grok Bot

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. MCP is available to all Segwise accounts. Connect your AI tool and sign in with your Segwise login.

New to MCP? Read what MCP is and explore Segwise workflows.

Choose your AI tool and get set up

View as Markdown

How to get set up

MCP is available to all Segwise accounts. Choose your AI tool for connection steps and a prompt you can paste into it.

Which AI tool do you use?

Connect with Claude

Add Segwise as a custom connector, then connect your account.

  1. Open Customize → Connectors in Claude. Choose Add, then Add custom connector.
  2. Name it Segwise and enter https://mcp.segwise.ai/mcp as the remote MCP server URL. Follow the authentication setup and add the connector.
  3. Choose Connect and sign in with your Segwise account. Enable Segwise for your conversation in the Connectors menu.
Official Claude instructions

Setup prompt for Claude

Help me connect Segwise to Claude using the remote MCP server https://mcp.segwise.ai/mcp. First check whether Segwise is already connected. If it is missing, guide me through adding a custom connector in Customize → Connectors and signing in with OAuth. If setup or sign-in needs my action, guide me through it. Once connected, list the Segwise organizations I can access and ask which one I want to analyze. Verify the connection before saying setup is complete.

The prompt can help with setup. Complete any connection approvals and Segwise sign-in in your AI tool or browser.

Manual setup and server details
Server name
Segwise
Server URL
https://mcp.segwise.ai/mcp
Transport
Streamable HTTP
Authentication
OAuth. Sign in with your own Segwise account in the browser when prompted.

Add these details through your client's supported MCP setup flow. Workspace settings may require an administrator to add or allow the connection.

Cursor configuration fallback

If the install link does not open, merge this server entry into your Cursor MCP configuration, keeping any existing servers.

{
  "mcpServers": {
    "segwise": {
      "url": "https://mcp.segwise.ai/mcp"
    }
  }
}

Once connected, try your first question

Choose your Segwise organization, then ask:

Which creatives had the best ROAS in the last 30 days? Include their spend and the tags they have in common.

Need help? Visit the Segwise Help Center.

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 appear in my tracked competitors' stored ads that are missing from my own creative mix?”
  • “How does my hook mix compare with my competitors'?”
  • “Which messaging themes appear most often in my stored competitor ads?”

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.”

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.

Creative performance
Compare creatives across your connected ad networks by impressions, clicks, installs, spend, CPI, CTR, CVR, ROAS or custom events. Filter by network and date range, then drill into individual creatives.
Tag-level insights
Explore which hooks, CTAs, characters and visual styles are associated with performance. Use Segwise's AI tags, your custom tags and tags from your naming conventions.
Post-install and MMP data
Analyze attribution and post-install metrics from the MMPs connected to your Segwise account, including AppsFlyer, Adjust, Branch and Singular, mapped to your creatives and tags.
Competitor research
Compare your hooks, formats and messaging with competitor creatives already stored in Segwise. MCP uses that stored catalog; it does not search the public web or provide competitors' private spend or ROAS.
Saved reports
Ask questions about reports your team has already saved in Segwise, or summarize their findings for a creative review. MCP can analyze saved reports but cannot create or edit them.

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.

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.

Ad generation through MCP is coming very soon. Brief writing through MCP is also planned. 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, Codex or Grok Bot. Connect and authenticate in each client you want to use.

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

Connect through your AI tool's supported MCP connection flow using the server URL below. Each person signs in with their own Segwise login.

  • Claude
  • ChatGPT
  • Cursor
  • Codex
  • Grok Bot

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.

Setup and usage FAQs

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.
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 connect?
MCP is available to all Segwise accounts. Use the client selector for a setup prompt and connection steps, then sign in with your Segwise login. Choose your AI tool and get set up.

For product capabilities, see the Segwise MCP FAQs.

Bring your creative data into the conversation.

Already use Segwise? Connect your AI tool with your Segwise login. New to Segwise? Book a demo and we will show you what your creative data can answer.

Book a DemoStart Free Trial

Other integrations

AdjustAppsFlyerSingularKochavaGoogle AdsMeta