Hermes Agent SEO: One MCP Server, Your Real Data

Hermes Agent has a built-in MCP client, so SEOmatic plugs in with one command and a browser sign-in. From the terminal, Telegram or Discord, Hermes can then read your Google Search Console, audit pages, check how AI answers describe you, and on paid plans stage fixes that wait for your approval.

One hermes mcp add, OAuth in the browser, no key to copy
Works from the CLI and from Hermes's chat channels
Staged fixes wait for you in SEOmatic

Connect Hermes Agent free

Hermes Agent

About SEOmatic for Hermes Agent

SEOmatic is a hosted MCP server that Hermes Agent adds under mcp_servers. Hermes signs in with OAuth (dynamic client registration is automatic) or an API key, and then calls SEOmatic's SEO tools on one workspace.

Last Updated

November 2026

Requirements

Hermes Agent installed and set up, and a free SEOmatic account. For a server with no browser, create an API key in Settings, AI Agents, API Keys.

Pricing

Free to connect. Search Console, audits and page checks have no limit; market data uses 5 free questions a month (plus a one-time 10 when you connect Search Console). Paid plans add agents that stage fixes for your approval. See pricing.

Full Docs

Endpoint, auth, every tool and what it costs: SEOmatic MCP server docs.

Hermes Agent for SEO, With Your Own Numbers

SEO Jobs Hermes Agent Can Take On

Friday Search Console Recap

A scheduled job that compares the week with the one before and posts the result to your Telegram or Discord.

AI Answer Review

Which AI assistants name you for the questions your customers ask, what they cite, and which competitors they prefer.

Lost-Clicks Diagnosis

The pages and queries behind a drop, whether it is seasonal, and the most likely cause for each page.

Index Coverage Check

Hermes inspects a list of URLs in Search Console and reports which ones Google skipped, and why.

Content Gaps From Real Queries

Queries that already bring impressions but have no page that answers them well, ready to turn into briefs.

Staged Fixes

On paid plans, Hermes stages new titles, descriptions, content updates and internal links for you to approve.

Hermes Agent is built to keep going: it runs from a terminal, answers in chat apps and can repeat a job on a schedule. Those three traits suit SEO work that is mostly checking, comparing and following up.

Example: Ask Hermes Agent About Your Site

An example on the Acme Plumbing demo site. You ask Hermes Agent:

“Do AI assistants recommend us for emergency plumber searches?”

Hermes Agent calls SEOmatic:

mcp__seomatic__ai_citations: latest scan, Oct 6
mcp__seomatic__gsc_performance: /emergency-plumber, Sep 12 to Oct 9 (28 days)

Hermes Agent answers:

Partly. In your Oct 6 scan, AI answers named Acme Plumbing in 3 of 8 emergency-plumber prompts:

Google AI Overviews: named you in 2 of 3, and cited /emergency-plumber.
ChatGPT: named you once, for “24 hour plumber near me”.
Claude: did not name you. It named two competitors that list response times and prices.

On Google, /emergency-plumber had 1,840 impressions and 52 clicks from Sep 12 to Oct 9 (28 days). The page has no response time and no service area list, which the competitors both show.

Want me to stage a content update for that page? In Approval mode, nothing changes until you approve it.

Also try:

“Every Friday, send me what changed on Google”
“Which pages lost clicks this month?”
“Is /drain-cleaning-cost indexed?”
“Audit /water-heater-repair”

How Hermes Agent Uses SEOmatic's Tools

Hermes treats every MCP server the same way: it lists the tools at startup and calls them by name. With SEOmatic connected, you will see tools such as mcp__seomatic__gsc_performance, mcp__seomatic__gsc_insights, mcp__seomatic__gsc_indexing, mcp__seomatic__site_pages and mcp__seomatic__ai_citations.

A few habits make the answers better:

Connect Search Console first. Without it, Hermes can still audit pages, but it cannot see your clicks or rankings.
Ask one job per message. “Which pages lost clicks since Sep 12?” beats “check my SEO”.
Put recurring checks on a schedule. Hermes can run a job every week and send the result to Telegram or Discord.
Approve in SEOmatic. When Hermes stages a fix, it gives you a link. The decision is yours, made there.

