How to connect Hermes Agent to Shopify

Connect your store once in Ryze AI, add one ryze entry to ~/.hermes/config.yaml, run hermes mcp login ryze, then ask Hermes Agent about products, collections, pages and SEO fields.

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

Copies the URL for the url field of a ryze entry under mcp_servers in config.yaml. See the steps

See pricing

By Ira Bodnar, Ryze AI · Updated · Connector tested November 13, 2026

Quick answer

The main way to connect Hermes Agent to Shopify is the Ryze AI connector. Connect your .myshopify.com store in Ryze AI, add a ryze entry with the URL https://connector.get-ryze.ai/mcp and auth: oauth under mcp_servers in ~/.hermes/config.yaml, then run hermes mcp login ryze and click Allow connection. Start a new session and ask about your store.

  1. In Ryze AI open Integrations, click Connect on Shopify, enter your .myshopify.com domain and approve the access prompt
  2. Add the ryze entry to mcp_servers in ~/.hermes/config.yaml
  3. Run hermes mcp login ryze and click Allow connection
  4. Start a new session or run /reload-mcp, then ask your first Shopify question

Hermes Agent to Shopify at a glance

FactDetail
Main way to connectThe Ryze AI connector, a remote HTTP MCP server that Hermes Agent reads from one ryze entry under mcp_servers in ~/.hermes/config.yaml
Connector addresshttps://connector.get-ryze.ai/mcp, identical for every user
How Hermes Agent signs inOAuth with auth: oauth, completed once with hermes mcp login ryze. A Ryze AI API key sent as a bearer header from ~/.hermes/.env is the alternative
What Shopify needsThe store's .myshopify.com domain and an approval in Shopify admin for the Ryze AI app. No API keys on the default route
Shopify tools5 in total: 2 that read, 2 that write and 1 that deletes
Changes to the storeYes, through the write and edit tools, within the scopes of the Ryze AI app. Setting trust: untrusted on the ryze entry makes Hermes Agent ask before write-capable calls
Other data in the same chatGoogle Ads, Meta Ads, GA4 and Search Console tools from the same URL, when those platforms are connected in the same workspace
Hermes Agent planNone. Hermes Agent is open source under the MIT license per its GitHub repository and runs on your own machine or server
Ryze AI pricePaid Ads costs $89 per month after a 7-day free trial. Adding the connector costs nothing
Shopify's own optionThe Shopify AI Toolkit page lists Hermes with an install script that adds a plugin, and a local Dev MCP server that holds developer docs and no store data
Last testedCalls through the connector were run on November 13, 2026 from Claude Code on a development store. The steps inside Hermes Agent were not run

Before you start

  • Hermes Agent installed. It is open source from Nous Research, licensed MIT per its GitHub repository, and self-hosted, so there is no plan tier to buy. The configuration lives in ~/.hermes/config.yaml.
  • A Shopify store you can approve an app on. You need the .myshopify.com domain, not your custom domain, and a login that can approve the Ryze AI app in Shopify admin. Theme file edits, URL redirects and customer records need your own custom app instead of the default one.
  • A Ryze AI workspace on a plan or free trial. Paid Ads is $89 per month with a 7-day free trial; SEO Starter ($129 per month, 3-day free trial) adds publishing Content Plan articles to a Shopify blog, and Agency is $279 per month. Connecting the connector is free, but the Shopify tools need an active plan or trial.

How to connect Hermes Agent to Shopify with OAuth

