How to connect Hermes Agent to Thrad

Paste a Thrad API key into Ryze AI, add one MCP URL to ~/.hermes/config.yaml, sign in with hermes mcp login, then ask Hermes Agent about Thrad campaigns, ads and insights.

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

Copies the connector URL for the config.yaml entry. See the steps

See pricing

By Ira Bodnar, Ryze AI · Updated · How this guide was tested, November 17, 2026 (documentation check, no calls run)

Quick answer

The main way to connect Hermes Agent to Thrad is the Ryze AI connector. Create a Thrad API key and paste it into the Thrad card in Ryze AI. Then add https://connector.get-ryze.ai/mcp under mcp_servers in ~/.hermes/config.yaml with auth: oauth, run hermes mcp login ryze, click Allow connection on the Ryze AI page and run /reload-mcp or start a new session. Hermes Agent then has 5 Thrad tools: 2 that read, 2 that write and 1 that archives.

  1. In the Thrad Platform dashboard open Settings > API keys, create a key and copy it (it starts with ak_)
  2. In Ryze AI open Integrations, click Connect on the Thrad card, paste the key and click Continue
  3. Add a ryze entry with the connector URL and auth: oauth under mcp_servers in ~/.hermes/config.yaml
  4. Run hermes mcp login ryze, click Allow connection on the Ryze AI page, then run /reload-mcp

Hermes Agent to Thrad at a glance

FactDetail
Main way to connectThe Ryze AI connector, saved in Hermes Agent as a remote MCP server named ryze
Server addresshttps://connector.get-ryze.ai/mcp, set as url: under mcp_servers in ~/.hermes/config.yaml
Sign-inOAuth with auth: oauth, completed by hermes mcp login ryze. A Ryze AI API key in an Authorization header is the other route
Thrad tools5 in all: 2 read, 2 write and 1 delete. One of the write tools, thrads__uploadFromUrl, is expected to fail today
Can it change thingsYes. It creates and updates campaigns, ad groups and ads, activates or pauses them, and archives them. New campaigns go to Thrad for review before they run
Other data in the same chatThe same connector serves the other platforms connected in your Ryze AI workspace, but Thrad is listed as chat only, with no Managed Campaigns or Ads Performance dashboard
Hermes Agent planNone to buy. Hermes Agent is open source and self-hosted, and its GitHub repository lists the MIT license
Ryze AI pricePaid Ads is $89 per month with a 7-day free trial. Connecting is free; the tools need an active plan or trial
Thrad's own option for Hermes AgentNone for an ad account. Thrad publishes no MCP server for campaigns, ads or insights. Its documentation host does answer as a read-only docs MCP server at https://docs.thrad.ai/mcp
Last testedNo Thrad call was run for this guide and nothing was run inside Hermes Agent. Pages were read on November 14 and November 17, 2026

Before you start

  • Hermes Agent. It is open source and self-hosted by Nous Research, with no plan tier. You need a terminal on the machine that runs it and write access to ~/.hermes/config.yaml.
  • A Thrad API key. Thrad's documentation says only organization owners and admins can create, rotate or revoke a key. The key starts with ak_, and Thrad allows one active key per organization. The full secret is shown once, so copy it when you create it.
  • A Ryze AI workspace on a plan or free trial. Paid Ads is $89 per month with a 7-day free trial. Connecting is free; the Thrad tools need an active plan or trial.
  • A note on testing. Ryze AI has no help-center page for Hermes Agent and has not tested the connector there. The steps below follow Nous Research's MCP documentation for remote servers that use OAuth, as read on November 17, 2026.

How to connect Hermes Agent to Thrad

