By Ira Bodnar, Ryze AI · Updated
Quick answer
To connect Antigravity to Thrad, create an API key in the Thrad Platform dashboard and paste it into the Thrad card in Ryze AI, then add a ryze entry with the serverUrl https://connector.get-ryze.ai/mcp to Antigravity's mcp_config.json and finish the Ryze AI sign-in.
- In the Thrad Platform dashboard create an API key under Settings > API keys
- In Ryze AI open Integrations, click Connect on the Thrad card and paste the key
- In Antigravity open MCP Servers, Manage MCP Servers, View raw config and add the ryze entry
- Complete the Ryze AI sign-in, click Allow connection and start a new chat
Before you start
- Google Antigravity. Google's MCP documentation for Antigravity names no plan. The IDE, the App and the CLI all read the same mcp_config.json format, so any of them works.
- A Thrad Platform account with an API key. Thrad's docs say keys are created in the Thrad Platform dashboard under Settings > API keys. A Thrad key starts with ak_ and an organization has one active key.
- A Ryze AI workspace on a plan or free trial. Connecting the connector is free and the tools need an active plan or 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.
How to connect Antigravity to Thrad
These steps are for the Antigravity IDE. Two happen in Thrad and Ryze AI, four in the editor. The App and the CLI use the same config entry and are covered below.
Create an API key in Thrad
In the Thrad Platform dashboard go to Settings > API keys, create a new key and copy it. It starts with ak_. Keep it ready to paste into Ryze AI, because creating another key later makes this one stop working.
Connect Thrad in Ryze AI
Create a Ryze AI account or sign in, open Integrations, click Connect on the Thrad card, paste the key into API key and click Continue. Ryze AI verifies it and the card shows Connected. To add another Thrad account, click View > Add one more account.
Open the raw MCP config in the Antigravity IDE
In the agent side panel of the editor, click the ... menu at the top and select MCP Servers. Click Manage MCP Servers, then View raw config. This opens mcp_config.json. The global file is ~/.gemini/config/mcp_config.json and a per-workspace file is .agents/mcp_config.json.
Add the ryze entry
Under mcpServers add an entry named ryze with the serverUrl https://connector.get-ryze.ai/mcp and save the file. There is no client ID or secret to enter, because Antigravity handles OAuth 2.0 with PKCE on its own for servers that support dynamic client registration, and the Ryze AI connector does.
Sign in to Ryze AI and allow the workspace
Complete the Ryze AI sign-in that Antigravity opens and click Allow connection, choosing the workspace that holds your Thrad connection.
Start a new chat and ask your first question
Open a new agent chat and ask: Show my Thrad ad account and list my campaigns with their status. Antigravity asks for approval before an MCP tool runs until you allow it, so approve the first call.
The Ryze AI help article for Thrad covers the Thrad side of the connection. There is no Ryze AI help page for Antigravity, and Ryze AI was not tested in it for this page.
Antigravity App
The Antigravity App keeps its MCP servers under Customizations. The App has a separate Authenticate button, so the sign-in works differently from the IDE:
- Click Customizations in the sidebar, then Installed, and scroll to MCP Servers.
- Click Copy Config File Path and add the ryze entry shown below to that mcp_config.json.
- Back in Customizations, Installed, MCP Servers, click Authenticate next to ryze.
- Complete the Ryze AI sign-in in the browser, copy the authorization code, paste it into Enter authorization code and click Submit.
The entry to add is the same in the IDE, the App and the CLI:
{
"mcpServers": {
"ryze": {
"serverUrl": "https://connector.get-ryze.ai/mcp"
}
}
}In the App, the Add MCP Server (+) button opens a list of catalog servers, so a custom URL such as this one goes into mcp_config.json by hand. Google's docs say remote servers must use Streamable HTTP; the legacy HTTP+SSE transport and the httpUrl field are not supported, while url also works in place of serverUrl. The OAuth redirect URI Antigravity uses is https://antigravity.google/oauth-callback.
Antigravity CLI
The Antigravity CLI reads the same files. Add the ryze entry to ~/.gemini/config/mcp_config.json or to <workspace>/.agents/mcp_config.json, then type /mcp in the prompt panel to open the MCP Manager, check the server status and reload the configuration.
Google's MCP page describes the Authenticate step only for the App. How the CLI starts an OAuth sign-in is not documented there, so this page gives no CLI sign-in steps. OAuth tokens are stored in ~/.gemini/antigravity/mcp_oauth_tokens.json and refreshed automatically.
Sources: Google's Antigravity MCP documentation, the Gemini CLI to Antigravity CLI update and the Ryze AI connector OAuth metadata. Checked November 15, 2026.
Other AI clients
The same URL works in other MCP clients. Thrad is connected once in Ryze AI, so nothing changes on the Thrad side.
Antigravity in general
For what Ryze AI does inside the client beyond Thrad, see Ryze AI in Antigravity. Thrad is connected once with the API key in Ryze AI, so nothing changes on the Thrad side when you switch clients.
ChatGPT
ChatGPT uses a custom MCP server with OAuth and has its own plan limits. See How to connect ChatGPT to Thrad.
Claude and other clients
In Claude, add the same URL under Customize > Connectors. For Claude Code, Cursor and the other clients, use the steps in the Ryze AI help center.
Thrad API key and limits
Thrad uses an API key instead of a sign-in screen, and Antigravity adds its own OAuth step for the Ryze AI connector. Four things decide what the agent can see and change.
- Where the key comes from
- Thrad's docs say keys are created in the Thrad Platform dashboard under Settings > API keys. If that page is not available to you, ask the person who runs your Thrad organization.
- One key per organization
- Thrad allows one active key per organization. If you create a new key in Thrad, the old key stops working and Ryze AI needs the new one through Reconnect on the Thrad card.
- Which accounts
- Several Thrad accounts can be connected to one Ryze AI workspace with View > Add one more account; a star marks the primary. Thrad has no Agent default accounts picker, so name the account in your prompt. Over MCP every thrads tool takes an optional connection_id.
- How Antigravity signs in
- Antigravity tries a manually set oauth.clientId first, then a Client ID Metadata Document if the server supports one, then dynamic client registration. The Ryze AI connector advertises dynamic client registration and no metadata document, so the third path applies and you enter nothing.
Limits that shape the answers
Thrad does not publish a scope list for its API keys. Its docs describe a Bearer token on every call to https://api.thrad.ai/v1. The first three rows come from Thrad's docs, the last three from Google's Antigravity docs.
| Area | Limit |
|---|---|
| 401 auth_required or invalid_api_key | Thrad: a missing, malformed, unknown, expired or revoked key returns 401, and the API does not say which. |
| 429 rate limit | Thrad: 1000 requests per hour per key on all /v1/ requests, and 60 per hour per key on campaign creation. |
| New campaigns | Thrad: every campaign created through the API is submitted for human review and starts as in_review. |
| Timeouts | Antigravity waits up to 5 minutes for a server to connect and list its tools and up to 3 minutes for each tool call. The timeoutSeconds setting changes both. |
| Tool loading | MCP tools load lazily by default: schemas are cached on disk and the agent reads them when needed. |
| Tool approval | An MCP tool without a configured rule runs in Ask mode, so each call needs your approval until you allow it in the policy configuration. |
Sources: Thrad authentication docs, Thrad campaigns docs, Antigravity MCP documentation and the Ryze AI Thrad guide.
Removing access
To remove access, click View on the Thrad card in Ryze AI and disconnect it, or rotate or revoke the key in the Thrad Platform dashboard. In Antigravity, delete the ryze entry from mcp_config.json. Stored OAuth tokens live in ~/.gemini/antigravity/mcp_oauth_tokens.json.
What Antigravity can do in Thrad
The Ryze AI connector exposes 5 Thrad tools: 2 read, 2 write and 1 delete. Their names start with thrads__, the provider slug for Thrad.
| Tool (thrads__ prefix) | 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 combining 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 an ad 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. |
In Antigravity, an MCP tool with no configured rule runs in Ask mode, so every call waits for your approval. Google's docs give the rule forms mcp(server/tool) for one tool and mcp(server/*) for all tools on a server. Allow the 2 read tools if you like, and leave thrads__write, thrads__uploadFromUrl and thrads__delete in Ask mode, because they change campaigns that can spend money. In the Ryze AI chat, Tool approvals starts on Skip all approvals; you can switch it in the chat composer to Approve write & delete or Manual approve.
First 3 prompts to run
1. Account and campaign status
Show my Thrad ad account, then list every campaign with its ad groups and whether each one is active or paused.
Tools used: thrads__read
What comes back: The ad account details and the campaign and ad group tree with their current status.
2. Thrad against ChatGPT supply
For the last 30 days, give me impressions, clicks, spend, CTR, CPC and CPM for my Thrad account, split by source so I can compare Thrad supply with ChatGPT supply.
Tools used: thrads__insights
What comes back: Aggregated metrics that combine Thrad and ChatGPT (OpenAI Ads) supply, filterable by source.
3. Pause an ad group
Pause my ad group called Spring offer and then read it back so I can confirm its status. Leave the rest of the campaign as it is.
Tools used: thrads__write, then thrads__read
What comes back: The ad group set to paused and its current status. Activating it again works the same way.
Each answer comes from your own Thrad account, so this page describes what comes back instead of showing sample numbers. Archiving goes through the separate delete tool, and targeting is country-level only. Your Ryze AI plan, the approval settings above and your Thrad key decide what runs.
Ryze AI vs Thrad's REST API
Thrad documents a REST API for advertisers. Its advertiser docs mention no MCP server of its own, and Google's Antigravity docs describe a catalog list in the App without naming Thrad in it. The routes below are the realistic ones.
| Option | Setup | Thrad coverage | Works in |
|---|---|---|---|
| Ryze AI connector | Thrad API key pasted into Ryze AI, then one serverUrl entry in mcp_config.json | 5 tools: read, insights, write, image upload from URL and archive | Antigravity IDE, App and CLI, plus Claude, ChatGPT and other MCP clients |
| Antigravity MCP catalog | Add MCP Server (+) in the App, or Install in the IDE, opens a list of catalog servers | Depends on what the list offers. This page did not verify a Thrad entry in it | Antigravity |
| Thrad advertiser REST API | Bearer token with an ak_ key against https://api.thrad.ai/v1, called from your own code | Ad account, campaigns, ad groups, ads, assets and insights | Your own scripts and tools |
If you build your own tooling, Thrad's REST API gives you full control. The Ryze AI connector fits when you want Antigravity working with Thrad without writing code, on one MCP URL that other Ryze AI platforms share. Thrad's docs also say that creating a campaign charges a deposit. That is a Thrad charge and is separate from any Ryze AI price.
Sources: Thrad advertiser docs, Antigravity MCP documentation, Ryze AI Thrad guide. Checked November 15, 2026.
Errors and fixes
- The server never finishes connecting
- Antigravity waits up to 5 minutes for a server to connect and list its tools. Check that mcp_config.json is valid JSON, that the entry uses serverUrl (or url) and not httpUrl, and reload the configuration.
- Authenticate does nothing in the App
- Complete the Ryze AI sign-in in the browser, copy the authorization code it shows, paste it into Enter authorization code and click Submit.
- The Thrad tools do not appear
- Tool lists can be cached from before you connected Thrad. Remove the ryze entry, add it again, then start a new chat. Also check that the Thrad card in Ryze AI shows Connected.
- The Thrad connection stopped working
- Thrad keeps one active key per organization, so creating a new key invalidates the old one. Copy the current key from the Thrad Platform dashboard and use Reconnect on the Thrad card in Ryze AI.
- Ryze AI says the key is invalid
- Check that you pasted the whole ak_ key. If it was lost, create a new key in Thrad and paste that one.
- Image upload fails with a 404
- Thrad currently answers the upload call with a 404. Use an asset that already exists in your Thrad account when you create an ad.
- A new campaign cannot be activated
- Thrad submits every new campaign for human review. Wait for approval, then ask Antigravity to activate it.
- A campaign cannot be brought back
- Archiving a campaign is terminal. An archived ad group or ad can be activated again.
- Thrad returns a rate limit error
- Thrad allows 1000 requests per hour per key and 60 campaign creations per hour per key. Wait and retry with fewer requests.
- Every tool call asks for approval
- That is Antigravity's Ask mode for MCP tools without a rule. Allow chosen tools in the policy configuration, using the mcp(server/tool) form.
- The tools say a subscription is required
- The Thrad tools need an active Ryze AI plan or free trial. Start the trial, then retry.
Frequently asked questions
How do I connect Antigravity to Thrad?
Create an API key in the Thrad Platform dashboard under Settings > API keys, then in Ryze AI open Integrations, click Connect on the Thrad card and paste the key. Then add a ryze entry with the serverUrl https://connector.get-ryze.ai/mcp to Antigravity's mcp_config.json and complete the Ryze AI sign-in.
Where is the Antigravity MCP config file?
The global file is ~/.gemini/config/mcp_config.json and a workspace file is .agents/mcp_config.json. In the IDE, open the ... menu in the agent panel, then MCP Servers, Manage MCP Servers and View raw config.
Which Antigravity plan do I need for MCP?
Google's Antigravity MCP documentation names no plan. The setup works the same in the IDE, the App and the CLI, apart from how the sign-in starts.
Does Antigravity need a client ID for the Ryze AI connector?
No. Antigravity runs OAuth 2.0 with PKCE and registers itself with servers that support dynamic client registration, which the Ryze AI connector does. The redirect URI is https://antigravity.google/oauth-callback.
Does Thrad have its own MCP server for Antigravity?
Thrad's advertiser documentation describes a REST API at https://api.thrad.ai/v1 with Bearer ak_ keys and mentions no MCP server. Ryze AI is the best way to give Antigravity Thrad tools without writing code, though its image upload tool currently fails and the tools need a Ryze AI plan or trial.
Can Antigravity change my Thrad campaigns?
Yes. Through Ryze AI it can create and update campaigns, ad groups and ads, activate or pause them, and archive them through a separate delete tool. New campaigns are submitted for Thrad's review before they go live.
How do I require approval before Antigravity changes a campaign?
Antigravity runs an MCP tool without a configured rule in Ask mode, so each call waits for you. Keep the write and delete tools in Ask mode and allow only the read tools with the mcp(server/tool) rule form. In the Ryze AI chat, Tool approvals starts on Skip all approvals and can be switched to Approve write & delete.
Can Antigravity upload ad images to Thrad?
Not reliably. Thrad currently answers the image upload call with a 404, so ads reference assets that already exist in your Thrad account.
Can I undo archiving a Thrad campaign?
No. Archiving a campaign is irreversible. Archiving an ad group or ad deactivates it and it can be activated again.
Can I connect more than one Thrad account?
Yes. Click View > Add one more account on the Thrad card; a star marks the primary. Thrad has no Agent default accounts picker, so name the account in your prompt.
Does the Antigravity CLI work with the connector?
The CLI reads the same mcp_config.json files, and /mcp opens the MCP Manager to check status and reload. Google does not document how the CLI starts an OAuth sign-in, so this guide gives no CLI sign-in steps, and Ryze AI was not tested in Antigravity.
How much does it cost to connect Antigravity to Thrad?
Connecting the connector is free, but the Thrad tools need an active Ryze AI plan or 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 bills its own campaign charges.