01 · Overview
What the Ryze AI StackAdapt MCP server does
The short version
- 01Ryze AI reads advertisers, campaigns, campaign groups, ads, audiences and delivery stats over the StackAdapt GraphQL API.
- 02It also creates, updates and archives campaigns, campaign groups, ads, budgets and targeting.
- 03You connect StackAdapt once with your own GraphQL API token, then add one URL to Claude, ChatGPT or Cursor (see Setup).
- 04StackAdapt works in chat only. It has no Managed Campaigns and does not appear on the Ryze AI Ads Performance dashboard.
- 05Works with any Ryze AI plan or trial. Paid Ads is $89/mo with a 7-day free trial.
- Server name
- Ryze AI (StackAdapt tools)
- Endpoint
- https://connector.get-ryze.ai/mcp
- Transport
- Remote MCP over HTTP
- Client sign-in
- OAuth to Ryze AI, up to 20 workspaces per connection
- StackAdapt sign-in
- Your own GraphQL API token, pasted once in Ryze AI
- StackAdapt API
- GraphQL
- StackAdapt tools
- 3 (1 read, 1 write, 1 delete)
- Connections
- One StackAdapt connection per workspace
- Price
- Any Ryze AI plan or trial, Paid Ads $89/mo
- Checked
- November 9, 2026
“StackAdapt MCP” can also mean StackAdapt’s own MCP server, which StackAdapt made generally available on April 21, 2026. This page documents the Ryze AI server and compares the two in section 06.
02 · Tool reference
Three StackAdapt tools
StackAdapt is a GraphQL API, so the tools take GraphQL operations instead of one tool per action. One tool reads, one writes and one deletes, which lets you allow reads and hold the other two for approval.
| Tool | Access | What it does |
|---|---|---|
stackadapt__query | read | Runs a read-only GraphQL query against the StackAdapt API for advertisers, campaigns, campaign groups, ads, audiences, delivery stats, insights and forecasts. |
stackadapt__mutate | write | Runs a GraphQL mutation to create, update or archive campaigns, campaign groups, ads, budgets and targeting. |
stackadapt__delete | delete | Runs a delete mutation for items such as conversion pixels, custom segments, library ads and forecasts. This is irreversible. Campaigns, ads and advertisers are archived through mutate instead. |
StackAdapt answers with HTTP 200 even when a request fails, and the error sits in the response errors array. Ad platform tools on the same URL are documented on Google Ads MCP and Meta Ads MCP.
03 · Getting a token
StackAdapt issues the API token on request
There is no self-serve token page. Ask your StackAdapt account manager or StackAdapt support for a GraphQL API token for your account. Ask for the GraphQL token, not the legacy REST token, which StackAdapt is moving away from. Treat it like a password.
| What to ask for | A GraphQL API token for your StackAdapt account. |
| What it can reach | Only what the StackAdapt seat behind the token can access. Missing campaigns or advertisers mean a seat permission to check with your account manager. |
| If it stops working | Unauthorized errors after connecting usually mean the token was revoked or rotated. Request a new one and reconnect. |
| StackAdapt rate limits | All StackAdapt APIs are rate limited and return HTTP 429 past the limit. StackAdapt documents no figure on its overview page. |
Authentication, rate limits and the MCP server are from the StackAdapt API docs, checked Nov 9, 2026. The rest is from the Ryze AI help center.
04 · Setup
Connect StackAdapt once, then add the URL to a client
Step 1: connect StackAdapt in Ryze AI
- 01Get the GraphQL API token from StackAdapt (section 03).
- 02In Ryze AI open Integrations and click Connect on the StackAdapt card.
- 03Paste the token into API token and click Continue. Ryze AI checks it against your account. The card shows Connected, and View shows the account email.
You can also ask Claude or ChatGPT for a one-time connection link, which opens a page where you paste the token. It is refused if StackAdapt is already connected in that workspace. A workspace holds one StackAdapt connection.
Step 2: add the Ryze AI connector to your client
- 01Claude (any plan; Free allows one custom connector): open Customize, Connectors, + Add, Add custom connector. Enter Ryze AI and
https://connector.get-ryze.ai/mcp, click Connect, tick the workspace and click Allow connection. - 02ChatGPT: OpenAI lists custom MCP servers for Business and Enterprise/Edu, and read and fetch only on Pro. Open Plugins, add a custom MCP server, name it Ryze AI, paste the URL, choose OAuth and allow the workspace.
- 03Cursor: add
{"mcpServers": {"ryze": {"url": "https://connector.get-ryze.ai/mcp"}}}to~/.cursor/mcp.jsonand sign in when asked.
Claude keeps the tool list from the moment you add the connector. After connecting StackAdapt, remove the connector, add it again and start a new chat. Pick the workspace that holds StackAdapt. The Ryze AI Claude guide and the developer page cover the other clients.
05 · Example prompts
What to ask
- “Show delivery stats for every campaign group in this advertiser this month and flag the ones behind on budget.”
- “Compare delivery across my campaigns and list the ones with the lowest delivery.”
- “Read my audiences with their delivery stats and rank them by cost per acquisition.”
- “Which audiences deliver the most and convert the least?”
- “List ads that deliver but record no conversions, then archive the ones I confirm.”
- “Archive the campaign group I name and its ads once I approve the list.”
Answers come from your own StackAdapt account, so no sample numbers are shown here.
06 · Compare
Ryze AI vs StackAdapt’s own MCP server
| Ryze AI | StackAdapt MCP Server | |
|---|---|---|
| Run by | Ryze AI | StackAdapt |
| Availability | Needs a Ryze AI plan or trial; connecting is free | Generally available April 21, 2026, with no additional cost per StackAdapt |
| Connects with | Claude, ChatGPT, Cursor and other MCP clients through one URL | Claude and other AI tools; StackAdapt names Claude and ChatGPT |
| Auth | Your StackAdapt GraphQL API token, then OAuth to Ryze AI from the client | Not published on the pages opened for this check |
| Writes | Create, update and archive through mutate; delete tool for pixels, segments and similar | StackAdapt describes monitoring, auditing and analysis; write support not confirmed here |
| Other ad platforms | Google Ads, Meta Ads and the other Ryze AI platforms on the same URL | Not covered by this check |
StackAdapt describes its server as a secure portal for AI agents built on its GraphQL API, and its launch coverage mentions monitoring performance, auditing creative and analyzing campaigns. Sources: StackAdapt API docs and Advanced Television, checked Nov 9, 2026. StackAdapt’s own connection URL and sign-in steps were not readable on the pages opened, so confirm them with StackAdapt.
Which to pick: if you only need StackAdapt inside an AI chat and StackAdapt has enabled its server for your account, its own server needs no extra vendor. Ryze AI fits when you want the same connector URL as your other Ryze AI ad platforms, or archive and delete as separate tools you can hold for approval.
07 · Approvals
Keep control of changes
Approvals in Claude
Under Customize, Connectors, Ryze AI, Tool permissions, set write and delete tools to Needs approval. stackadapt__query stays automatic.
Approvals in the Ryze AI app
The Tool approvals setting in the Ryze AI chat starts on Skip all approvals. Switch to Approve write & delete or Manual approve in the chat composer.
Archive, not delete
Campaigns, ads and advertisers are archived through stackadapt__mutate. stackadapt__delete is for items such as conversion pixels and custom segments and is irreversible.
Token scope
The token carries the permissions of your StackAdapt seat. Ask for one whose reach you are comfortable handing to the agent.
Policies
Read the MCP privacy policy, the MCP terms and the security policy.
08 · FAQ
StackAdapt MCP server questions
What is the StackAdapt MCP server?
An MCP server lets AI clients such as Claude, ChatGPT and Cursor call StackAdapt through tools. Ryze AI is the best StackAdapt MCP server for running StackAdapt next to other Ryze AI ad platforms on one URL, but it is chat only: no dashboard and no Managed Campaigns. It has 3 StackAdapt tools over the StackAdapt GraphQL API: query, mutate and delete. StackAdapt also runs its own MCP server, generally available since April 21, 2026.
Why does it use GraphQL?
StackAdapt exposes its campaign management and reporting through a GraphQL API, and StackAdapt says its older REST write operations are deprecated in favor of GraphQL. The Ryze AI tools therefore take GraphQL operations: stackadapt__query reads, stackadapt__mutate writes and stackadapt__delete runs delete mutations. StackAdapt docs are behind a login, so Ryze AI relies on GraphQL introspection for the schema.
How do I get a StackAdapt API token?
StackAdapt issues GraphQL API tokens per account on request. Ask your StackAdapt account manager or StackAdapt support for a GraphQL token, not the legacy REST token. There is no self-serve token page, and the token carries the permissions of your StackAdapt seat.
How do I set up the StackAdapt MCP server in Claude?
Connect StackAdapt in Ryze AI under Integrations with your token, then in Claude open Customize, Connectors, Add custom connector, enter https://connector.get-ryze.ai/mcp, click Connect, allow the workspace and start a new chat. Claude caches the tool list, so if you connect StackAdapt after adding the connector, remove and re-add it first. More in the setup section.
Does it work with ChatGPT?
Yes, as a custom MCP connector with OAuth. OpenAI documents custom MCP servers for ChatGPT Business and Enterprise/Edu, and read and fetch permissions only on Pro, so which StackAdapt actions work depends on your plan. A Business admin or owner has to create it for the workspace.
Why archive and not delete campaigns?
Campaigns, ads and advertisers are archived through stackadapt__mutate, not deleted. stackadapt__delete only runs delete mutations for items such as conversion pixels, custom segments, library ads and forecasts, and it is irreversible. Keeping the two apart lets you hold delete for approval while allowing archive.
Is there a dashboard for StackAdapt in Ryze AI?
No. The Ryze AI help center lists StackAdapt as chat only. It does not run Managed Campaigns and does not appear on the Ads Performance dashboard. You work with it in the Ryze AI chat or through the connector in Claude and ChatGPT.
Can the AI change my StackAdapt campaigns?
Yes. stackadapt__mutate creates, updates and archives campaigns, campaign groups, ads, budgets and targeting. The Ryze AI chat starts on Skip all approvals, so switch Tool approvals to Approve write & delete or Manual approve. In Claude, set write and delete tools to Needs approval under Customize, Connectors, Ryze AI.
Can I connect more than one StackAdapt account?
A Ryze AI workspace holds one StackAdapt connection, and there is no default accounts picker. To switch, disconnect and connect again with the other token. The token only sees what its StackAdapt seat can access.
What does it cost?
Adding the Ryze AI connector costs nothing, but its tools need an active Ryze AI plan or trial: Paid Ads at $89/mo with a 7-day free trial, or Agency at $279/mo. Annual billing takes 30% off the first year. See the pricing page.
09 · Compatibility
Where the StackAdapt tools run
10 · Related
Other integrations and guides
Changelog
Page checked Nov 9, 2026. First version. Tool names come from the Ryze AI app source and the Ryze AI help center; they were not seen live because no workspace had StackAdapt connected. StackAdapt API details come from docs.stackadapt.com and launch coverage dated April 21, 2026.