The first step happens in Shopify and Ryze AI, the rest in Hermes Agent. The connector URL is the same for every user.

  1. Connect your store in Ryze AI

    Create a Ryze AI account or sign in, open Integrations and click Connect on the Shopify card. On the Shopify app tab, type your .myshopify.com domain and click Continue, then approve the access prompt in Shopify admin. You return to Ryze AI with the store connected.

  2. Add the ryze entry to config.yaml

    Open ~/.hermes/config.yaml and add a ryze server under mcp_servers. Editing the file inside a running session starts an automatic MCP reload with a 30-second timeout, which is too short for a browser sign-in, so add the entry and then run the login in the next step.

    mcp_servers: ryze: url: "https://connector.get-ryze.ai/mcp" auth: oauth
  3. Sign in to the connector

    Run hermes mcp login ryze. Hermes Agent prints an authorize URL and opens your browser when it can. Sign in on the Ryze AI page, choose the workspace and click Allow connection. Hermes Agent caches the tokens at ~/.hermes/mcp-tokens/ryze.json and reuses them until a refresh fails.

  4. Load the tools

    Start a new session, or run /reload-mcp inside a running one. Hermes Agent registers each tool under the name mcp_<server>_<tool>, so the Shopify tools start with mcp_ryze_. To see what the server answers, run hermes mcp test ryze.

  5. Ask your first question

    Ask: List my products with their SEO title and description, and tell me which ones have both empty.

The Ryze AI help center page for Shopify covers the Shopify side of the connection, and the Ryze AI help article on API keys and the MCP endpoint covers the connector URL. The Ryze AI developers page lists the same URL.

Source for the Hermes Agent steps: Hermes Agent MCP documentation, opened November 20, 2026.

API key, tool filters and headless hosts

Hermes Agent keeps every MCP server in one file, ~/.hermes/config.yaml. These are the variations that matter for this connector.

A Ryze AI API key instead of OAuth

Create a key in Ryze AI under Workspace Settings > Profile > API keys > Create key and copy it, because it is shown once. Put RYZE_API_KEY with the rk_live_ key in ~/.hermes/.env and reference it in the header, since Hermes Agent resolves ${VAR} placeholders in headers from environment variables. Run /reload-mcp afterwards. The Shopify store stays connected inside Ryze AI, so no Shopify key is involved.

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

Show Hermes Agent only the read tools

Each server entry accepts tools.include and tools.exclude. This entry registers the two Shopify read tools and nothing else from the connector, which also hides the tools of every other platform in the workspace. It hides tools from Hermes Agent only. The Shopify app scopes are unchanged.

mcp_servers: ryze: url: "https://connector.get-ryze.ai/mcp" auth: oauth tools: include: - shopify__read - shopify__search_content

A remote or headless host

When Hermes Agent runs on a server and your browser is on another machine, the local callback cannot reach the browser. The Hermes Agent documentation lists these ways around it: paste the redirect URL back at the prompt, forward the callback port with ssh -N -L, or complete the sign-in from the Desktop app or dashboard. A Ryze AI API key avoids the browser entirely.

hermes mcp login ryze

The messaging gateway and unattended runs

A running gateway never opens a browser, so sign in with hermes mcp login ryze first. The documentation says the gateway watches config.yaml and connects a newly added entry within about a minute. A server whose first connect failed because no token was cached waits for a login.

Reloading and timeouts

The Hermes Agent pages read for this guide give no default for the length of a tool call. Hermes Agent waits for the browser sign-in for 5 minutes, and oauth.timeout on the entry makes it wait longer. connect_timeout on the entry bounds the first connection. Shopify prices each GraphQL query in points, so a wide catalog request can come back as an error and need a smaller page size.

mcp_servers: ryze: url: "https://connector.get-ryze.ai/mcp" auth: oauth oauth: timeout: 600 connect_timeout: 60

Hermes Agent and MCP: the facts in one table

TopicWhat the Hermes Agent documentation says
Where servers are added~/.hermes/config.yaml under mcp_servers, or with hermes mcp install for the catalog of Nous-approved servers
TransportsLocal stdio servers (command and args) and remote HTTP servers (url)
Sign-inauth: oauth does the browser sign-in. Hermes Agent identifies itself with a Client ID Metadata Document on servers that support one and falls back to dynamic client registration on those that do not. Static bearer headers also work
Token storage~/.hermes/mcp-tokens/<server>.json, written with 0600 permissions and reused until refresh fails
Tool namesmcp_<server_name>_<tool_name>, so a server named ryze registers its tools under names that start with mcp_ryze_
ApprovalA server entry can set trust: untrusted so that write-capable calls ask first. Tools annotated readOnlyHint stay unprompted. /yolo, --yolo and approvals.mode: off skip that prompt
Filteringtools.include and tools.exclude per server, with glob patterns. enabled: false skips a server. hermes mcp configure opens a checklist of the tools
Reload/reload-mcp, or a new session. Editing config.yaml inside a running CLI session reloads MCP with a 30-second timeout
ProxiesHTTP and SSE servers honor HTTPS_PROXY, HTTP_PROXY, ALL_PROXY and NO_PROXY
PlanNone. Open source, self-hosted