Hermes Agent SEO Prompts to Start With

Try these in Hermes, from the CLI or any chat channel you connected:

“Compare my Google clicks this week with last week and tell me which pages moved most.”
“Which AI assistants mention us for our main service, and who do they name instead?”
“My organic traffic fell this month. Find the pages that lost the most clicks and tell me why.”
“Check whether these five URLs are indexed and explain any that are not.”
“Which queries get impressions but have no page that really answers them?”
“Every Friday at 4 pm, send me a short Search Console recap. Ask before you stage anything.”

What Hermes Agent Can Reach Through SEOmatic

Search Console: clicks, impressions, CTR and position by page or query, period comparisons, striking-distance keywords and cannibalization.
Indexing: whether Google indexed a URL, and the reason when it did not.
Audits: a crawl of up to 30 pages, or a 0 to 100 score for one URL.
AI visibility: the prompts where ChatGPT, Claude or Google AI Overviews named you, and who they named instead.
Market research: keyword volumes, backlinks and SERP competitors, from your free questions or your paid plan's credits.
Tasks and campaigns on paid plans: staged fixes and new content that wait for your approval.

Every tool, with its parameters and cost, is in the SEO MCP server reference.

How It Works, Step by Step

You ask Hermes Agent a question in the terminal or a chat app.
Hermes picks the SEOmatic tools it needs from the mcp__seomatic__ list and calls them on your workspace.
SEOmatic returns your Search Console data, audits or AI visibility results, each with its date range.
Hermes explains what it found and suggests the next step.
On a paid plan, if you say yes, Hermes stages the fix in SEOmatic and gives you the review link. You approve it, and SEOmatic applies it through your CMS with a rollback point.

How to Connect SEOmatic to Hermes Agent

Setup takes about a minute on a machine with a browser. On a headless server, use the device-code login or the API-key lines in the code block.

Add the server. Run hermes mcp add seomatic --url https://app.seomatic.ai/api/mcp --auth oauth in your terminal. When Hermes lists SEOmatic's tools and asks to enable all of them, answer Y.
Sign in. Hermes opens your browser. Sign in to SEOmatic or create a free account, approve access and pick your site.
Test the connection. Run hermes mcp test seomatic. It should list SEOmatic's tools without errors.
Connect Search Console. If you have not yet, connect Google Search Console in the SEOmatic dashboard so Hermes can see your clicks and rankings.
Ask your first question. Start Hermes and ask: “How is my site doing on Google this month?” Check that the answer names a date range and your real numbers.

Hermes Agent setup

# OAuth (opens your browser once)
hermes mcp add seomatic --url https://app.seomatic.ai/api/mcp --auth oauth
hermes mcp test seomatic

# Or in ~/.hermes/config.yaml (then restart Hermes or run /reload-mcp)
mcp_servers:
  seomatic:
    url: "https://app.seomatic.ai/api/mcp"
    auth: oauth

# No browser on this machine? Sign in with a code from another device
hermes mcp login seomatic --flow device

# Or use an API key instead of OAuth (Hermes asks for it and saves it to ~/.hermes/.env)
hermes mcp add seomatic --url https://app.seomatic.ai/api/mcp --auth header

# The same API key setup by hand: put SEOMATIC_API_KEY in ~/.hermes/.env
mcp_servers:
  seomatic:
    url: "https://app.seomatic.ai/api/mcp"
    headers:
      Authorization: "Bearer ${SEOMATIC_API_KEY}"

Hermes names the tools mcp__seomatic__<tool>, for example mcp__seomatic__gsc_performance. If hermes mcp test seomatic fails on a server, the browser sign-in had nowhere to open: run hermes mcp login seomatic --flow device and enter the code on any device with a browser, or switch to the API-key config and set SEOMATIC_API_KEY where Hermes runs. After editing config.yaml by hand, restart Hermes or run /reload-mcp. If the tools were there and then vanish mid-session, or Hermes answers without calling them, run hermes mcp test seomatic, then /reload-mcp; if that does not bring them back, restart Hermes (or its gateway). A tool you left out at the enable-all prompt stays off until you run hermes mcp configure seomatic.