Two steps happen in Thrad and Ryze AI, the rest in Hermes Agent. The connector URL is the same for every user.

  1. Create a Thrad API key

    In the Thrad Platform dashboard, go to Settings > API keys, create a new key and copy it. It starts with ak_. If your organization already has an active key, creating a new one makes the old key stop working in Ryze AI until you replace it through Reconnect.

  2. Connect Thrad in 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. To add another Thrad account, click View > Add one more account.

  3. Add the connector to config.yaml

    Open ~/.hermes/config.yaml and add a ryze entry under mcp_servers with url set to https://connector.get-ryze.ai/mcp and auth set to oauth, as in the block below. Do this before signing in. Editing config.yaml inside a running session reloads MCP with a 30-second timeout, which is too short for an interactive OAuth flow.

    mcp_servers: ryze: url: "https://connector.get-ryze.ai/mcp" auth: oauth
  4. Sign in with hermes mcp login

    Run: hermes mcp login ryze. Hermes Agent prints an authorize URL and opens the browser when it can. Sign in on the Ryze AI page if asked, choose the workspace that holds your Thrad connection and click Allow connection.

  5. Finish the sign-in on a headless host if needed

    On a server without a browser, open the printed authorize URL on another machine. The redirect URL can be pasted back at the prompt instead of using a local browser, so copy the address the browser ends on and paste it there.

  6. Reload and ask your first question

    Start a new session or run /reload-mcp to refresh the tool list. Then ask: Show my Thrad ad account and list every campaign with its status and review status. If the tools do not appear, refresh the Ryze AI connector and start a new session.

The Ryze AI help center article for Thrad covers the Thrad side of the connection. The Hermes Agent side is covered by its MCP guide and GitHub repository.

Sources: Hermes Agent: MCP configuration, Hermes Agent on GitHub, Thrad authentication (checked November 17, 2026).

config.yaml, hermes mcp login and API key

config.yaml with OAuth

mcp_servers: ryze: url: "https://connector.get-ryze.ai/mcp" auth: oauth

This is the flow in the steps above. The entry name ryze is yours to choose, and Hermes Agent prefixes the tools it finds with mcp_ and that name. hermes mcp login ryze runs the authorization and Hermes Agent caches the tokens at ~/.hermes/mcp-tokens/ryze.json, reusing them until a refresh fails. hermes mcp test ryze checks the connection, and hermes mcp configure ryze lets you pick which tools stay on.

A Ryze AI API key instead of OAuth

mcp_servers: ryze: url: "https://connector.get-ryze.ai/mcp" headers: Authorization: "Bearer ${RYZE_API_KEY}"

Leave out auth: oauth and send the key as a bearer header. Put RYZE_API_KEY, the rk_live_ key from Ryze AI, in ~/.hermes/.env instead of writing it into config.yaml, then run /reload-mcp. This route needs no browser, which suits a server you reach only over SSH. It is a different key from the Thrad ak_ key, which goes into the Thrad card in Ryze AI.

Limit the tools with include and exclude

mcp_servers: ryze: url: "https://connector.get-ryze.ai/mcp" auth: oauth tools: exclude: ["thrads__write", "thrads__delete", "thrads__uploadFromUrl"]

tools.include is a whitelist and tools.exclude a blacklist. The block above leaves the 2 read tools and drops the 3 that change an ad account. After saving, run /reload-mcp and ask Hermes Agent to list its Ryze AI tools to confirm which remain. Whether the filter matches the bare tool name or the mcp_-prefixed name was not tested, so check the list.

Transport and timeouts

Hermes Agent's MCP page says each server entry accepts timeout for tool calls and connect_timeout for the first connection. Hermes Agent supports stdio servers and HTTP or SSE remote endpoints; the connector is a remote HTTP endpoint, so no local process is involved. HTTP servers honor HTTPS_PROXY, HTTP_PROXY and NO_PROXY. A long insights query is the case to raise timeout for.

Hermes Agent and MCP: the facts in one table