Sources: Hermes Agent MCP documentation, NousResearch/hermes-agent on GitHub. Opened November 20, 2026.

Other clients

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

Claude Code

Run claude mcp add --transport http ryze https://connector.get-ryze.ai/mcp, then sign in from /mcp. The store is connected once in Ryze AI, so the Shopify side does not change from client to client.

Claude and ChatGPT

In Claude open Customize > Connectors, choose Add custom connector and enter https://connector.get-ryze.ai/mcp. In ChatGPT the full custom MCP flow is for Business and Enterprise/Edu plans, and Pro users get read and fetch permissions only. If the connector was added before Shopify was connected, remove and re-add it, then start a new chat.

Codex and Cursor

Codex takes codex mcp add ryze --url https://connector.get-ryze.ai/mcp. Cursor reads the same URL from its mcp.json file. The Ryze AI developers page has the matching config for each.

Shopify scopes and Hermes settings

Two sign-ins are involved: an approval in Shopify admin for the Ryze AI app, and Ryze AI for the connector. Three things decide what Hermes Agent can reach.

Which store
The primary store, unless you name another. A workspace can hold several stores, and the tools accept an optional connection_id. A store can be live in only one Ryze AI workspace at a time.
What Hermes Agent can change
The scopes of the Shopify app behind the connection. The default Ryze AI app holds write scopes for products, content, metaobjects, themes and publications, and read scopes for orders, analytics and reports.
What Hermes Agent asks first
The trust, tools.include and tools.exclude settings on the ryze entry decide which tools Hermes Agent sees and when it asks first. They are client-side settings and do not change what the Shopify app may do.

The Shopify app and its scopes

On November 13, 2026 the Ryze AI app on a development store listed these 13 scopes through currentAppInstallation. The middle column follows Shopify's description of each scope.

ScopeWhat Shopify says it coversWhat Hermes Agent gets
read_products, write_productsProduct, ProductVariant, Collection, ResourceFeedback, SellingPlanRead and edit products, variants and collections, including their SEO fields
read_content, write_contentArticle, Blog, Comment, PageRead and edit pages, blogs and articles
read_metaobjects, write_metaobjectsMetaobjectRead and edit metaobjects
read_publications, write_publicationsPublication fields and publishing mutationsRead and change where items are published
read_themes, write_themesOnlineStoreTheme. Changing theme files needs an exemption in addition to write_themesRead the list of themes. Ryze AI's help center says theme file edits need your own custom app, so do not expect them here
read_ordersAbandonedCheckout, Fulfillment, Order, OrderTransaction, for orders created within the last 60 daysRead recent orders
read_reportsshopifyqlQueryRun ShopifyQL report queries
read_analyticsNot described in Shopify's current scope listGranted to the app. Shopify's list gives no description

Not part of the default connection: read_customers, read_discounts, read_all_orders and write_orders. A request for customers or discounts is refused, and orders older than 60 days stay hidden. Customer records, URL redirects and theme file edits need a custom app that you create in the Shopify Dev Dashboard and connect on the Custom app tab in Ryze AI.

Ryze AI says tokens refresh automatically, so there is no key to rotate on the default route. On the custom app route you enter the store domain, Client ID and Client secret of an app you own, and you choose its Admin API scopes.

Sources: Shopify access scopes. Checked November 13, 2026. The scope list comes from a read of the Ryze AI app on a development store, and what each scope allows comes from Shopify.

Removing access

To remove access, click View on the Shopify card in Ryze AI and disconnect the store, or uninstall the app in Shopify admin. In Hermes Agent, set enabled: false on the ryze entry or delete it from config.yaml, and delete ~/.hermes/mcp-tokens/ryze.json to drop the cached tokens.

