By Ira Bodnar, Ryze AI · Updated
Quick answer
To connect Perplexity to Thrad, create an API key in the Thrad Platform dashboard, paste it into the Thrad card in Ryze AI, then add https://connector.get-ryze.ai/mcp in Perplexity as a custom remote MCP connector with OAuth and enable it. Ryze AI sign-in was not tested inside Perplexity when this page was written.
- In Thrad open Settings, API keys and create a key that starts with ak_
- In Ryze AI open Integrations, click Connect on Thrad, paste the key and click Continue
- In Perplexity open Plugins, Add custom, Add MCP connector, choose Remote, and enter the name and URL
- Set Authentication to OAuth, tick the acknowledgement, click Add, then select the card to sign in to Ryze AI
Before you start
- A Perplexity plan that allows custom connectors. Perplexity's March 2026 changelog says Pro, Max and Enterprise subscribers can add a custom remote connector by MCP server URL. In an Enterprise organization, members can add one for their own account only if an administrator turns on Allow members to add custom connectors (off by default). Only administrators can add organization-wide connectors.
- A Thrad API key. Thrad creates keys in its Platform dashboard under Settings, API keys, and its docs say only organization owners and admins can create, rotate or revoke a key. Thrad allows one active key per organization.
- A Ryze AI workspace on a plan or free trial. Paid Ads is $89 per month with a 7-day free trial; Agency is $279 per month for agencies. Annual billing takes 30% off the first year. Connecting the Ryze AI connector is free, but the Thrad tools need an active plan or trial.
How to connect Perplexity to Thrad
Two steps happen in Thrad and Ryze AI, four in Perplexity. The connector URL is the same for every user.
Create a Thrad API key
In the Thrad Platform dashboard go to Settings, then API keys. Create a new key and copy it right away. Thrad keys start with ak_. If your role is not owner or admin, ask one of them to create it.
Connect Thrad in Ryze AI
Sign in to Ryze AI, open Integrations, click Connect on the Thrad card, paste the key into API key and click Continue. Ryze AI verifies the key and the card shows Connected. To add another Thrad account later, click View, then Add one more account.
Add the remote connector in Perplexity
In Perplexity open Plugins in the sidebar (or Customize, Connectors if Plugins is not shown). Open Add custom, then Add MCP connector, and select Remote. Enter the name Ryze AI and the MCP server URL https://connector.get-ryze.ai/mcp.
Set the advanced options
Under Advanced set Authentication to OAuth, Transport to Streamable HTTP and Network access to Public. Select the acknowledgement checkbox, then select Add.
Sign in to Ryze AI and enable the connector
Select the Ryze AI connector card on the Plugins page. Perplexity starts the Ryze AI sign-in; follow the sign-in screens, then enable the connector. If Ryze AI asks which workspace to use, choose the one that holds your Thrad connection.
Start a thread and ask your first question
Open a new thread with the connector enabled and ask: Show the Thrad campaigns in my account with their status.
The Ryze AI Thrad guide covers the Thrad side of the connection. Perplexity documents the form in its custom remote connectors article.
Perplexity Enterprise administrators
Perplexity Enterprise administrators have a separate path that makes the connector available to the whole organization. The steps below are from Perplexity's help article on custom remote connectors.
- Open Organization settings, then Connectors, and select Custom connector.
- Enter the name Ryze AI and the URL https://connector.get-ryze.ai/mcp, set the Advanced options as above (OAuth, Streamable HTTP, Public), select the acknowledgement checkbox and select Add.
- New organization connectors start turned off. Turn the connector on in Organization settings, Connectors.
- Choose whether the organization authenticates once or each member signs in on their own.
Each person who signs in needs access to a Ryze AI workspace that holds the Thrad connection. Perplexity's article also says a remote connector connected anywhere is connected for the account everywhere, including inside plugins.
Claude, ChatGPT and Cursor
The same URL works in other MCP clients. Thrad is connected once in Ryze AI, so the key does not change.
Claude
Anthropic lists custom connectors on Free, Pro, Max, Ultra, Team and Enterprise plans, with Free limited to one custom connector. The same URL goes into Customize, Connectors, Add custom connector. See the Claude guide for the full steps.
ChatGPT
OpenAI lists custom MCP servers with full support on ChatGPT Business and Enterprise/Edu, and read and fetch permissions only on Pro. Write tools such as thrads__write need the full support. See the ChatGPT guide for the steps.
Cursor
Cursor's MCP documentation names no plan, so the same URL works in the editor with the Thrad connection you made once in Ryze AI. See the Cursor guide for the config entry.
Thrad permissions and limits
Thrad has no OAuth screen in this setup. Ryze AI stores the API key you paste, and that key decides which Thrad data Perplexity can reach. Perplexity adds a second layer: its help article says your MCP server, not Perplexity, defines what a custom connector can access.
- Who can create the key
- Thrad's docs say only organization owners and admins can create, rotate or revoke a key, and each organization has one active key.
- What the key covers
- The key belongs to a Thrad organization. Anything the Ryze AI Thrad tools can do, Perplexity can ask for, so create it from an account whose reach you are comfortable sharing.
- Which Perplexity users
- A connector added on your own account is yours. An Enterprise administrator who adds an organization connector chooses between one shared sign-in and a sign-in per member.
Key and limit details
Thrad's pages checked for this guide do not list per-key scopes. These are the documented points about the key and about Thrad limits that apply to calls made through it.
| Topic | Detail |
|---|---|
| Key format | Thrad keys start with ak_ and go in an Authorization Bearer header on https://api.thrad.ai/v1 when you call Thrad directly. |
| Active keys | One active key per organization. Creating a new key means the old key stops working in Ryze AI until you use Reconnect. |
| Rotation | Thrad's docs describe a 30-minute grace period where the previous key stays valid after rotation. |
| Request limit | Thrad documents 1000 requests per hour per key, with campaign creation also capped at 60 requests per hour per key. Over the limit Thrad returns HTTP 429. |
| Review | New campaigns are submitted for Thrad's review before they go live. Thrad exposes a read-only review status of approved, in review or rejected. |
Sources: Thrad's authentication reference and advertiser overview, checked November 11, 2026.
Removing access
To remove access, revoke or rotate the key in the Thrad Platform dashboard under Settings, API keys. In Ryze AI, click View on the Thrad card to disconnect an account. In Perplexity, remove or turn off the Ryze AI connector on the Plugins page.
What Perplexity can do in Thrad
The Ryze AI connector exposes five Thrad tools. Each runs against the Thrad account you connected. Over MCP every thrads tool takes an optional connection_id, which matters when several Thrad accounts are connected.
| Tool | Type | What it does |
|---|---|---|
| thrads__read | Read | Reads any Thrad resource, such as the ad account, campaigns, ad groups, ads and assets. |
| thrads__insights | Read | Returns aggregated insights that combine Thrad and ChatGPT (OpenAI Ads) supply: impressions, clicks, spend, CTR, CPC and CPM. |
| thrads__write | Write | Creates or updates campaigns, ad groups and ads, and activates or pauses them. |
| thrads__uploadFromUrl | Write | Uploads an image from a URL to get a file id for a creative. Thrad currently answers this call with a 404, so use existing assets. |
| thrads__delete | Delete | Archives a campaign, ad group or ad. Archiving a campaign is irreversible. |
The Perplexity help article opened for this guide does not describe a per-tool approval setting, so do not assume Perplexity asks before a write or delete. In the Ryze AI chat the Tool approvals setting starts on Skip all approvals; you can switch it to Approve write & delete or Manual approve in the chat composer. If you want a confirmation step in Perplexity, say so in the prompt, for example: ask me to confirm before any change.
First 3 prompts to run
Run these in order. The first checks the connection, the second reads performance, the third makes a change. Thrad ads are cards or polls, and targeting is country-level only.
1. List campaigns and status
Using the Ryze AI connector, list my Thrad campaigns with name, status and review status, and group them by status.
Tools used: thrads__read
What comes back: A list of your Thrad campaigns grouped by status, built from your own account. An empty account returns an empty list.
2. Compare Thrad and ChatGPT supply
Pull Thrad insights for the last 30 days, split by source so Thrad and ChatGPT (OpenAI Ads) supply are separate, and show impressions, clicks, spend, CTR, CPC and CPM for each.
Tools used: thrads__insights
What comes back: One row per source with the six metrics, so you can see which supply produced the clicks and at what CPC and CPM.
3. Pause a campaign
Pause the Thrad campaign called [campaign name], then read it back and confirm its status. Ask me to confirm before you change anything.
Tools used: thrads__write, thrads__read
What comes back: A confirmation request, then the campaign status after the change. Pausing is reversible with activate; only archiving a campaign is permanent.
Each answer comes from your own accounts, so this page describes what comes back instead of showing sample numbers. Thrad charges for campaign creation are set by Thrad, so check its billing terms before you ask for a new campaign.
Ways to work with Thrad from Perplexity
Thrad's advertiser docs, checked November 11, 2026, describe a REST API at api.thrad.ai/v1 and do not mention an MCP server. Perplexity's own connector list is separate from this. That leaves three ways to work with Thrad from Perplexity.
| Option | Setup | Thrad coverage | Works in |
|---|---|---|---|
| Ryze AI connector | Thrad key pasted once in Ryze AI, then one remote connector URL in Perplexity | Read resources, insights across Thrad and ChatGPT supply, create and update campaigns, ad groups and ads, activate or pause, archive | Perplexity, Claude, ChatGPT, Cursor and other MCP clients |
| Thrad advertiser REST API | Send the ak_ key as a Bearer token to https://api.thrad.ai/v1 from your own code | Campaigns, ad groups, ads and insights, with the limits Thrad documents | Any code that can make HTTP requests |
| Thrad Platform dashboard | Sign in to Thrad and work in the web dashboard | Everything Thrad exposes in its interface | Browser |
If you run Thrad from a script or pipeline, call the REST API directly. A Perplexity thread is a fit for questions and small changes: reading campaigns, comparing supply and pausing a campaign. Ryze AI lists Thrad as chat only, so it does not appear in the Ads Performance dashboard or Managed Campaigns.
Sources: Perplexity custom remote connectors, Perplexity March 13, 2026 changelog, Thrad advertiser overview, Ryze AI Thrad guide. Checked November 11, 2026.
Errors and fixes
- Add stays disabled in Perplexity
- Perplexity lists missing required fields and the unticked acknowledgement checkbox as reasons. The name (64 characters at most) and an HTTPS MCP server URL are required.
- Perplexity shows no Add custom option
- Custom connectors are listed for Pro, Max and Enterprise. On Enterprise, a member needs an administrator to turn on Allow members to add custom connectors, which is off by default.
- The connector is added but does nothing
- Select the connector card on the Plugins page to sign in and enable it. Organization connectors also start turned off until an administrator turns them on.
- A key or header field is requested
- Perplexity's connector form has no field for custom request headers, and its API Key option does not say which header it sends. Use OAuth for Ryze AI.
- The Thrad card in Ryze AI says Reconnect
- Thrad allows one active key per organization. A new key created in Thrad stops the old one, so paste the new key through Reconnect.
- Thrad tools do not appear in Perplexity
- Confirm the Thrad card shows Connected in Ryze AI, then remove the Ryze AI connector in Perplexity, add it again and start a new thread. Ryze AI documents this fix for Claude and ChatGPT; Perplexity's page does not describe tool caching.
- Image upload fails
- thrads__uploadFromUrl is expected to fail today because Thrad returns a 404. Ask for ads that use assets already in the account.
- HTTP 429 from Thrad
- Thrad's documented limits are 1000 requests per hour per key and 60 campaign creations per hour per key. Wait and retry, and ask for fewer calls.
- Ryze AI says a subscription is required
- The Thrad tools need an active Ryze AI plan or free trial. Start the trial in Ryze AI, then retry.
Frequently asked questions
How do I connect Perplexity to Thrad?
Create an API key in the Thrad Platform dashboard under Settings, API keys, and paste it into the Thrad card in Ryze AI. Then in Perplexity open Plugins, Add custom, Add MCP connector, choose Remote, enter the name Ryze AI and the URL https://connector.get-ryze.ai/mcp, set Authentication to OAuth, select Add and select the connector card to sign in.
Does Thrad have a Perplexity connector or MCP server?
The Thrad advertiser docs checked on November 11, 2026 describe a REST API at api.thrad.ai/v1 and do not mention an MCP server. Perplexity accepts custom remote connectors by URL, and the Ryze AI connector supplies the MCP layer with five Thrad tools.
Which option should I use to run Thrad from Perplexity?
Ryze AI is the best way to manage Thrad ads from a Perplexity thread, with one caveat: Ryze AI sign-in was not tested inside Perplexity when this page was written. For scripts and pipelines, call Thrad's REST API directly.
Which Perplexity plan do I need?
Perplexity's March 2026 changelog says Pro, Max and Enterprise subscribers can add a custom remote connector. On Enterprise, members can add one for their own account only if an administrator turns on Allow members to add custom connectors, and only administrators can add organization-wide connectors.
Who can create the Thrad API key?
Thrad's docs say only organization owners and admins can create, rotate or revoke a key. Keys start with ak_ and each organization has one active key.
Can Perplexity create or change Thrad campaigns?
Yes, through the Ryze AI tools. It can create campaigns with ad groups and card or poll ads, update them, and activate or pause them. New campaigns are submitted for Thrad's review before they go live, and archiving goes through a separate delete tool.
Does Perplexity ask before it changes a Thrad campaign?
The Perplexity help article checked for this guide does not describe per-tool approvals. In the Ryze AI chat, Tool approvals starts on Skip all approvals and can be switched to Approve write & delete or Manual approve. In a Perplexity prompt you can ask for a confirmation before any change.
Can I connect more than one Thrad account?
Yes. In Ryze AI click View on the Thrad card and choose Add one more account; a star marks the primary. There is no default accounts picker, so name the account in your prompt. Over MCP every thrads tool takes an optional connection_id.
Can I upload images to Thrad from Perplexity?
Not reliably. The upload tool exists, but Thrad currently answers that call with a 404, so ads reference assets already in the account.
Why does Perplexity ask for OAuth instead of an API key?
The Ryze AI connector uses OAuth with dynamic client registration. Perplexity's connector form has no field for custom headers and its API Key option does not say which header it sends, so OAuth is the option to use. The Thrad key stays in Ryze AI.
How much does it cost to connect Perplexity to Thrad?
Adding the connector costs nothing, but the Thrad tools need an active Ryze AI plan or free trial. Paid Ads is $89 per month with a 7-day free trial and Agency is $279 per month. Annual billing takes 30% off the first year. Thrad and Perplexity have their own pricing.
How do I disconnect Thrad from Perplexity?
Revoke or rotate the key in the Thrad Platform dashboard, disconnect the account with View on the Thrad card in Ryze AI, or remove the Ryze AI connector on the Perplexity Plugins page.