QuestionAnswer from Hermes Agent's docs
Where a server is addedUnder mcp_servers in ~/.hermes/config.yaml, or through hermes mcp
Remote server formaturl: for the address, then either headers: for a static token or auth: oauth for a browser sign-in
TransportsStdio for local subprocesses, and HTTP or SSE for remote endpoints
Sign-inhermes mcp login <server> authorizes OAuth 2.1 with PKCE. Hermes Agent tries a Client ID Metadata Document first and falls back to dynamic client registration, which is what Ryze AI supports
Saved credentialsTokens are cached at ~/.hermes/mcp-tokens/<server>.json and reused until a refresh fails
Tool namesPrefixed as mcp_<server_name>_<tool_name>, so the connector's tools begin mcp_ryze_
Tool selectiontools.include and tools.exclude, or hermes mcp configure <name>
PlanNone. Open source and self-hosted
Reload and test/reload-mcp reloads from config.yaml and refreshes the tool list. hermes mcp test <name> verifies a connection
Per-call approvalThe MCP page read on November 17, 2026 describes none for MCP tools

Sources: Hermes Agent: MCP configuration, Hermes Agent on GitHub (checked November 17, 2026).

Other clients

The same URL works in other MCP clients. Thrad is connected once in Ryze AI, so nothing changes on the Thrad side.

Claude Code

Claude Code registers the same URL with one claude mcp add command. See the Claude Code guide for Thrad.

How to connect Claude Code to Thrad

OpenClaw

OpenClaw, another self-hosted agent, saves the connector as a streamable-http server with its own commands.

How to connect OpenClaw to Thrad

ChatGPT and Claude

Both take the URL as a custom connector in their settings, with plan limits that Hermes Agent does not have. From either one the agent can also create a one-time connection link that opens a page where you paste the Thrad API key.

How to connect ChatGPT to Thrad

Permissions and access

Four things decide what Hermes Agent can reach in your Thrad account.

The Thrad key
An ak_ key carries the access of exactly one Thrad organization. Thrad allows one active key per organization and describes no read-only Advertiser API key, so reading versus changing is limited in Hermes Agent, not in Thrad.
Who can make it
Only organization owners and admins can create, rotate or revoke a key in Thrad.
Who uses the sign-in
The tokens live in ~/.hermes/mcp-tokens/ on the host. Everyone who can talk to that agent works through the same Ryze AI sign-in and the same Thrad account.
Public and paid effect
Activating a campaign makes ads eligible to serve and spend money. Thrad reviews new campaigns first, and its documentation says creating one needs a default card on the organization and a $10 deposit. That is a Thrad charge, not a Ryze AI price.

What the connection is allowed to do

Two sign-ins stand between Hermes Agent and Thrad. Hermes Agent signs in to the Ryze AI connector, and Ryze AI holds your Thrad API key. The rows show what each part grants and where the fact was found.

PartWhat it grantsFound in
Hermes Agent to the connectorOAuth with PKCE. Ryze AI supports dynamic client registration onlyRyze AI facts and Hermes Agent docs, November 17, 2026
The stored tokenOne file per server under ~/.hermes/mcp-tokens/, reused until a refresh failsHermes Agent MCP docs, November 17, 2026
Ryze AI to ThradThe Thrad ak_ key you pasted, sent as a bearer token to https://api.thrad.ai/v1. Thrad names no scopes for itThrad authentication page, November 14, 2026
What the key readsThe ad account, the asset catalog and insights at ad account, campaign, ad group and ad levelThrad overview and assets pages
What the key writesCampaigns, ad groups and ads: create, update, and the activate, pause and archive actionsThrad campaigns page
AccountsSeveral Thrad accounts can be connected to one Ryze AI workspace. Every thrads tool takes an optional connection_id, and there is no default-accounts picker, so name the account in your promptRyze AI facts

Not covered by the key or the tools: key management, because create, rotate and revoke need a Thrad dashboard session; creating or changing assets and uploading images, because assets are read-only over the API and thrads__uploadFromUrl gets a 404 from Thrad today; approving a campaign, which Thrad does; adding the billing card; and managing product feeds, which happens on the Assets page of the Thrad Platform. Targeting is country-level only.

Sources: Thrad authentication, Thrad API overview, Thrad assets, Thrad campaigns (checked November 14, 2026).