What Hermes Agent can do in Shopify

The Ryze AI connector exposes 5 Shopify tools: 2 read, 2 write and 1 delete. In Hermes Agent the names appear with the mcp_ryze_ prefix.

ToolTypeWhat it does
shopify__readReadRuns a read-only Shopify Admin GraphQL query against the connected store. What comes back depends on the scopes of the store connection.
shopify__search_contentReadSearches one text field that the read tool can return, such as an article body, and returns matching lines with line numbers and surrounding context.
shopify__writeWriteRuns an Admin GraphQL mutation that creates or updates resources, such as productUpdate or metafieldsSet. Delete, remove, cancel and deactivate mutations are rejected here.
shopify__edit_contentWriteMakes find-and-replace edits inside one text field on the server in a single call, with optional JSON or Liquid validation before anything is written.
shopify__deleteDeleteRuns a destructive Admin GraphQL mutation that deletes, removes, cancels, deactivates, revokes or discards a resource, such as productDelete or tagsRemove.

Approvals in Hermes Agent

In Hermes Agent, approval for MCP tools is set per server. Adding trust: untrusted to the ryze entry makes every write-capable call on that server ask first, and tools annotated readOnlyHint stay unprompted. The documentation names no default for an entry without a trust key, so set it explicitly if you want the prompt. /yolo, --yolo and approvals.mode: off skip the prompt. Whether the Ryze AI tools carry the readOnlyHint annotation was not checked, so expect prompts on some reads as well. Separately, the Ryze AI chat has its own Tool approvals picker that starts on Skip all approvals, and scheduled tasks run without an approval step.

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

Shopify limits in numbers

Shopify's figures in Shopify's own units. None was measured for this guide except the last two rows, which come from the connector test on November 13, 2026.

LimitNumber
Request budgetGraphQL Admin API, per app and per store: Standard 100 points per second, Advanced Shopify 200, Shopify Plus 1,000, Shopify for enterprise 2,000
One queryA single query may not exceed a cost of 1,000 points, regardless of plan
CostsObjects 1 point, mutations 10, connections sized by first and last arguments, scalars 0
ListsInput arrays have a maximum size of 250. Pagination of arrays of objects caps at 25,000 objects
BackoffShopify's recommended backoff time is one second
Tool inputshopify__read accepts a query of up to 50,000 characters, from the tool definition seen on November 13, 2026
Ordersread_orders covers orders created within the last 60 days. read_all_orders is needed for older ones
Budget seen on a development storemaximumAvailable 2,000 points with a restore rate of 100 per second. A Shopify Plus store showed 20,000 and 1,000 per second

Sources: GraphQL Admin API rate limits, API usage limits, access scopes. Checked November 13, 2026.

Tested calls

Hermes Agent did not send these. On November 13, 2026 the same Ryze AI connector was called from Claude Code on a Shopify development store with Shopify's sample snowboard catalog, using the default Ryze AI app. The cost column is the points Shopify charged.

What the query asked forWhat the store returnedPoints charged
All products with SEO title and description (shopify__read)17 products. 15 had both SEO fields empty and 2 had both: The Complete Snowboard and The Hidden Snowboard7
All collections with SEO fields3 collections, all with both SEO fields empty4
Pages, blogs and articles2 pages, 1 blog, 0 articles15
All products with every variant17 products and 26 variants. 156 points were estimated5
Orders count0, precision EXACT10
Themes3 themes, one with the role MAIN4
The app and its scopes (currentAppInstallation)The app Ryze AI with 13 scopes3
customers(first: 1)Refused2
discountNodes(first: 1)Refused2
shopify__search_content on the description of the-complete-snowboard for snowboard1 match, on line 1not listed

The write and delete tools were not run, because they change the store.

First 3 prompts to run

Each answer comes from your own store, so this page describes what comes back instead of showing sample numbers. Hermes Agent picks the tool itself; the names are listed so you can check which one ran.

1. Find products with empty SEO fields

