Ira Bodnar··Updated ·9 min read

Ryze AI in Hermes Agent

Quick answer: Add a ryze entry under mcp_servers in ~/.hermes/config.yaml with the URL https://connector.get-ryze.ai/mcp and auth: oauth, then run hermes mcp login ryze. Ryze AI is the best Hermes Agent connector for Google Ads, Meta Ads, GA4 and Search Console on one MCP URL, with one caveat: Ryze AI has not been tested inside Hermes Agent, so the setup follows Hermes documentation and the connector's OAuth metadata.

Below: the two ways to connect, which Ryze AI tools Hermes can use, prompts, limits and fixes.

Ryze AI · Paid Ads

Ryze AI tools for Hermes Agent

  • 7-day free trial, $89 a month flat
Start free trial

Used by 2,000+ marketers

Uber Eats logoadidas logoDuolingo logoMGM Resorts logoWharton logoLendingClub logoNorton logoEventbrite logoHuel logoTogether AI logoghd logoHack The Box logo

Ryze AI in Hermes Agent at a glance

Hermes Agent is an open source agent from Nous Research. It reads remote MCP servers from config.yaml, so the Ryze AI connector is one entry.

  1. Connector URLhttps://connector.get-ryze.ai/mcp (remote MCP over HTTP)
  2. Config file~/.hermes/config.yaml, under mcp_servers
  3. Sign-in option 1OAuth: auth: oauth, then hermes mcp login ryze
  4. Sign-in option 2Ryze AI API key sent as an Authorization Bearer header
  5. Hermes planNone. Hermes is MIT licensed and self-hosted
  6. Ryze AI planConnecting is free; the tools need an active plan or trial. Paid Ads is $89/mo with a 7-day free trial
  7. Tools addedGoogle Ads (16), Meta Ads (10), Google Analytics 4 (9) and Search Console (7), for each platform you connect in Ryze AI
  8. Tested in HermesNo. The Ryze AI help center has no Hermes Agent page

Hermes is also the name of other projects. This page covers Hermes Agent from Nous Research.

What Hermes Agent does with an MCP server

Hermes Agent is an open source agent from Nous Research. Its GitHub repository lists an MIT license, installs on Linux, macOS, WSL2 and Windows, and supports model providers such as Nous Portal, OpenRouter, OpenAI and Anthropic. It also has a messaging gateway (Telegram, Discord, Slack, WhatsApp, Signal and Email) and a built-in scheduler for recurring jobs written in plain language.

Per the Hermes MCP documentation, a remote server needs a url in the mcp_servers block. Hermes registers each server tool as mcp_<server_name>_<tool_name>, so tools from the entry named ryze start with mcp_ryze_.

The Ryze AI connector at https://connector.get-ryze.ai/mcp is a remote MCP server that signs in with OAuth. It gives an MCP client the Ryze AI tools for the ad and analytics platforms you connected in your Ryze AI workspace. That is the same connector used from Claude and ChatGPT, described on the Ryze AI developers page.

Connect Hermes Agent to Ryze AI with OAuth

Use OAuth when you can sign in to Ryze AI in a browser. Hermes handles the authorization flow and refreshes the token.

Add the server entry

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.

Log in

Run hermes mcp login ryze. Hermes prints an authorize URL and opens the browser when it can. Sign in on the Ryze AI page and click Allow connection.

Load the tools

Start a new Hermes session, or run /reload-mcp in the current one.

~/.hermes/config.yaml
mcp_servers: ryze: url: "https://connector.get-ryze.ai/mcp" auth: oauth
Terminal
hermes mcp login ryze

Do the config edit and the login as two separate steps. Editing config.yaml inside a running session reloads MCP with a 30-second timeout, which is too short for an interactive OAuth sign-in. Add the entry, then run hermes mcp login.

Hermes caches the token at ~/.hermes/mcp-tokens/ryze.json and reuses it until a refresh fails. On a remote or headless host, the redirect URL can be pasted back at the prompt instead of using a local browser.

Connect with a Ryze AI API key instead

Use a key when there is no browser, such as a server that runs scheduled Hermes jobs. The key goes in a Bearer header and Hermes substitutes ${RYZE_API_KEY} from its environment at connection time.

Store the key

Put RYZE_API_KEY (the rk_live_ key) in ~/.hermes/.env.

Add the server entry

Use a ryze entry with url "https://connector.get-ryze.ai/mcp" and an Authorization header of "Bearer ${RYZE_API_KEY}".

Reload