MCP with OAuth, MCP with an API key, or the skill?

Route	Best for	How
MCP server with OAuth	Most people, on a laptop or any machine with a browser	`hermes mcp add seomatic --url https://app.seomatic.ai/api/mcp --auth oauth`, or add `seomatic: { url, auth: oauth }` under `mcp_servers` in `~/.hermes/config.yaml`. No browser on that machine? `hermes mcp login seomatic --flow device` signs in with a code from another device.
MCP server with an API key	Headless servers and Docker setups where no browser can open	`hermes mcp add seomatic --url https://app.seomatic.ai/api/mcp --auth header` asks for the key and saves it to `~/.hermes/.env`. Or add `headers: { Authorization: "Bearer ${SEOMATIC_API_KEY}" }` to the seomatic entry in `config.yaml` and put `SEOMATIC_API_KEY` in `~/.hermes/.env` or the environment Hermes runs in.
SEOmatic skill	People who want Hermes to run SEO checks through a CLI in its terminal tool	`npx skills add Minh42/seomatic-mcp -a hermes-agent -g` installs into `~/.hermes/skills` (without `-g` it lands in `.hermes/skills` of the folder you run it from). Put `SEOMATIC_API_KEY` in `~/.hermes/.env`, then check with `hermes skills list`.

Pick MCP with OAuth. Hermes handles the sign-in itself, every SEOmatic tool shows up as mcp__seomatic__<tool>, and there is no key to store. Use the API-key line on a server with no browser.

Fix SEO on Your CMS From Hermes Agent

Hermes Agent reads Google Search Console through SEOmatic, and the fixes you approve go live in your CMS. Pick your platform for the exact steps:

Hermes Agent or Hermes Models: Which One Is This?

This page is about Hermes Agent, the open-source agent from Nous Research that runs in your terminal and in chat apps, with its own MCP client, skills and scheduled jobs.

Hermes models are Nous Research's language models. A model on its own cannot connect to SEOmatic; an agent that runs it can.
OpenClaw and nanoclaw are separate open-source agents with their own setup: OpenClaw SEO and nanoclaw SEO.

Whichever model Hermes Agent runs on, the SEOmatic connection is the same.

What Is Free and What Is Paid

Connecting is free, and so is the SEOmatic account behind it: no card. Free covers the diagnosis with no limit: Search Console reports and insights, site audits of up to 30 pages, live page analysis, and your AI visibility results.

Live market data, like keyword volumes, backlink profiles and competitor domains, uses free questions: 5 a month, plus a one-time 10 bonus questions when you connect Google Search Console. One question covers up to 5 lookups.

Paid plans remove the question limit and add the treatment: agents stage fixes on your site (titles, descriptions, content updates, technical fixes, internal links) and run campaigns and fresh AI visibility scans. Every paid plan starts with a 14-Day Trial for $1, credited to your first payment. See pricing.

Hermes can chain several tools for one question, and each call counts. A scheduled weekly recap usually takes two or three calls, so it is best on a paid plan.

Nothing Changes on Your Site Without Your Approval

Hermes Agent can run on its own schedule and answer from chat apps, so SEOmatic draws a hard line: Hermes can stage changes, never approve them. A staged change is a proposal: it says what will change and why, and in Approval mode nothing touches your site until you approve it. The assistant records your decision, and it is told never to approve anything on its own judgment. Approved fixes start within seconds, the page's previous state is stored, and any applied change can be rolled back. Changes that could take a page out of Google, like a noindex, need an extra explicit confirmation. If you share a Hermes channel with other people, they can ask questions, but approving a change still takes a signed-in SEOmatic user.

Keep Exploring

Running another open agent? See OpenClaw SEO, nanoclaw SEO or Kimi K3. Managing a team of agents? See Paperclip. Learn what powers the answers: AI visibility tracking, the Google Search Console integration and content decay checks. All agents: AI SEO agents in every assistant. Full reference: SEO MCP server docs.

Using another agent? See OpenClaw, nanoclaw, Kimi K3, or every AI agent.

Frequently Asked Questions

How do I connect SEOmatic to Hermes Agent?