Removing access

To cut Hermes Agent off, delete the ryze entry from mcp_servers in ~/.hermes/config.yaml, run /reload-mcp and delete ~/.hermes/mcp-tokens/ryze.json. To cut Ryze AI off from Thrad, revoke the key in the Thrad dashboard; Thrad says revoking disables a key immediately with no grace period, while a rotated key leaves the old one valid for 30 minutes. Creating a new key also stops the old one working in Ryze AI until you replace it through Reconnect.

What Hermes Agent can do in Thrad

The Ryze AI connector exposes 5 Thrad tools: 2 read, 2 write and 1 delete. Every tool takes an optional connection_id to pick one of several connected Thrad accounts.

ToolTypeWhat it does
thrads__readReadReads any Thrad resource, such as the ad account, campaigns, ad groups, ads and assets.
thrads__insightsReadReturns aggregated insights that combine 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. New campaigns are submitted for Thrad's review before they go live.
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 use existing assets instead.
thrads__deleteDeleteArchives a campaign, ad group or ad. Archiving a campaign is irreversible.

Keeping the changing tools out of reach

The Hermes Agent MCP page describes no per-call approval prompt for MCP tools, so the control you have is which tools the agent sees. Because thrads__write can activate a campaign that spends money and thrads__delete archives, the standing way to keep them out of reach is tools.exclude on the ryze entry, as in the third block above, or tools.include with only the read tools. hermes mcp configure ryze does the same interactively. In the Ryze AI chat itself, the Tool approvals setting starts on Skip all approvals.

mcp_servers: ryze: url: "https://connector.get-ryze.ai/mcp" auth: oauth tools: include: ["thrads__read", "thrads__insights"]

Limits in numbers

LimitFigureSet by
Requests per key1000 per hour per key across the /v1/ endpoints. Throttling is per key, not per IP or organizationThrad
Campaign creation60 per hour per key, on top of the 1000 per hour bucketThrad
Over the limitHTTP 429, code rate_limit_exceeded, message Request was throttled.Thrad
List page size1 to 500, default 20, on campaign, ad group and ad listsThrad
Listing childrenAd groups are listed one campaign at a time and ads one ad group at a timeThrad
Insights windowTrailing 30 days by default, at most 366 days in one window, 25 hours with hourly granularityThrad
Insights rows1 to 2000 per request, default 20Thrad
ChatGPT supplyDaily data only. Hourly granularity with source openai is an errorThrad
Metrics6 fields: impressions, clicks, spend, CPC, CPM and CTRThrad
Minimum budget$0.99, with no upper capThrad
Pricing modelcpm (the default) or cpc, set when the campaign is created and not changeable by updateThrad
Automatic reload inside a sessionA 30-second timeout after a config.yaml edit, too short for an interactive OAuth sign-inHermes Agent

Thrad states these per key. Thrad counts requests per key, so every client that reaches Thrad with the same key draws on the same 1000 per hour. Whether Ryze AI adds its own limits on top was not checked.

Sources: Thrad authentication, Thrad insights, Thrad campaigns, Thrad ad groups, Thrad ads (checked November 14, 2026); Hermes Agent: MCP configuration (checked November 17, 2026).

First 3 prompts to run

Each answer comes from your own account, so this page describes what comes back instead of showing sample numbers.

1. Account and campaign overview

Show my Thrad ad account, then list every campaign with its status and review status.

Tools used: thrads__read

What comes back: The account details and one line per campaign. Review status is Thrad's verdict (in_review, approved or rejected) and is separate from active, paused or archived.

2. Thrad against ChatGPT supply

Report impressions, clicks, spend, CTR, CPC and CPM for the last 30 days, split by Thrad supply and ChatGPT supply.

Tools used: thrads__insights

What comes back: Rows per supply source. Thrad's documentation says the split rows add up to the combined total and that ChatGPT data is daily only.

3. Ad group and ad inventory

List the ad groups under my newest campaign and the ads in each, with their context hints and max bid.