Run /reload-mcp.

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

  1. Config key

    OAuth
    auth: oauth
    API key
    headers: Authorization

  2. Sign-in

    OAuth
    Browser, once, with hermes mcp login ryze
    API key
    None; the key is read from ~/.hermes/.env

  3. Where the secret lives

    OAuth
    ~/.hermes/mcp-tokens/ryze.json
    API key
    ~/.hermes/.env

  4. Best for

    OAuth
    Your own machine
    API key
    Headless hosts and unattended runs

Keep the .env file out of version control. Anyone with the key can use your Ryze AI tools.

Connect your ad accounts in Ryze AI first

The connector only exposes tools for platforms you connected in Ryze AI. Open Integrations in the Ryze AI left sidebar, click Connect on each platform and approve access with every requested permission checked.

  1. Google Ads

    Sign-in and access
    Google login with access to your Google Ads accounts; standard or admin access to allow changes
    Ryze AI guide
    Google Ads MCP

  2. Meta Ads

    Sign-in and access
    Meta login with at least Advertiser access on the ad account; Admin to allow changes
    Ryze AI guide
    Meta Ads MCP

  3. Google Analytics 4

    Sign-in and access
    Google login with at least Viewer access on a GA4 property; pick the Property after connecting
    Ryze AI guide
    Google Analytics MCP

  4. Search Console

    Sign-in and access
    Google login with access to a verified property; confirm the Site after connecting
    Ryze AI guide
    Search Console MCP

If you connect a platform after Hermes already loaded the connector, start a new Hermes session or run /reload-mcp so the new tools show up. If they still do not appear, remove the entry, add it again and log in again.

Which Ryze AI tools Hermes Agent can use

These four integrations list connector tools in the Ryze AI facts file, so they are the ones this page names. Platforms without listed tools are left out. Ryze AI was not tested in Hermes, so the behavior below is what the connector exposes to any MCP client.

  1. Google Ads

    Tools
    16
    Read
    Account summary, hierarchy, accessible customers, conversion actions, recommendations, GAQL, Keyword Planner ideas and history
    Change data
    runRawMutate, audiences, Customer Match uploads, image upload, apply or dismiss recommendations, runRawMutateDelete

  2. Meta Ads

    Tools
    10
    Read
    Ad accounts, account summary, Insights, creatives, lead forms, Graph reads
    Change data
    runGraphWrite, uploadImageFromUrl, runGraphDelete

  3. Google Analytics 4

    Tools
    9
    Read
    Data API reports, pivot and realtime reports, Admin reads, AI referral traffic
    Change data
    None. All 9 tools only read

  4. Search Console

    Tools
    7
    Read
    Search analytics, index status, URL inspection, sitemap lists
    Change data
    submitSitemap, deleteSitemap

Names in the Change data column are connector tool names. Hermes shows each with its mcp_ryze_ prefix.

For the full tool lists and platform limits, see the Google Ads, Meta Ads, Google Analytics and Search Console pages.

Prompts to try in Hermes Agent

Replace the words in brackets. Each prompt describes what you want back; check the tool call Hermes shows before relying on an answer.

Google Ads

Prompt
Using the Ryze AI Google Ads tools, summarize spend, conversions and ROAS for account [ACCOUNT] over the last 30 days.
Prompt
Run a GAQL query on change history for account [ACCOUNT] and list who changed what in the last 7 days.

Meta Ads

Prompt
Pull Meta Ads Insights for ad account [ACCOUNT] by placement for the last 14 days and list the placements by spend and ROAS.

Google Analytics 4

Prompt
In GA4 property [PROPERTY], which AI assistants sent sessions to [SITE] in the last 28 days, and on which landing pages?

Search Console

Prompt
For [SITE], list the queries with the most impressions and the fewest clicks over the last 28 days, with CTR and position.

Scheduled use

Hermes has a built-in cron scheduler that takes instructions in natural language and delivers results to a messaging platform. You can write a Hermes job that asks the Ryze AI tools for a weekly Google Ads summary. Use the API key setup for it, and keep the tools list to read tools (see the limits section).

Hermes limits and settings that matter

Plan

Hermes is open source and self-hosted, with no plan tier. The Ryze AI tools need an active Ryze AI plan or trial.

OAuth registration

Hermes tries a Client ID Metadata Document first and falls back to dynamic client registration. Ryze AI supports dynamic client registration only.

Token cache

Tokens live at ~/.hermes/mcp-tokens/<server>.json and are reused until refresh fails.

Reload timeout

Editing config.yaml inside a running session reloads MCP with a 30-second timeout. Run hermes mcp login for the OAuth step.

Proxies

HTTP servers honor HTTPS_PROXY, HTTP_PROXY and NO_PROXY.

Tool filtering