Run hermes mcp add seomatic --url https://app.seomatic.ai/api/mcp --auth oauth. Hermes opens your browser, you sign in to SEOmatic and pick your site. Then run hermes mcp test seomatic to check the tools load, and ask Hermes a question about your site.

Do I need an API key for Hermes Agent?

Not on a machine with a browser. Hermes uses OAuth with automatic client registration, so you sign in once and Hermes stores the token. On a headless server, run hermes mcp login seomatic --flow device and finish the sign-in with a code on another device, or create an API key in SEOmatic and send it as an Authorization header from config.yaml.

What do the SEOmatic tools look like in Hermes?

Hermes prefixes MCP tools with the server name, so they appear as mcp__seomatic__gsc_performance, mcp__seomatic__site_pages, mcp__seomatic__ai_citations and so on. You do not need to call them by name; ask in plain language and Hermes picks the right ones.

Can Hermes Agent send me SEO reports on Telegram?

Yes. If Hermes is connected to Telegram, Discord or another chat app, ask it to run a Search Console recap on a schedule and post the result there. Ask it to message you only when something changed, so the reports stay short.

Does it matter which model Hermes Agent runs on?

Not for the connection. SEOmatic does the data work and returns the same results whatever model Hermes uses. A stronger model writes better explanations and picks tools more reliably.

Are the numbers from my real Search Console?

Yes. SEOmatic reads your connected Google Search Console and returns exact date ranges, for example Sep 12 to Oct 9, 28 days. Hermes is told to state only numbers that came from a tool result.

Is SEOmatic for Hermes Agent free?

Yes. Connecting and the SEOmatic account are free, with no card. Search Console reports, site audits and page checks are free with no limit. Live market data (keyword volumes, competitors, backlinks) uses free questions: 5 a month, plus a one-time 10 when you connect Search Console. Paid plans remove the limit and add agents that stage fixes, with a 14-Day Trial for $1, credited to your first payment.

Can it change my site without asking?

No. By default every change SEOmatic proposes waits for your approval before it touches your site, and your assistant is told never to approve on its own. Approved changes are stored with the page's previous state, so any edit to an existing page can be rolled back. If you later want low-risk fixes to go ahead on their own, you can turn that on in your autonomy settings; changes to your URLs or indexing, and new content, still wait for you.

hermes mcp test seomatic fails. What now?

On a server with no browser, the OAuth sign-in cannot open. Run hermes mcp login seomatic --flow device and enter the code on any device with a browser, or replace auth: oauth with an Authorization header that reads SEOMATIC_API_KEY, set that variable where Hermes runs, and test again. On a laptop, rerun hermes mcp add and finish the sign-in in the browser tab it opens.

Hermes lists SEOmatic's tools but never uses them. What now?

Run hermes mcp test seomatic to check the server is connected, then /reload-mcp in the chat. A long-running Hermes process can drop an HTTP server's tools after a network blip, and a restart of Hermes (or its gateway) brings them back. If only some tools are missing, run hermes mcp configure seomatic and turn them on. Then ask again and name SEOmatic in the question.

Is this better than giving Hermes a Search Console API key?

It is less setup and more useful. A raw Search Console connection needs a Google Cloud project and returns rows. SEOmatic connects Search Console with a normal Google sign-in and adds comparisons, indexing reasons, audits, AI visibility and fixes you can approve.

SEOmatic in other AI agents

Same server, same tools, same approval rules. Pick the agent that fits the job.

Claude Cowork

Hand Claude Cowork the SEO grunt work: it pulls your real numbers, writes the report into your files, and stages fixes you approve.

Meta Muse

Connect SEOmatic with one message, sign in or hand Muse a key, then ask Muse about your site from the app or muse.ai.

Perplexity Computer

Give Perplexity Computer your real Search Console data, so its SEO projects start from your numbers.

OpenClaw

Your self-hosted OpenClaw, answering SEO questions from real Search Console data in the chat app you already use.

nanoclaw

SEO answers from your real Search Console, inside the nanoclaw group where your team already talks.

Manus

Add SEOmatic as a custom MCP server and Manus runs SEO tasks on your real Search Console data.

View All Integrations