Tools used: thrads__read

What comes back: The ad groups and ads under that campaign. Nothing is edited until you ask.

To change something, say it in plain words, such as pausing an ad group. Name the Thrad account in the prompt if you connected more than one. Thrad's documentation says activate only resumes a paused, approved campaign.

10 jobs to hand to Hermes Agent

Ten jobs to give a Hermes Agent session, each matched to the tool behind it. The default connection here means the Thrad ak_ key pasted into Ryze AI. None of them was run for this guide.

JobWhat to ask Hermes AgentToolDefault connection
Account detailsShow the Thrad ad account: name, currency and timezone.thrads__readYes
Campaign listList every campaign with its status and review status.thrads__readYes
Ad group and ad listList the ad groups and ads under this campaign, with context hints and max bid.thrads__readYes
Reusable assetsList the assets already in the account that an ad can use.thrads__readYes
Thirty-day reportReport impressions, clicks, spend, CTR, CPC and CPM for the last 30 days.thrads__insightsYes
Supply comparisonCompare Thrad supply with ChatGPT supply by splitting insights by source.thrads__insightsYes
New campaignCreate a campaign with an ad group and a card ad that uses an existing asset.thrads__read, then thrads__writeYes. Goes to Thrad review, and needs a card and deposit on the Thrad side
Edit an adUpdate this ad group or ad.thrads__writeYes
Pause or activatePause this campaign, or activate it again.thrads__writeYes. Activate works only on a paused, approved campaign
ArchiveArchive this ad group.thrads__deleteYes. Archiving a campaign cannot be undone

Three tasks have no tool: uploading an image from a URL, because Thrad answers that call with a 404 and assets are read-only over its API; bringing back an archived campaign, since archiving is its final state; and targeting below country level.

3 ways to connect Hermes Agent to Thrad

Thrad publishes no MCP server, connector, plugin or CLI that reaches an advertiser's campaigns, ads or insights. Its account route is the Advertiser API, a REST API at https://api.thrad.ai/v1 called from your own code. This guide treats the Ryze AI connector as the main way: the Thrad side is one pasted API key, and the Hermes Agent side is one remote entry in config.yaml. The other ways below were read on their own pages on November 14, 2026 and none was installed in Hermes Agent.

WayRuns whereSetup in Hermes AgentWhat it reaches in ThradPrice
Ryze AI connector (the main way)Hosted by Ryze AI, one address for every userA ryze entry under mcp_servers with url and auth: oauth, then hermes mcp login ryze. A Ryze AI API key in an Authorization header can stand in for the sign-in5 tools: read, insights, write, uploadFromUrl and deletePaid Ads $89 per month with a 7-day free trial
Thrad Docs MCP serverHosted on Thrad's documentation hostAdd https://docs.thrad.ai/mcp as a remote server. Thrad's page menu names only Cursor for install, so a Hermes Agent entry was not triedPublic documentation only: 3 tools, search_thrad_docs, query_docs_filesystem_thrad_docs and submit_feedback. No campaigns, ads or spendNo price stated, no sign-in
Your own script on the Advertiser APIYour computer or serverA script Hermes Agent runs, or a server you write and add under mcp_servers. Keep the ak_ key in an environment variableWhatever the API allows, with the same ak_ key and the 1000 per hour limitThrad's pages state no price for API use

Options that do not fit Hermes Agent

  • Composio. Its toolkit list had no Thrad entry on November 14, 2026, and composio.dev/toolkits/thrad returns 404.
  • Zapier MCP. Zapier's app directory returned 0 apps for Thrad, and zapier.com/mcp/thrad returns 404.
  • Windsor.ai, Coupler.io, Supermetrics and Porter Metrics. None lists Thrad as a data source.
  • Open-source servers on GitHub. Searches for a Thrad MCP server returned 0 repositories. None found is an MCP server for the Thrad Advertiser API.
  • Thrad Agent Skills (thrad-card, thrad-poll, thrad-carousel). They help a coding agent build Thrad's publisher integration into an AI chat app, and do not read or change an advertiser's campaigns.

