How to connect Antigravity to Thrad

Paste a Thrad API key into Ryze AI once, add one MCP URL to Google Antigravity, then ask about Thrad campaigns, ads and delivery from the agent panel.

Your MCP URL
https://connector.get-ryze.ai/mcp

Copies the link. Paste it as the serverUrl of the ryze entry in Antigravity mcp_config.json. See the steps

See pricing

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.

  1. In the Thrad Platform dashboard create an API key under Settings > API keys
  2. In Ryze AI open Integrations, click Connect on the Thrad card and paste the key
  3. In Antigravity open MCP Servers, Manage MCP Servers, View raw config and add the ryze entry
  4. 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.

  1. 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.

  2. 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.

  3. 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.

  4. 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.

  5. 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.

  6. 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:

  1. Click Customizations in the sidebar, then Installed, and scroll to MCP Servers.
  2. Click Copy Config File Path and add the ryze entry shown below to that mcp_config.json.
  3. Back in Customizations, Installed, MCP Servers, click Authenticate next to ryze.
  4. 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.

AreaLimit
401 auth_required or invalid_api_keyThrad: a missing, malformed, unknown, expired or revoked key returns 401, and the API does not say which.
429 rate limitThrad: 1000 requests per hour per key on all /v1/ requests, and 60 per hour per key on campaign creation.
New campaignsThrad: every campaign created through the API is submitted for human review and starts as in_review.
TimeoutsAntigravity 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 loadingMCP tools load lazily by default: schemas are cached on disk and the agent reads them when needed.
Tool approvalAn 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)TypeWhat it does
thrads__readReadReads any Thrad resource, such as the ad account, campaigns, ad groups, ads and assets.
thrads__insightsReadReturns aggregated insights combining Thrad and ChatGPT (OpenAI Ads) supply: impressions, clicks, spend, CTR, CPC and CPM.
thrads__writeWriteCreates or updates campaigns, ad groups and ads, and activates or pauses them.
thrads__uploadFromUrlWriteUploads 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__deleteDeleteArchives 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.

OptionSetupThrad coverageWorks in
Ryze AI connectorThrad API key pasted into Ryze AI, then one serverUrl entry in mcp_config.json5 tools: read, insights, write, image upload from URL and archiveAntigravity IDE, App and CLI, plus Claude, ChatGPT and other MCP clients
Antigravity MCP catalogAdd MCP Server (+) in the App, or Install in the IDE, opens a list of catalog serversDepends on what the list offers. This page did not verify a Thrad entry in itAntigravity
Thrad advertiser REST APIBearer token with an ak_ key against https://api.thrad.ai/v1, called from your own codeAd account, campaigns, ad groups, ads, assets and insightsYour 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.

Connect Thrad to Antigravity

Connecting is free and the Thrad 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.

Thrad with Ryze AI

Need help? Read the Ryze AI Thrad guide or email Ryze AI support.