By Ira Bodnar, Ryze AI · Updated
Quick answer
To connect Grok 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 as a Custom connector at grok.com/connectors and start a new conversation.
- 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
- At grok.com/connectors click New Connector, choose Custom and paste the URL
- Sign in on the Ryze AI page, choose workspaces, click Allow connection and open a new conversation
Before you start
- A Grok account. xAI says connectors on grok.com, including custom MCP connectors, are available to all Grok users. On Grok Business and Enterprise plans a team admin has to add the connector in the console first, then each member connects on grok.com/connectors.
- A Thrad account with an API key. Thrad creates the key in its Platform dashboard under Settings, API keys. Its docs say each organization has one active key.
- 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. Connecting the Ryze AI connector is free, but the Thrad tools need an active plan or trial.
How to connect Grok to Thrad on grok.com
Two steps happen in Thrad and Ryze AI, three in Grok. The connector URL is the same for every user.
Create a Thrad API key
Sign in to the Thrad Platform dashboard, go to Settings, then API keys, and create a new key. Copy it when it is shown. Thrad keys start with ak_.
Paste the key into Ryze AI
Create a Ryze AI account or sign in, open Integrations and click Connect on the Thrad card. Paste the key into API key and click Continue. Ryze AI verifies it and the card shows Connected.
Open grok.com/connectors and add a Custom connector
Go to grok.com/connectors, click New Connector and select Custom.
Enter the Ryze AI URL and sign in
Enter the MCP server URL https://connector.get-ryze.ai/mcp and complete the authentication. On the Ryze AI page, sign in, choose the workspaces Grok can use and click Allow connection. xAI describes this step only as completing any required authentication, and the Ryze AI connector on grok.com was not tested for this page.
Start a new conversation and ask your first question
Grok discovers the Ryze AI tools and makes them available in conversations. Open a new conversation and ask: Show my Thrad campaigns with their status and review status.
The Ryze AI help center page for Thrad covers the Thrad card, and the Ryze AI Grok guide covers the Grok side. xAI documents custom MCP connectors on grok.com.
Grok Business, Grok Bot and Grok Build
The same URL works on the other Grok surfaces. Thrad is connected once in Ryze AI, so nothing changes on the Thrad side.
Grok Business and Enterprise (admin)
On a team plan the connector is added once by an admin, and members then connect their own accounts.
- Log in to console.x.ai, select the team and go to Grok Business, Connectors.
- Click + Add Connector, select Other and enter https://connector.get-ryze.ai/mcp.
- Complete any required authentication. Adding connectors needs Team Read-Write permissions.
- Team members then connect their own accounts on grok.com/connectors.
Grok Bot
The Ryze AI help center lists Ryze AI as an app in Grok Bot. xAI's public docs do not list it and this was not verified, so if the search below finds nothing, ask the Bot to add the URL https://connector.get-ryze.ai/mcp as a custom MCP server. If you added Ryze AI as a custom server earlier and then add the catalog app, uninstall the older copy to avoid duplicate tools.
- In Grok Bot open Connect apps from the sidebar (mobile app: tap your avatar at the top left, then Connect apps).
- Type Ryze AI in Search across apps and skills, open Ryze AI (developer: Ryze AI) and click Add.
- Your browser opens Ryze AI: sign in, choose workspaces and click Allow connection.
- When Authorization complete appears, click Open Grok Bot or Return to Grok Bot.
- Start a new chat and type @ to attach the app to a task.
Grok Build CLI
Grok Build adds remote HTTP MCP servers from the terminal and handles OAuth itself.
- Run the command below to register the server.
- The browser OAuth flow starts on first use. Complete the Ryze AI sign-in.
- In the TUI, /mcps opens the MCP tab, where i authenticates an OAuth server.
grok mcp add --transport http ryze https://connector.get-ryze.ai/mcpIn Grok Build, OAuth tokens are stored in ~/.grok/mcp_credentials.json and tools are namespaced as <server>__<tool>, so with the server named ryze a Thrad tool appears as ryze__thrads__read. In Grok Bot, app connections are account-wide and available to every Bot you run, and a team connector policy can show an app as Disabled by team admin.
Claude, ChatGPT and Cursor
The same URL works in other MCP clients. Thrad is connected once in Ryze AI, so nothing changes on the Thrad side.
Claude
Open Customize, Connectors, choose Add custom connector and enter https://connector.get-ryze.ai/mcp. Claude has its own guide for Thrad, linked under related guides.
ChatGPT
OpenAI lists custom MCP servers on ChatGPT Business and Enterprise/Edu web workspaces; Pro users get read and fetch permissions only, so Thrad write tools are not available there. Open Plugins, choose Add custom MCP server, enter the URL and choose OAuth.
Cursor
Add the server to mcp.json, then complete the Ryze AI sign-in when Cursor asks.
{ "mcpServers": { "ryze": { "url": "https://connector.get-ryze.ai/mcp" } } }Thrad key and permissions
Thrad has no OAuth screen for this connection. Ryze AI stores the API key you paste, and the key decides what Grok can see. Four points matter.
- One key per organization
- Thrad allows one active key per organization. Creating a new key in Thrad makes the old one stop working, so the Thrad card in Ryze AI needs Reconnect with the new key. If other tools use the same key, replace it there too.
- Which account Grok uses
- One key is one Thrad organization. Add more Thrad accounts to the same Ryze AI workspace under View, Add one more account; a star marks the primary. Ryze AI has no default accounts picker for Thrad, so name the account in your prompt. Over MCP every Thrad tool takes an optional connection_id.
- Who can add the connector in Grok
- Any Grok user can add a custom connector on grok.com. On Grok Business and Enterprise, adding or removing connectors in the console needs Team Read-Write permissions.
- Public reachability
- xAI requires a custom MCP server on grok.com to be reachable over the public internet. The Ryze AI URL is, so no tunnel is needed.
What is documented about the key
Thrad's advertiser docs describe one kind of credential and the Ryze AI help center describes the card. These are the documented points.
| Topic | What is documented |
|---|---|
| Key format | Keys start with ak_ and are sent as a Bearer token on the Authorization header to https://api.thrad.ai/v1. |
| Where it is created | Thrad Platform dashboard, Settings, API keys. |
| Active keys | One per organization. |
| Targeting | Country level only, per the write tool description. |
| New campaigns | Submitted for Thrad's review before they go live. |
| Campaign billing | The write tool description says campaign creation needs a default card on the Thrad organization and that Thrad charges a $10 deposit. That is a Thrad charge, not a Ryze AI price. |
Sources: Thrad's Advertiser API overview and the Ryze AI help center page for Thrad.
Removing access
To remove access, click View on the Thrad card in Ryze AI and disconnect the account, and replace or revoke the key in Thrad if you want it dead everywhere. In Grok, open grok.com/connectors and remove the Ryze AI connector; in Grok Build remove the ryze server from your MCP configuration.
What Grok can do in Thrad
The Ryze AI connector exposes five Thrad tools. They are the same in every Grok surface.
| 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. New campaigns are submitted for Thrad's review. |
| 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 existing assets are used instead. |
| thrads__delete | Delete | Archives a campaign, ad group or ad. Archiving a campaign is irreversible; an ad group or ad can be brought back with activate. |
The xAI pages checked do not describe a per-tool approval setting for custom connectors, so do not assume Grok asks before it changes anything. Ask Grok to confirm before it activates or archives, and review what it plans first. In the Ryze AI chat, the Tool approvals setting starts on Skip all approvals and can be switched to Approve write & delete or Manual approve.
First 3 prompts to run
Thrad runs ads on its own supply and on ChatGPT (OpenAI Ads) supply, and the insights tool returns both together. The prompts below use words Thrad and the tools use, and each answer comes from your own account.
1. List campaigns and their state
Show my Thrad campaigns with name and status, and tell me which ones are waiting for Thrad's review.
Tools used: thrads__read
What comes back: A list of your Thrad campaigns with their status and review state.
2. Thrad against ChatGPT supply
Pull Thrad insights for the last 30 days, split by source, and show impressions, clicks, spend, CTR, CPC and CPM for each source.
Tools used: thrads__insights
What comes back: One row per source with the six metrics. You can then ask which source costs less per click.
3. Pause an ad group
Pause the Thrad ad group named in my last message, then confirm its status. Ask me before you change anything else.
Tools used: thrads__read, thrads__write
What comes back: The ad group with its new paused status. Name the account in the prompt if more than one Thrad account is connected.
A prompt that asks for something the tools do not cover, such as targeting below country level, comes back with a limit instead of a result.
Ryze AI vs Thrad's REST API
Thrad's documentation describes a REST API for advertisers and does not mention an MCP server. xAI documents custom MCP connectors in Grok. So the options are:
| Option | Setup | Thrad coverage | Works in |
|---|---|---|---|
| Ryze AI connector | Thrad API key pasted into Ryze AI, then one Custom connector URL in Grok | Read, insights, create and update, activate and pause, archive. Five tools; image upload currently returns a 404 | grok.com, Grok Business, Grok Bot, Grok Build, Claude, ChatGPT, Cursor |
| 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, assets and insights over plain REST, with money in integer micros | Any code that can make HTTP requests |
For a script or pipeline, call Thrad's REST API directly. For asking Grok about campaigns in plain language, the Ryze AI connector provides the MCP layer. Thrad's REST reference covers any field the five connector tools do not describe.
Sources: Thrad Advertiser API overview, Thrad docs index, xAI connectors, xAI connector management, Grok Build MCP servers, Grok Bot apps, Ryze AI Grok guide. Checked November 11, 2026.
Thrad and Grok errors and fixes
- Ryze AI rejects the key
- Check that you copied the whole ak_ key and that it is the active one. Create a fresh key in Settings, API keys and paste it again.
- Thrad was working and then stopped
- A new key was created in Thrad, which stops the old one. Click Reconnect on the Thrad card in Ryze AI and paste the new key.
- Thrad tools do not appear in Grok
- Grok discovers the tools when it connects. If you connected Thrad in Ryze AI afterwards, remove the connector at grok.com/connectors, add it again and start a new conversation.
- The connector is missing on a Business or Enterprise team
- An admin has to add it first under Grok Business, Connectors in console.x.ai, which needs Team Read-Write permissions. Members then connect on grok.com/connectors.
- Ryze AI is not found in Grok Bot
- xAI's public docs do not list it. Ask the Bot to add https://connector.get-ryze.ai/mcp as a custom MCP server. If the app shows Disabled by team admin, a team connector policy blocks it.
- Duplicate Thrad tools in Grok Bot
- Uninstall the copy you added earlier as a custom MCP server and keep one.
- Image upload fails
- thrads__uploadFromUrl currently gets a 404 from Thrad. Ask Grok to build ads from assets that already exist in the account.
- A campaign cannot be brought back
- Archiving a campaign is terminal. Pause it instead when you may want it back.
- Grok says a subscription is required
- The Thrad tools need an active Ryze AI plan or free trial. Start the trial or update the card under Organization Settings, Billing, then retry.
Frequently asked questions
How do I connect Grok to Thrad?
Create an API key in the Thrad Platform dashboard under Settings, API keys, then open Integrations in Ryze AI, click Connect on Thrad and paste the key. At grok.com/connectors click New Connector, select Custom, enter https://connector.get-ryze.ai/mcp, complete the sign-in and start a new conversation.
Does Thrad have its own Grok connector or MCP server?
The Thrad docs checked on November 11, 2026 describe a REST API for advertisers at api.thrad.ai/v1 and do not mention an MCP server. Ryze AI supplies the MCP layer: its connector gives Grok five Thrad tools through one URL.
Which way should I connect Grok to Thrad?
Ryze AI is the best way to run Thrad from Grok for chat-based work such as reading campaigns, comparing Thrad and ChatGPT supply and pausing ads, though a script that calls Thrad's REST API directly suits scheduled pipelines better. The connector costs nothing; the Thrad tools need a Ryze AI plan or trial.
What do I need in Thrad?
A Thrad API key that starts with ak_, created under Settings, API keys in the Thrad Platform dashboard. Each Thrad organization has one active key, so replacing it in Thrad means clicking Reconnect on the Thrad card in Ryze AI.
Which Grok plan do I need?
xAI says connectors on grok.com, including custom MCP connectors, are available to all Grok users. On Grok Business and Enterprise a team admin adds the connector in the console first. Grok Bot is included in The X Subscription Premium, Super and Ultra plans; the Plus plan does not include it.
Is Ryze AI built into Grok Bot?
The Ryze AI help center and app say Ryze AI is an app in Grok Bot's Connect apps. xAI's public docs do not list it and this was not verified. If search does not find it, ask the Bot to add https://connector.get-ryze.ai/mcp as a custom MCP server.
Can Grok edit or archive Thrad campaigns?
Yes. Through Ryze AI, Grok can create and update campaigns, ad groups and ads, activate or pause them, and archive them when you ask. Archiving a campaign cannot be reversed. xAI's docs checked do not describe a per-tool approval setting, so ask Grok to confirm before it changes anything.
Can I connect more than one Thrad account?
Yes. Click View on the Thrad card in Ryze AI and choose Add one more account. A star marks the primary. Ryze AI has no default accounts picker for Thrad, so name the account in your prompt.
Does this work in Grok Build, the CLI?
Yes. Run grok mcp add --transport http ryze https://connector.get-ryze.ai/mcp, then complete the browser sign-in on first use. In the TUI, /mcps opens the MCP tab, where i authenticates an OAuth server.
Why do the Thrad tools not show up in Grok?
If you connected Thrad in Ryze AI after adding the connector, remove the Ryze AI connector, add it again and open a new conversation. Also confirm the Thrad card in Ryze AI shows Connected.
Why does Thrad image upload fail?
Thrad currently answers the upload call with a 404, so ads reference assets that already exist in the account. Do not rely on image upload through the connector.
How much does it cost?
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's own billing for campaigns is separate.