Which one to pick

Ryze AI is the best Thrad connector for Hermes Agent when you want hosted tools for campaigns, ads and ChatGPT-plus-Thrad insights from one URL, but you pay for a Ryze AI plan, your Thrad key is stored with Ryze AI, image upload does not work today and Thrad is chat only in Ryze AI. The Thrad Docs MCP server is free and needs no sign-in, and suits a session that only needs to look up how the API works. A script of your own on the Advertiser API gives full control and costs developer time, including the 1000 per hour limit you manage yourself. Try changes on a test campaign before pointing the agent at live spend.

Sources: Thrad Docs MCP server, Thrad docs index, Thrad Agent Skills, Composio pricing, Zapier MCP quickstart (checked November 14, 2026); Hermes Agent: MCP configuration (checked November 17, 2026).

Thrad and Hermes Agent: dates that matter

DateWhat happened
2024Thrad was founded, according to Thrad's own llms.txt.
April 23, 2026ExchangeWire PressBox published that Thrad is live as an advertiser inside ChatGPT. This is press coverage, not a Thrad changelog.
August 7, 2026Thrad's Advertiser API pages (overview, quickstart, authentication, campaigns, insights, assets) were last modified, per the docs sitemap. This is a last-modified date, not a launch date.
September 2, 2026ExchangeWire PressBox published that Thrad's first Middle East and North Africa advertisers went live on ChatGPT.
November 14, 2026Thrad Docs MCP server answered at docs.thrad.ai/mcp as version 1.0.0 with 3 tools. This is the check date, not a launch date. Thrad publishes no changelog, release page or registry entry for an account-level MCP server.
November 16, 2026Hermes Agent v0.23.2 was released on GitHub. Canary builds appeared daily around it.

Sources: Thrad llms.txt, Thrad docs sitemap, ExchangeWire, April 23, 2026, ExchangeWire, September 2, 2026 (checked November 14, 2026); Hermes Agent releases (checked November 17, 2026).

How this guide was tested

Nothing in this guide was tested through the Ryze AI connector against a Thrad account. The checks below are reads of public pages. The Hermes Agent steps were compared with its documentation on November 17, 2026.

What was runWhat came back
Thrad documentation and endpoints, November 14, 202657 documentation pages, the discovery files at docs.thrad.ai, and the docs MCP server's initialize and tool list were read. No page mentions an account-level MCP server.
Third-party lists, November 14, 2026Composio, Zapier, 4 reporting vendors, GitHub, npm, PyPI and the official MCP Registry were searched. None offers a Thrad connector.
Hermes Agent MCP documentation, November 17, 2026The remote server format, hermes mcp login, /reload-mcp, tool filtering and token cache path were read.
Hermes Agent releases, November 17, 2026The GitHub releases list showed v0.23.2 as the newest stable release, dated November 16, 2026.

Not run for this page: every Thrad call. No Thrad account was connected, so none of the 5 tools was called and no error from the connector was recorded. Nothing was run inside Hermes Agent: it was not installed, no config.yaml entry was saved, and hermes mcp login and /reload-mcp were not tried. The tool names come from Ryze AI's facts, and the connector's tool list for Thrad was not seen live.

Errors and fixes

Messages from Thrad's documentation

No error from the connector was recorded for this guide. These messages come from Thrad's own documentation, copied from its example responses. Each is a Thrad answer that can reach Hermes Agent through a tool result.