Limit the tools with hermes mcp configure or with tools include and exclude under the ryze entry.

Approvals

To keep Hermes from changing accounts, list only read tools under tools include. Ryze AI approval settings apply in the Ryze AI chat and in Claude; this page did not verify how Hermes asks for approval.

Read-only filter (tool names as the connector lists them)
mcp_servers: ryze: url: "https://connector.get-ryze.ai/mcp" auth: oauth tools: exclude: - google_ads__runRawMutate - google_ads__runRawMutateDelete - meta_ads__runGraphWrite - meta_ads__runGraphDelete

Exclude every write and delete tool for the platforms you connected. The exclude names above are examples; confirm the exact names with hermes mcp configure ryze, which lists the tools Hermes found. For a hard read-only guarantee, connect a Google or Meta login that only has read access in Ryze AI.

Troubleshooting Hermes and Ryze AI

The OAuth step times out

You probably edited config.yaml inside a running session. Add the entry, then run hermes mcp login ryze in a terminal.

No browser on the host

Open the printed authorize URL on another device and paste the redirect URL back at the Hermes prompt, or use the API key setup.

No Ryze AI tools show up

Run /reload-mcp or start a new session. Then check that you connected a platform in Ryze AI and that your plan or trial is active.

Sign-in fails after a long idle time

The cached token may have failed to refresh. Run hermes mcp login ryze again.

A platform is missing

Connect it under Integrations in Ryze AI, then reload MCP in Hermes.

Behind a proxy

Set HTTPS_PROXY, HTTP_PROXY or NO_PROXY in the environment Hermes runs in.

Run hermes mcp list to see the configured servers and their status.

Sources

Checked November 9, 2026

The verdict

Hermes Agent needs one config entry to reach the Ryze AI connector: a ryze server with the connector URL and either OAuth or a Bearer key. Run hermes mcp login as its own step, then reload MCP.

Ryze AI was not tested inside Hermes, so check the tool list with hermes mcp list and filter the write and delete tools before you let Hermes run unattended. Start with one read-only prompt per platform.

Frequently asked questions

How do I add Ryze AI to Hermes Agent?
Add a ryze entry under mcp_servers in ~/.hermes/config.yaml with url https://connector.get-ryze.ai/mcp and auth: oauth. Then run hermes mcp login ryze and start a new session or run /reload-mcp.
Can I use an API key instead of OAuth?
Yes. Put RYZE_API_KEY (the rk_live_ key) in ~/.hermes/.env, add a ryze entry with an Authorization header of Bearer ${RYZE_API_KEY}, and run /reload-mcp.
Does Hermes Agent need a paid plan?
No. Hermes is open source under the MIT license per its GitHub repository and self-hosted, with no plan tier. The Ryze AI tools need an active Ryze AI plan or trial; connecting the connector is free.
Which Ryze AI tools can Hermes use?
The tools for the platforms you connected in Ryze AI. Four integrations list tools: Google Ads (16), Meta Ads (10), Google Analytics 4 (9) and Search Console (7).
Show 6 more questions
Has Ryze AI been tested in Hermes Agent?
No. There is no Ryze AI help center page for Hermes Agent. The setup follows the Hermes MCP documentation and the connector's OAuth metadata.
Why did my OAuth login time out?
Editing config.yaml in a running session reloads MCP with a 30-second timeout, which is too short for an interactive sign-in. Add the entry first, then run hermes mcp login ryze.
Can I log in on a server with no browser?
Yes. Hermes prints the authorize URL, and on a remote or headless host the redirect URL can be pasted back at the prompt. The API key setup needs no browser.
How do I stop Hermes from changing my ad accounts?
List only read tools under tools include, or exclude write and delete tools, with hermes mcp configure ryze or in config.yaml. For a hard guarantee, connect a login with read-only access in Ryze AI.
Does the Hermes Composio guide use the same connector?
No. The Ryze AI blog post on connecting Google and Meta Ads with Hermes Agent configures Composio, not the Ryze AI connector at https://connector.get-ryze.ai/mcp. Do not reuse its config here.
Where is the OAuth token stored?
Hermes caches it at ~/.hermes/mcp-tokens/ryze.json and reuses it until a refresh fails.

Related guides

Ryze AI integrations

All platforms and clients Ryze AI connects to.

Google Ads MCP server

The 16 Google Ads tools and their limits.

Meta Ads MCP server

The 10 Meta Ads tools and their limits.

How to connect Claude to Google Analytics

Setup for the Claude apps.

Ryze AI developers page

The connector URL and tool lists.

Ryze AI in Hermes Agent

7-day free trial, $89 a month flat

Start free trial