List every product with its title, handle, status, SEO title and SEO description, and mark the ones where either SEO field is empty.

Tools used: shopify__read

What comes back: A list of products from your own store as plain text in Hermes Agent. Nothing in Shopify is changed.

2. Check what a collection page says

Show each collection with its handle, the number of products in it and its SEO title and description.

Tools used: shopify__read

What comes back: One row per collection from your own store. It is a read, so nothing changes.

3. Rewrite one SEO description

Update the SEO description of the product with the handle I name here to a 150-character version that mentions what it is made of, and show me the old and new text.

Tools used: shopify__read, shopify__write

What comes back: A changed SEO description on one product, because the default app has write_products. With trust: untrusted on the ryze entry, Hermes Agent asks before the write runs.

When you want a change, describe it in plain words. Replace the names in the prompts with ones from your store.

10 jobs to hand to Hermes Agent

Ten jobs you can give Hermes Agent, each beside the tool that does the work. The last column is based on the default Ryze AI app and the scopes listed above.

JobAsk Hermes AgentToolOn the default connection
Product SEO auditList every product whose SEO title or description is empty.shopify__readYes
Collection SEO auditShow the SEO title and description of every collection.shopify__readYes
Content inventoryList the pages, blogs and articles in the store.shopify__readYes
Variant overviewGive each product with the number of its variants.shopify__readYes
Find a phrase in a long descriptionSearch the description of one product for a word and show the matching lines.shopify__search_contentYes
Fix a phrase in placeReplace one phrase in a product description and leave the rest alone.shopify__edit_contentYes, with write_products
Update SEO fieldsSet the SEO title and description on the products I list.shopify__writeYes, with write_products
Recent ordersCount the orders from the last 60 days.shopify__readYes, within the 60-day window
Customer recordsList my customers.shopify__readNo. It needs a custom app with read_customers
Remove a productDelete the test product I name here. I know this cannot be undone.shopify__deleteYes, and trust: untrusted makes Hermes Agent ask before the call

6 ways to connect Hermes Agent to Shopify

Six ways to connect Hermes Agent to Shopify. This guide treats the Ryze AI connector as the main way: the store stays connected in Ryze AI, and Hermes Agent holds one address and a browser sign-in. Hermes Agent accepts any remote HTTP MCP server by url and any local server by command, and none of these routes was run in Hermes Agent.

WayRuns whereSetup in Hermes AgentWhat it reaches in ShopifyPrice
Ryze AI connector (the main way)Hosted by Ryze AI, one address for every userA ryze entry with url and auth: oauth, then hermes mcp login ryze. Or a bearer header with a Ryze AI API key read from ~/.hermes/.env5 tools on the connected store: Admin GraphQL reads, writes, in-place content edits and deletes, within the app scopesPaid Ads is $89 per month with a 7-day free trial
Shopify AI Toolkit for HermesOn your computerShopify's AI Toolkit page lists Hermes and gives an install script that adds a plugin. The page shows no MCP entry for Hermes and this guide did not run the scriptThe Toolkit holds developer docs and API schemas. What the Hermes plugin adds beyond that was not checkedNo price stated on the page
Dev MCP server on its ownOn your computer, started with npxA command entry named shopify-dev-mcp with npx -y @shopify/dev-mcp@latest. Needs Node.js 18 or higherDeveloper docs and API schemas. No store data and no authenticationFree to run
ComposioHostedA url entry for https://connect.composio.dev/mcp, then a browser authorization. Whether Composio's page names Hermes Agent was not checked376 tools and 45 triggers listed for ShopifyThe free plan stops at 10,000 app tool calls a month. Standard is $18 per seat per month
Zapier MCPHostedAdd Zapier's MCP URL as a remote HTTP server and sign in. Hermes Agent is not named in the Zapier pages read for this guideThe Shopify actions of your Zapier account. Zapier's Shopify page lists 20 triggers and 38 actionsEach successful tool call uses two tasks from your Zapier plan
GeLi2001/shopify-mcp (open source)A Node process you runA command entry that runs npx shopify-mcp with your Client ID, Client secret and domain as arguments. Needs Node.js 18 or higher and a Shopify custom app31 tools: products 8, customers 8, orders 10, metafields 3, inventory 1, tags 1Free, MIT license. 239 GitHub stars, last push April 5, 2026