Message or codeMeaningWhat to do in Hermes Agent
401 auth_required: Authentication credentials were not provided.No Authorization header reached Thrad.Reconnect Thrad in Ryze AI and paste the key again.
401 invalid_api_key: Invalid API key.The key is malformed, unknown, expired or revoked.Create a key in Settings > API keys in Thrad and use Reconnect in Ryze AI.
429 rate_limit_exceeded: Request was throttled.Over 1000 requests per hour per key, or over 60 campaign creations per hour.Wait, and ask for a narrower list or report.
400 billing_not_configured: Set up a default card in billing settings before creating a campaign.The Thrad organization has no default card.Add a card in the Thrad Platform, then create the campaign again.
402 card_declined: Your card was declined.The $10 deposit charge was declined and nothing was created.Fix the card in Thrad.
400 campaign_not_approved: Only an approved, paused campaign can be activated.The campaign is still in review or was rejected.Wait for Thrad's review, then activate.
400 campaign_not_running: Only a running campaign can be paused.The campaign is not running.Check its status first.
400 cannot_archive: Only a running or paused campaign can be archived.The campaign is in another state.Check its status first.
409 name_conflictA campaign with that name already exists. Thrad prints no example message.Choose another name.
504 clickhouse_timeoutThe analytics query timed out. Thrad prints no example message.Narrow the scope, window or granularity and retry.

Sources: Thrad authentication, Thrad campaigns, Thrad insights (checked November 14, 2026).

Other problems

The Thrad tools do not appear in Hermes Agent
Run hermes mcp test ryze to check the connection, then /reload-mcp or start a new session. If the entry has auth: oauth and no sign-in was done yet, run hermes mcp login ryze first. If they still do not appear, refresh the Ryze AI connector and start a new session.
The sign-in dies when I edit config.yaml in a session
An edit made inside a running session reloads MCP with a 30-second timeout, which is too short for an interactive OAuth flow. Save the entry, then run hermes mcp login ryze from a terminal.
The authorize page opens on the wrong machine or nothing opens
Copy the printed authorize URL into a browser on another machine, approve it, and paste the redirect URL at the prompt.
The tools have long names
Hermes Agent prefixes each tool as mcp_<server>_<tool>, so a Thrad tool appears with mcp_ryze_ in front. Check the list after setting include or exclude to see which form the filter matches.
The Ryze AI API key is not read
Check that RYZE_API_KEY is in ~/.hermes/.env and that the header reads Bearer followed by the placeholder. Run /reload-mcp after any change, and remove auth: oauth from the entry if you use the key route.
The sign-in worked before and now fails
Hermes Agent reuses a cached token until a refresh fails. Delete ~/.hermes/mcp-tokens/ryze.json and run hermes mcp login ryze again.
Thrad stopped answering after I made a new key
The old key stops working when a new one is created. Use Reconnect on the Thrad card in Ryze AI and paste the new key.
An image upload fails
Expected. Thrad currently answers the upload call with a 404. Use an asset that already exists in the account.
A corporate proxy blocks the connection
HTTP servers honor HTTPS_PROXY, HTTP_PROXY and NO_PROXY, so set them in the environment that runs Hermes Agent.
The agent says a subscription is required
The tools need an active Ryze AI plan or free trial. Without one the connector can only list workspaces and connect platforms.

Terms on this page

mcp_servers
The block of ~/.hermes/config.yaml where Hermes Agent keeps the MCP servers it connects to, one named entry each.
/reload-mcp
A Hermes Agent command that reloads MCP servers from config.yaml and refreshes the tool list.
ak_ key
Thrad's secret API key. It starts with ak_, there is one active key per organization, and the full secret is shown once.
Supply (source)
Where an ad was shown: Thrad's own network (thrad) or ChatGPT through OpenAI Ads (openai). Insights combine both unless you ask for one.
Asset
A reusable creative record on the ad account: an image and a destination URL. Every ad points at one asset.
Review status
Thrad's moderation verdict on a campaign: in_review, approved or rejected. It is separate from active, paused or archived.
Context hints
Short phrases on an ad group that steer where its ads serve. Each ad group needs at least one.

Sources: Hermes Agent: MCP configuration (checked November 17, 2026); Thrad authentication, Thrad insights, Thrad campaigns (checked November 14, 2026).

Frequently asked questions

How do I connect Hermes Agent to Thrad?

