01 · Overview
What Thrad AI MCP means in Ryze AI
The short version
- 01Ryze AI reads and manages Thrad campaigns, ad groups and ads, and pulls insights across Thrad and ChatGPT (OpenAI Ads) supply.
- 02Two tools look (
read,insights), two change things (write,uploadFromUrl) and one archives (delete). Image upload is expected to fail today. - 03Thrad connects with an API key from the Thrad Platform. Your AI client then connects to Ryze AI with one URL (see Setup).
- 04Creating a campaign submits it to Thrad for review and, by Thrad’s rule, charges a $10 deposit to the organization’s billing card.
- 05Thrad works in chat only: no Managed Campaigns and no Ads Performance dashboard. Paid Ads is $89/mo with a 7-day free trial.
- Server name
- Ryze AI (Thrad 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
- Thrad sign-in
- Thrad API key (starts with ak_), pasted once in Ryze AI
- Thrad API
- Advertiser REST API, campaigns, ad groups, ads, assets, insights
- Thrad tools
- 5 (2 read · 2 write · 1 delete)
- Not covered
- Managed Campaigns, Ads Performance dashboard, default-accounts picker
- Price
- Paid Ads $89/mo, 7-day free trial
- Checked
- November 8, 2026
Thrad describes itself as a DSP and SSP for LLMs: it scores ads against the intent of a prompt, runs a real-time auction and places the winner inside an AI response. Advertisers buy that inventory on CPM or CPC, and Thrad’s insights also cover ChatGPT supply from OpenAI Ads. “Thrad MCP” is not a server Thrad publishes: its documentation index lists an advertiser API, a publisher API and agent skills, and no MCP server. This page documents the hosted Ryze AI server that wraps the advertiser API, and compares it with Thrad’s own options in section 06. For ChatGPT ad inventory bought through OpenAI directly, see ChatGPT Ads MCP.
01
An API key, no OAuth screen
Thrad connects with a key from Settings > API keys in the Thrad Platform. Paste it into the Thrad card in Ryze AI once and the card shows Connected.
02
The whole ad hierarchy
Thrad nests an ad account, campaigns, ad groups and ads. thrads__read opens any of them, plus the assets that ads point to.
03
Insights across two supplies
thrads__insights combines Thrad and ChatGPT (OpenAI Ads) supply and filters by source, with impressions, clicks, spend, CTR, CPC and CPM.
04
Create, update, pause, activate
thrads__write builds campaigns with ad groups and card or poll ads, edits them, and switches them between active and paused.
05
Archive in its own tool
thrads__delete archives a campaign, ad group or ad. Archiving a campaign cannot be undone; an archived ad group or ad can be brought back with activate.
06
More than one Thrad account
Several Thrad accounts can sit in one workspace. A star marks the primary, and every thrads tool takes an optional connection_id to target one.
07
Review built in
A new campaign is submitted to Thrad for review and does not serve until Thrad approves it. The agent can read the review status back.
08
Next to other ad platforms
Google Ads, Meta Ads, TikTok Ads and OpenAI Ads tools share the same URL, so one chat can set Thrad results beside the rest of paid media.
02 · Tool reference
Five Thrad tools
Every Thrad tool takes workspace when your client connection covers more than one Ryze AI workspace, and an optional connection_id to target one Thrad account when a workspace holds several. The agent works out the rest of each request from the tool descriptions.
| Tool | Access | What it does | Inputs |
|---|---|---|---|
thrads__read | read | Reads any Thrad resource: the ad account, campaigns, ad groups, ads and assets. | workspace · optional connection_id |
thrads__insights | read | Aggregated insights that combine Thrad and ChatGPT (OpenAI Ads) supply, filterable by source: impressions, clicks, spend, CTR, CPC and CPM. | workspace · optional connection_id |
thrads__write | write | Creates or updates campaigns, ad groups and ads, and activates or pauses them. New campaigns are submitted for Thrad review. | workspace · optional connection_id |
thrads__uploadFromUrl | write | Uploads an image from a URL to get a file id for a creative. Thrad answers this call with a 404 today, so ads use assets that already exist. | workspace · optional connection_id |
thrads__delete | delete | Archives a campaign, ad group or ad. Archiving a campaign is irreversible. | workspace · optional connection_id |
uploadFromUrl is listed because the tool exists. Thrad’s upload call currently answers with a 404, so plan on existing assets.
What the tools reach in Thrad
| Thrad object | What it is | What the agent can do |
|---|---|---|
| Ad account | The advertiser organization. Root scope for account-level insights. | Read |
| Campaign | Holds the budget and pricing model (CPM or CPC). Review status: approved, in_review or rejected. | Read, create, update, activate, pause, archive |
| Ad group | Sits in a campaign and holds context hints and the max bid. Targeting is set on the campaign, by country only. | Read, create, update, activate, pause, archive |
| Ad | A card or poll that points to an asset (image and destination URL). | Read, create, update, activate, pause, archive |
| Asset | The image and destination URL an ad uses. Thrad's API exposes assets as read-only. | Read |
Hierarchy, formats and statuses from Thrad’s advertiser API overview, checked Nov 8, 2026. Ad and analytics tools on the same URL are documented on Google Ads MCP, Meta Ads MCP and ChatGPT Ads MCP.
03 · Use cases
Prompts for Thrad, grouped by job
Thrad insights combine Thrad and ChatGPT supply by default, so the first thing worth asking for is the split by source. People who search for how to advertise on ChatGPT or ads in ChatGPT often land here: OpenAI’s own ad product has its own page, ads in ChatGPT, and its tools are described on ChatGPT Ads MCP.
- “Show Thrad impressions, clicks, spend, CTR, CPC and CPM for the last 14 days, split by Thrad and ChatGPT supply.”
- “Which of my Thrad campaigns has the highest CPC this month, and which ad group drives it?”
- “Compare Thrad spend with Google Ads and Meta Ads spend for the same dates.”
- “List the assets in my Thrad account and suggest which ones fit a card ad for a spring sale.”
- “Draft a campaign with one ad group and two card ads. Show me the budget, bid and targeting before you create it.”
- “Check the review status of my newest campaign and tell me if it can be activated yet.”
- “Pause every ad whose CTR is below the campaign average over the last 14 days. List them first.”
- “Activate the campaign I name once Thrad shows it as approved.”
- “Archive the ad groups with no spend this month, one by one. Do not touch campaigns.”
- “Which Thrad accounts are connected to this workspace, and which one is primary?”
- “Run the same insights report for each connected Thrad account and put them in one table.”
- “Read the ad account details for the account I name.”
Every answer comes from your own Thrad account, so no sample numbers are shown here.
04 · Setup
Connect Thrad once, then add the URL to each client
Step 1: connect Thrad in Ryze AI
- 01In the Thrad Platform, go to Settings, API keys and create a new key. Copy it; it starts with
ak_. - 02In Ryze AI open Integrations, click Connect on the Thrad card, paste the key into API key and click Continue.
- 03Ryze AI verifies the key and the card shows Connected. To add another Thrad account, click View, then Add one more account.
- 04Prefer to stay in the chat? Ask the agent in Claude or ChatGPT for a one-time connection link. It opens a page where you paste the API key.
Thrad allows one active key per organization, so a new key replaces the old one. Steps are in the Ryze AI Thrad guide.
Step 2: Claude on the web or desktop
- 01Go to Customize, Connectors.
- 02Choose + Add, then Add custom connector. Enter Ryze AI as the name and
https://connector.get-ryze.ai/mcpas the remote MCP server URL. - 03Review the authentication Claude detected and continue; do not pick No sign in. Click Add, then Connect.
- 04Sign in to Ryze AI, choose the workspace that holds Thrad and click Allow connection, then start a new chat.
Anthropic lists custom connectors on Free, Pro, Max, Ultra, Team and Enterprise, and Free holds one. On Team an Owner adds Ryze AI under Organization settings, then each member clicks Connect. Claude keeps the tool list from the moment the connector is added: if Thrad was connected afterwards, remove the connector, add it again and start a new chat.
ChatGPT
OpenAI documents custom MCP servers on ChatGPT web for Business and Enterprise/Edu, and read/fetch only for Pro, so a Pro account can read Thrad data but not change it. On Business an admin or owner creates it. Open Plugins, choose the plus button, then Add custom MCP server. Name it Ryze AI, enter the URL, choose OAuth, accept the risk notice, create it as a plugin and sign in to Ryze AI. Install it, start a new conversation, type @ and select Ryze AI. Custom servers cannot be added on mobile.
Cursor
{ "mcpServers": {
"ryze": { "url": "https://connector.get-ryze.ai/mcp" }
} }Cursor opens a sign-in window the first time a tool runs and asks before it uses MCP tools by default. The Add to Cursor button on the developer page writes the same entry.
Step 3: refresh the tool list
After connecting Thrad, start a new chat. If the tools still do not appear, refresh the Ryze AI connector: in Claude, remove it under Customize, Connectors, add it again and open a new chat.
05 · Permissions
Who can connect, and what the Thrad key reaches
| Who can connect | Anyone with access to the Ryze AI workspace and a Thrad API key. In the Thrad Platform, Thrad's docs say organization owners and admins manage API keys. |
| Which account | One key belongs to one Thrad organization, and Thrad allows one active key per organization. Add more Thrad accounts in Ryze AI with View > Add one more account. |
| What the key reaches | A Thrad key is a bearer token for the advertiser API of that organization. It can create campaigns, which charge a deposit, so keep it out of chats and screenshots and revoke it in the Thrad Platform if it leaks. |
| Credential | Where it comes from | How it behaves |
|---|---|---|
| ak_ key | Thrad Platform > Settings > API keys | Pasted into the Thrad card in Ryze AI; also usable through a one-time connection link opened from Claude or ChatGPT. |
| Key rotation | Thrad Platform | Creating a new key makes Ryze AI's stored key stop working. Click Reconnect on the Thrad card and paste the new key. Thrad's docs describe a 30-minute grace window after rotation; revoking a key is immediate. |
| Client sign-in | Ryze AI connector | OAuth to Ryze AI in Claude, ChatGPT or Cursor. No Thrad key is entered in the client. |
Key behavior from Thrad’s authentication reference and the Ryze AI help center, checked Nov 8, 2026. Thrad’s API returns the same 401 for a missing and an invalid key, so a rejected key never says why.
Removing access
In the Thrad Platform, revoke the key; Thrad says revocation is immediate. In Ryze AI, open View on the Thrad card to remove one account. In Claude, open Customize, Connectors, Ryze AI and click Disconnect, which cuts off every workspace at once.
06 · Compare
Ryze AI vs Thrad’s own tools
Ways to work with Thrad
| Option | Built for | How you connect | Data | Changes |
|---|---|---|---|---|
| Ryze AI hosted server | Paid media managers who run Thrad beside other ad platforms | Thrad API key in Ryze AI, then OAuth sign-in from the client | Ad account, campaigns, ad groups, ads, assets, insights | Create, update, activate, pause, archive |
| Thrad Platform dashboard (platform.thrad.ai) | Advertisers who prefer a screen | Thrad login | Everything in the Thrad Platform | Self-serve campaign launch, assets and billing |
| Thrad advertiser REST API (api.thrad.ai/v1) | Developers building their own tooling | Bearer token with an ak_ key | Campaigns, ad groups, ads, assets, ad account, insights | Create, update, status actions; assets read-only |
| Thrad agent skills (docs.thrad.ai/agent-skills) | Developers adding Thrad placements to an AI app | Markdown skill files for a coding agent | Publisher side: bid request, rendering, tracking | Not for managing advertiser campaigns |
| Thrad MCP server | Not found | Thrad's documentation index lists no MCP server | Not applicable | Not applicable |
Sources: docs.thrad.ai (documentation index, advertiser API reference, agent skills) and thrad.ai, opened Nov 8, 2026. Thrad also offers a managed service and design partner deals through its sales team.
Ryze AI, the Thrad Platform and the REST API
| Ryze AI | Thrad Platform | Thrad REST API | |
|---|---|---|---|
| Interface | A chat in Claude, ChatGPT, Cursor or the Ryze AI app | Web dashboard | HTTP requests from your own code |
| Sign-in | Thrad key once, then OAuth from the client | Thrad login | ak_ key as a bearer token |
| Image upload | Not working today; ads use existing assets | Assets are created here or from a product feed | No upload endpoint; assets are read-only |
| Campaign deposit | Charged by Thrad when a campaign is created | Charged by Thrad | Charged by Thrad on POST /v1/campaigns |
| Other ad platforms in the same chat | Google Ads, Meta Ads, TikTok Ads, OpenAI Ads and more | Thrad only | Thrad only |
| Managed Campaigns and Ads Performance dashboard | Not available for Thrad | Not applicable | Not applicable |
| Price | Paid Ads $89/mo, 7-day free trial | No minimum spend on self-serve, per Thrad | No minimum spend on self-serve, per Thrad |
As published on Nov 8, 2026. Thrad changes its product often, so check its documentation before you decide.
Which to pick: use the Thrad Platform to create assets and to manage billing. Use the REST API if you are writing your own integration. Use Ryze AI when you want to ask about Thrad results in plain language, change campaigns on approval, or read Thrad next to Google Ads and Meta Ads in one chat.
07 · API limits
Thrad limits an agent runs into
| Requests per key | Thrad allows 1,000 requests per hour per API key across /v1/. Exceeding it returns 429 with the code rate_limit_exceeded. |
| Campaign creation | POST /v1/campaigns is limited to 60 per hour per key, on top of the 1,000 an hour bucket. |
| Campaign deposit | Creating a campaign charges a $10 deposit to the organization's default card. Without a default card the request fails with 400 billing_not_configured; a declined card returns 402 card_declined and the campaign is not kept. |
| Review before serving | A new campaign comes back paused with review_status in_review. Activating before approval returns 400 campaign_not_approved. |
| Budget and bid | The minimum budget is $0.99. The period (lifetime, daily, weekly, monthly, quarterly or yearly) is locked after launch, and a periodic budget has no lifetime ceiling. Max bid per ad group runs from $0.0001 to $100. |
| Pricing models | CPM (default) or CPC. Thrad lists CPA as coming soon. |
| Insights windows | One window spans at most 366 days, hourly windows at most 25 hours, and a page returns 1 to 2,000 rows (default 20). |
| Status changes | Status is not set in an update body. It changes only through activate, pause and archive actions. |
| Assets | Thrad's API has no endpoint to create assets or upload images. Assets come from the Thrad Platform or a product feed. |
| Client plans | Claude: any plan, with one custom connector on Free. ChatGPT: OpenAI lists full custom MCP support on Business and Enterprise/Edu and read/fetch only on Pro. |
From Thrad’s advertiser API reference (authentication, campaigns, assets, insights) and its pricing page, checked Nov 8, 2026. The deposit and review rules also appear in the tool description Ryze AI uses for thrads__write. The $10 deposit is a Thrad charge, not a Ryze AI price.
08 · Approvals and safety
How you keep control of spend
Approvals in Claude
Under Customize, Connectors, Ryze AI, Tool permissions, leave the read tools on automatic and set write and delete to Needs approval. Claude then shows each change and waits.
Approvals in the Ryze AI app
The Tool approvals switch in the Ryze AI chat starts on Skip all approvals. Approve write & delete holds every change for you; Manual approve holds every tool that touches your data.
Campaign creation costs money
Creating a campaign makes Thrad charge a $10 deposit, so keep thrads__write on approval until you trust a prompt. A periodic budget also has no lifetime ceiling.
Archive kept separate
Only thrads__delete archives, so you can allow edits and keep removals on approval. Archiving a campaign cannot be undone.
Name the account
With several Thrad accounts in one workspace, the primary one answers unless the prompt names another.
Policies
Read the MCP privacy policy, the MCP terms, the security policy and the permissions guide.
09 · Errors and fixes
Thrad connection errors and what they mean
| Message or symptom | Cause | Fix |
|---|---|---|
| Thrad tools are not in Claude or ChatGPT | Thrad was connected after the connector was added, and the client kept the old tool list. | In Claude, remove the Ryze AI connector under Customize > Connectors, add it again and start a new chat. In ChatGPT, refresh or re-add it, then open a new conversation. |
| Ryze AI rejects the Thrad key | The key was copied in part or is no longer active. | Copy the full ak_ key again from Settings > API keys in the Thrad Platform and paste it into the Thrad card. |
| The Thrad connection stopped working | A new key was created in Thrad, so the stored key no longer works. | Click Reconnect on the Thrad card and paste the new key. |
| Creative upload fails with a 404 | thrads__uploadFromUrl is expected to fail while Thrad's upload endpoint returns 404; Thrad's docs say assets are read-only over the API. | Create the asset in the Thrad Platform or a product feed, then ask the agent to use it in an ad. |
| Answers come from the wrong Thrad account | Several accounts are connected and the primary one answered. | Name the account in the prompt, or star the right one under View on the Thrad card. |
| Tools reply that a subscription is required | The workspace has no active Ryze AI plan or trial. | Start a plan or trial under Organization Settings > Billing, then retry. |
| 400 billing_not_configured | Reported by Thrad when a campaign is created and the organization has no default card. | Add a default card to the organization in Thrad, then ask again. |
| 402 card_declined | Thrad could not charge the $10 deposit, and the campaign is removed. | Use another card in Thrad, then recreate the campaign. |
| 400 campaign_not_approved | Activation was requested while the campaign is still in review or was rejected. | Ask the agent to read the review status and wait for approved. |
| 429 rate_limit_exceeded | The key passed 1,000 requests an hour, or 60 campaign creations an hour. | Wait for the window to pass and ask for fewer, larger reads. |
| Archived campaign cannot be reopened | Archiving a campaign is irreversible. | Create a new campaign. Archived ad groups and ads can be brought back with activate. |
The first six rows are Ryze AI connections. The rest are error codes that Thrad documents for its advertiser API. More Ryze AI answers are in the integrations FAQ.
10 · FAQ
Thrad AI MCP questions
What is Thrad AI MCP?
Thrad does not publish an MCP server; its documentation lists an advertiser API, a publisher API and agent skills. Ryze AI runs a hosted MCP server with 5 Thrad tools (read, insights, write, uploadFromUrl and delete) so Claude, ChatGPT and Cursor can manage Thrad campaigns, ad groups and ads and read insights.
What is Thrad?
Thrad describes itself as a DSP and SSP for LLMs. It scores ads against the intent of a prompt, runs a real-time auction and places the winning ad inside an AI response. Advertisers pay per thousand impressions (CPM) or per click (CPC), and the self-serve option has no minimum spend.
Can I advertise on ChatGPT through Thrad?
Thrad insights combine Thrad and ChatGPT (OpenAI Ads) supply, and you can filter by source. Ryze AI also has separate tools for OpenAI Ads itself, described on ChatGPT Ads MCP, and a guide to ads in ChatGPT. Which supply your ads reach depends on your Thrad account, so check the source split in the insights before you assume ChatGPT delivery.
How do I connect Thrad to Claude?
Create an ak_ API key under Settings, API keys in the Thrad Platform and paste it into the Thrad card on the Integrations page in Ryze AI. 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. If the tools do not show, remove and re-add the connector. Every client is covered in the setup section.
Does it work in ChatGPT?
Yes, with limits set by OpenAI. OpenAI documents custom MCP servers on ChatGPT web for Business and Enterprise/Edu, and read/fetch permissions only for Pro, so a Pro account can read Thrad data but not change it. Custom servers cannot be added on mobile.
What does it cost?
Adding the Ryze AI connector is free, but the tools need an active plan or trial: Paid Ads $89/mo with a 7-day free trial, or Agency $279/mo, with 30% off the first year on annual billing. See the pricing page. Thrad charges its own ad spend and a $10 deposit when a campaign is created. That deposit is a Thrad charge, not a Ryze AI price.
What happens when the AI creates a campaign?
Thrad submits the new campaign for review, and it does not serve until Thrad approves it. By Thrad's rule it also charges a $10 deposit to the organization's default card. Without a card the request fails with billing_not_configured, and a declined card returns card_declined. Keep the write tool on approval in Claude so you see each creation first.
Can it upload images for ads?
Not today. The thrads__uploadFromUrl tool is expected to fail because Thrad's upload call answers with a 404, and Thrad's docs say assets are read-only over its API. Create assets in the Thrad Platform or a product feed, and the agent can then use them in ads.
Can it delete campaigns?
It can archive them. thrads__delete archives a campaign, ad group or ad. Archiving a campaign is irreversible, while an archived ad group or ad can be brought back with activate. In Claude, set delete tools to Needs approval.
Is there a Thrad dashboard or Managed Campaigns in Ryze AI?
No. Thrad works in the Ryze AI chat and through the connector only. Ryze AI shows no Thrad dashboard, runs no Managed Campaigns for it and has no default-accounts picker, so name the account in your prompt when several are connected. Ryze AI is the best way to read Thrad next to Google Ads and Meta Ads in one chat, but it does not replace the Thrad Platform for assets and billing.
Why do the Thrad tools not show up in my client?
Claude keeps the tool list from the moment the connector is added. After connecting Thrad in Ryze AI, remove the Ryze AI connector under Customize, Connectors, add it again and start a new chat. In ChatGPT, refresh or re-add the connector and open a new conversation.
What are the Thrad API rate limits?
Thrad allows 1,000 requests per hour per API key, and 60 campaign creations per hour on top of that. Going over returns 429 with rate_limit_exceeded. Insights windows run up to 366 days, hourly windows up to 25 hours, and a page returns up to 2,000 rows.
Why did Thrad stop working after I made a new key?
Thrad allows one active key per organization, so a new key makes the stored one stop working in Ryze AI. Click Reconnect on the Thrad card and paste the new key.
11 · Compatibility
Where the Thrad tools run
12 · Related
Other integrations and guides
Changelog
Page checked Nov 8, 2026. First version. The Thrad tool list, setup steps and approval behavior were checked on this date against the Ryze AI app source and help center. Thrad API limits, review and deposit rules, key handling and pricing models were checked against docs.thrad.ai and thrad.ai. Sources: the Ryze AI help center Thrad page, docs.thrad.ai/advertisers (authentication, campaigns, assets, insights, overview), docs.thrad.ai/agent-skills, thrad.ai/resources/pricing, support.claude.com custom connectors, help.openai.com custom MCP servers and cursor.com/docs/mcp.