Ryze AI's older post, How to connect Google and Meta Ads with Hermes Agent, sets up Composio for ad platforms. It is a different route, and several servers can share config.yaml under different names. A ryze entry and a shopify-dev-mcp entry can sit side by side. With the Ryze AI connector your store data passes through Ryze AI.

Shopify options that do not fit Hermes Agent

  • Shopify CLI connector. Shopify describes it for developers who work on a store from their own computer and names Claude Code, Codex, Cursor and Visual Studio Code. It does not name Hermes Agent.
  • Shopify connectors for merchants. Shopify's help center lists a plugin for ChatGPT, a connector for Claude, Gemini, Grok, Muse and Perplexity, and a plugin for Microsoft Copilot. Hermes Agent is not on that list.
  • UCP MCP servers. Shopify's servers at https://{shop}/api/ucp/mcp serve catalog, cart and checkout for shopping agents, need an agent profile on every request and do not edit a store. The older Storefront MCP catalog and cart tools on https://{shop}/api/mcp were removed.

Which one to pick

Ryze AI is the best way to connect Hermes Agent to Shopify when you want product, collection, page and SEO edits next to your ad and search tools behind a single address, with one caveat: it has 5 Shopify tools on the default app, with no customer, discount or theme file access unless you bring a custom app, and it needs a Ryze AI plan or trial. If you only need Shopify's developer docs while you build an app, the Dev MCP server is free and needs no sign-in. The open source shopify-mcp server reaches customers and orders but runs on your machine with your own app credentials. Composio and Zapier make sense if your team already runs them.

Sources: Shopify AI Toolkit and Dev MCP, Storefront and UCP MCP, Shopify CLI connector, connecting AI tools, Composio Shopify toolkit, Composio pricing, Zapier MCP for Shopify, shopify-mcp on GitHub, Hermes Agent MCP documentation. Checked November 13, 2026; Hermes Agent and Shopify AI Toolkit pages November 20, 2026.

Hermes Agent, Shopify and MCP: dates that matter

DateWhat happened
March 20, 2025@shopify/dev-mcp 1.0.0 was first published on npm.
April 22, 2026Shopify's Storefront Catalog MCP began to implement UCP, with search_catalog, lookup_catalog and get_product. The previous search and lookup tools were kept until June 15, 2026.
June 24, 2026Shopify deprecated the Storefront MCP cart tools in favor of UCP Cart MCP tools, kept until August 31, 2026.
October 27, 2026@shopify/dev-mcp 1.18.0 was published, the newest on November 13, 2026.
November 20, 2026Shopify's AI Toolkit page listed Hermes among its install targets, with an install script. The Hermes Agent MCP documentation can change between builds, so run hermes mcp test ryze after an update.

Sources: @shopify/dev-mcp on npm, Storefront MCP, Shopify AI Toolkit. Checked November 13, 2026.

How this guide was tested

Two kinds of checks stand behind this guide: calls to the Ryze AI connector on November 13, 2026, and documentation read on November 13 and 20, 2026.

What was runWhat came back
Ten calls through the Ryze AI connector from Claude Code on a Shopify development store, November 13, 2026Reads of products, collections, pages, variants, orders count, themes and app scopes succeeded. customers and discountNodes were refused. The results are in the tested calls table.
The Hermes Agent MCP documentation, read on November 20, 2026It describes remote HTTP servers with auth: oauth, hermes mcp login, the token cache path, /reload-mcp, tool filters and the trust setting. Those pages are the source of every Hermes Agent step on this page.
Shopify's AI Toolkit page, read on November 20, 2026It lists Hermes with an install script and says the Dev MCP server runs locally and needs no authentication.

Not run for this guide: every step inside Hermes Agent, and the write and delete tools, because they change a store. Hermes Agent was not installed, so hermes mcp login ryze and the config.yaml entries follow its documentation. On paper the sign-in fits: Hermes Agent falls back to dynamic client registration, which is the only registration method the Ryze AI connector supports. The Ryze AI help center has no page for Hermes Agent, and Ryze AI was not tested there.