Paste a Thrad API key into the Thrad card in a Ryze AI workspace. Then add a ryze entry under mcp_servers in ~/.hermes/config.yaml with url https://connector.get-ryze.ai/mcp and auth: oauth, run hermes mcp login ryze and click Allow connection in the browser. Finish with /reload-mcp or a new session.

Is there a Thrad MCP server for Hermes Agent in 2026?

Yes, the Ryze AI connector at https://connector.get-ryze.ai/mcp, which Hermes Agent saves as a remote server and which brings 5 Thrad tools. Thrad itself publishes no MCP server for campaigns or insights. Its docs MCP server at https://docs.thrad.ai/mcp searches documentation only.

Is there a Thrad connector for Hermes Agent?

Hermes Agent adds servers by URL, and the Ryze AI connector is added that way. Thrad, Composio and Zapier list no Thrad connector for Hermes Agent as of November 14, 2026.

Does Thrad have its own MCP server?

Only for documentation. The server at https://docs.thrad.ai/mcp has 3 tools, needs no sign-in and reads public docs pages. It does not reach campaigns, ads, spend or any account data.

Which Thrad connector should I use with Hermes Agent?

Ryze AI is the best Thrad connector for Hermes Agent when you want hosted tools for campaigns, ads and insights from one URL, but it needs a Ryze AI plan and image upload does not work today. A script on Thrad's Advertiser API gives full control and costs developer time.

Do I need a paid Hermes Agent plan?

No. Hermes Agent is open source and self-hosted, with no plan tier, and its GitHub repository lists the MIT license. The cost is the Ryze AI plan or trial that the Thrad tools need.

Where do I get the Thrad API key?

In the Thrad Platform dashboard under Settings > API keys. It starts with ak_. Only organization owners and admins can create one, and the full secret is shown once.

Should I use OAuth or an API key in config.yaml?

OAuth through hermes mcp login is the default path in this guide. A Ryze AI API key sent as a bearer header, kept in ~/.hermes/.env, suits a host where no browser sign-in is practical. Use one method per server entry. Neither replaces the Thrad ak_ key.

Can Hermes Agent create and pause Thrad campaigns?

Yes. thrads__write creates and updates campaigns, ad groups and ads and activates or pauses them, and new campaigns are submitted for Thrad's review. The Hermes Agent MCP page describes no per-call approval, so tools.exclude on the entry is how you keep write tools away from the agent.

Can Hermes Agent see ChatGPT ad results?

Yes, through thrads__insights, which combines Thrad and ChatGPT (OpenAI Ads) supply and can be filtered by source. ChatGPT data is daily only. It covers impressions, clicks, spend, CTR, CPC and CPM.

Can I connect more than one Thrad account?

Yes. In Ryze AI click View > Add one more account on the Thrad card. There is no default-accounts picker, so name the account in your prompt. Every thrads tool takes an optional connection_id.

Why do the tools not show up in Hermes Agent after I edit config.yaml?

Run /reload-mcp or start a new session, and check the connection with hermes mcp test ryze. If the entry uses auth: oauth, complete hermes mcp login ryze from a terminal first, because an automatic reload inside a running session allows only 30 seconds.

What if Hermes Agent runs on a server without a browser?

Open the printed authorize URL in a browser on another machine, approve it, and paste the redirect URL at the prompt in the terminal. Or use the Ryze AI API key route, which needs no browser.

How much does it cost to connect Hermes Agent to Thrad?

Connecting 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. Annual billing takes 30% off the first year. Thrad charges its own fees separately.

How do I disconnect Thrad from Hermes Agent?

Remove the ryze entry from mcp_servers in config.yaml, run /reload-mcp and delete ~/.hermes/mcp-tokens/ryze.json. To cut Ryze AI off from Thrad, revoke the key in the Thrad dashboard.

Connect your Thrad account to Hermes Agent

The 5 Thrad tools run on Paid Ads at $89 per month with a 7-day free trial. Annual billing takes 30% off the first year.

Thrad MCP server

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