Hermes Agent and Shopify errors and fixes

The first table holds messages returned during the November 13, 2026 connector test. The fixes follow Ryze AI's, Shopify's and Hermes Agent's documentation.

Messages returned in the test

These messages came back word for word from Shopify or the connector.

Exact messageWhat caused itNext step in Hermes Agent
Access denied for customers field. (ACCESS_DENIED)The default connection has no read_customers scope.Connect your own custom app with read_customers on the Custom app tab in Ryze AI.
Access denied for discountNodes field. Required access: Apps must have `read_discounts` access scope. (ACCESS_DENIED)The default connection has no read_discounts scope.Use a custom app with read_discounts.
Query cost is 1729, which exceeds the single query max cost limit (1000). (MAX_COST_EXCEEDED)The query asked for 250 products with 250 variants and 250 metafields each.Ask for fewer items per page or split the request.
Field 'seoTitle' doesn't exist on type 'Product' (undefinedField)The field name does not exist. SEO fields sit under seo { title description }.Ask again and name the seo object.
This is a write operation (invalid_arguments from the read tool)A mutation was sent to shopify__read, which refuses and names the write tool.Repeat the request through shopify__write and approve it.

Other problems

The tools do not show up in Hermes Agent
Start a new session or run /reload-mcp. Then run hermes mcp test ryze, which reports what the server answered. Check that no tools.include or tools.exclude filter hides them and that the entry is not set to enabled: false. If Shopify was connected in Ryze AI after the login, run the login again and start a new session.
The browser sign-in times out
Editing config.yaml inside a running session triggers an automatic MCP reload with a 30-second timeout, too short for OAuth. Add the entry, then run hermes mcp login ryze from a fresh terminal. If you need longer than 5 minutes to approve, set oauth.timeout on the entry.
Hermes Agent cannot reach the callback on a server
Paste the redirect URL back at the prompt, forward the callback port over SSH, or sign in from the Desktop app or dashboard.
A 401 or 403 from the connector
Run hermes mcp login ryze again. With an API key, check that RYZE_API_KEY is set in ~/.hermes/.env and that the header reads Bearer followed by the rk_live_ key.
Shopify does not accept the store domain
Enter the .myshopify.com domain, not your custom domain, on the Shopify app tab.
Orders from before the last 60 days are missing
Without read_all_orders, Shopify returns only orders created within the last 60 days. The documented custom-app scope list in Ryze AI does not include read_all_orders.
Theme files or redirects cannot be changed
They are not available on the default Shopify app connection. Connect your own custom app instead.
The store is already live in another workspace
A store can be live in only one Ryze AI workspace at a time. Disconnect it there first.
The tools reply that a subscription is required
The Shopify tools need an active Ryze AI plan or free trial. Start the trial, then retry.
Requests fail behind a proxy
HTTP servers honor HTTPS_PROXY, HTTP_PROXY and NO_PROXY, so set them in the environment Hermes Agent starts from.

Terms on this page

Hermes Agent
An open source AI agent from Nous Research that you run on your own machine or server. Its MCP servers are listed in ~/.hermes/config.yaml under mcp_servers.
MCP
The Model Context Protocol, an open standard that lets large language models call tools on outside servers. The Ryze AI connector is a remote MCP server.
Admin GraphQL API
Shopify's API for reading and changing store data. The Ryze AI read and write tools send queries and mutations to it.
Access scope
A permission an app holds on a store, such as read_products or write_content.
Custom app
An app you create in the Shopify Dev Dashboard and connect to Ryze AI when the default app lacks a scope.
Query cost
The points Shopify charges for a GraphQL query. One query may not exceed 1,000 points.
Metafield
A custom field attached to a product, collection or other Shopify resource.

Sources: access scopes, rate limits, Hermes Agent MCP documentation. Checked November 13, 2026.

Frequently asked questions

How do I connect Hermes Agent to Shopify?

Connect your .myshopify.com store in Ryze AI under Integrations, then add a ryze entry with the URL https://connector.get-ryze.ai/mcp and auth: oauth under mcp_servers in ~/.hermes/config.yaml. Run hermes mcp login ryze, click Allow connection, then start a new session or run /reload-mcp.

Is there a Shopify MCP connector for Hermes Agent?

Yes, the Ryze AI connector at https://connector.get-ryze.ai/mcp. It is a remote MCP server with 5 Shopify tools, and Hermes Agent supports remote HTTP servers with OAuth. Shopify also lists Hermes on its AI Toolkit page with an install script that adds a plugin.

Does Shopify have its own MCP server for Hermes Agent?

Shopify's Dev MCP server runs locally with npx -y @shopify/dev-mcp@latest and holds developer docs and API schemas, with no store data and no authentication. Its AI Toolkit page lists Hermes with an install script. Neither is a hosted server for editing your store.

Does Hermes Agent have a Shopify MCP server built in?

The Hermes Agent documentation page read for this guide names no Shopify entry. Add Shopify through a url entry in config.yaml, such as the Ryze AI connector.

What access does Hermes Agent get on my store?

The scopes of the Ryze AI Shopify app: read and write for products, content, metaobjects, themes and publications, and read for orders, analytics and reports. Customers, discounts and orders older than 60 days are not included.

Can Hermes Agent change my Shopify store?

Yes, within the app scopes. Through Ryze AI it can create and update products, collections, pages and blog content and their SEO fields, edit text in place, and delete resources when you ask. To have Hermes Agent ask first, set trust: untrusted on the ryze entry.

How do I make it read-only?

In Hermes Agent, list shopify__read and shopify__search_content under tools.include on the ryze entry, which hides the write and delete tools from the agent. That is a client-side filter and Shopify does not enforce it.

Does Hermes Agent need a paid plan for MCP?

No. Hermes Agent is open source under the MIT license per its GitHub repository and self-hosted. The Ryze AI side needs a plan or trial for the Shopify tools: Paid Ads at $89 per month with a 7-day free trial.

Should I use OAuth or an API key?

Use OAuth when you can open a browser, because hermes mcp login ryze handles the sign-in and Hermes Agent refreshes the tokens. Use a Ryze AI API key in a bearer header for servers and scripts where nobody can click Allow connection.

Does it work on a headless server or a VPS?

Yes, with an extra step for the sign-in. Paste the redirect URL back at the prompt, forward the callback port over SSH, or use the Desktop app or dashboard. An API key avoids the browser entirely.

Can I connect more than one Shopify store?

Yes. A workspace can hold several stores, added with View > Add one more account on the Shopify card. The agent uses the primary store unless you name another. One store cannot be live in two Ryze AI workspaces.

Can Hermes Agent edit my theme or read customers?

Not on the default connection. Theme file edits, URL redirects and customer records need your own custom app, connected on the Custom app tab in Ryze AI.

Why do the Shopify tools not show up in Hermes Agent?

Start a new session or run /reload-mcp, then run hermes mcp test ryze. Check that no tools.include or tools.exclude filter hides them and that the entry is not set to enabled: false. Also confirm that Shopify is connected in Ryze AI before the login.

How much does it cost?

Adding the connector is free. The Shopify tools need a Ryze AI plan or trial: Paid Ads is $89 per month with a 7-day free trial, SEO Starter is $129 per month with a 3-day free trial, Agency is $279 per month, and annual billing takes 30% off the first year. Hermes Agent itself is free software.

How do I disconnect Shopify from Hermes Agent?

Set enabled: false on the ryze entry or delete it from config.yaml, and delete ~/.hermes/mcp-tokens/ryze.json. To remove the store connection itself, disconnect Shopify on its card in Ryze AI or uninstall the app in Shopify admin.

Sources

Checked November 13, 2026.

Connect Shopify to Hermes Agent

One Ryze AI connection gives Hermes Agent 5 Shopify tools. Paid Ads is $89 per month with a 7-day free trial; annual billing takes 30% off the first year.

Shopify MCP server

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