Skip to content

Connect Hermes Agent to Semrush

Connect Hermes Agent to Semrush: 1. Sign in to ApexGenius and connect Semrush. 2. Add the ApexGenius MCP server. 3. Start using Semrush in Hermes Agent.

Connect SemrushSee the setup

7 days free · No card required

How to connect Semrush to Hermes Agent

  1. 1Sign in to ApexGenius and connect Semrush
  2. 2Add the ApexGenius MCP server to Hermes Agent
  3. 3Start using Semrush in Hermes Agent

FirstConnect Semrush to ApexGenius

ThenConnect ApexGenius to Hermes Agent

Semrushsemrush.com/accounts/profile/api-keys/1 of 3

Connect Semrush. Create an API key in Semrush. You paste it into ApexGenius once.

Then ask Hermes Agent:

Show a Semrush domain overview for my website in the US database. Run only that one report.

Written setup, step by stepShow

Before you start

  • A Semrush plan with API access. SEO data needs Semrush One Starter or Pro+, or SEO Classic Pro or Guru. SEO Classic Business and Semrush One Advanced need an API units package. Traffic and market data need a Trends API plan.
  • A Semrush API key from your Semrush profile under API Keys.

1. Connect Semrush to ApexGenius

  1. Copy an API key in Semrush. In Semrush, click your profile icon at the top right, then choose API Keys in the My profile sidebar. Copy an existing key, or choose + Create API key for a new v4 key. A new key is shown in full only once, so copy it right away.
    The full Semrush API keys page before sign-in, with a red box around Log in.
    The API keys page asks you to log in first. After you sign in, copy a key from My profile, API Keys.Open full-size image (opens in a new tab)
  2. Open Semrush in Connections. Sign in to ApexGenius, open Connections, choose Semrush, and select Connect.
  3. Enter the API key. Paste the key. ApexGenius supplies the mcp.semrush.com address, checks the key with Semrush's MCP, and stores it encrypted.
  4. Check the connection. Open Tools, then ask your AI the question below. Compare the answer with Semrush and check Tool Activity.
Connect Semrush →

2. Connect ApexGenius to Hermes Agent

Use this server address when adding the connection:

https://server.autom8.pro/mcp
  1. Add ApexGenius as a remote MCP server in your Hermes Agent configuration using the hosted HTTP URL, then complete the authorization in your browser.
  2. When ApexGenius asks what this AI client may use, choose Read only for the first test, or Custom to limit it to the tools you need.
  3. Start a new conversation and select ApexGenius from the available tools before asking for live data.

3. Verify one safe read

Show a Semrush domain overview for my website in the US database. Run only that one report.

Show a Semrush domain overview for my website in the US database. Run only that one report.

Compare the numbers with Domain Overview in Semrush. Every report spends Semrush API units, including this one. Check your balance under My Profile > Subscription info > Summary.

What Hermes Agent can do in Semrush

14 operations. Read looks things up and changes nothing. There are no write tools, so Hermes Agent cannot change Semrush through ApexGenius.

Read14 operations

Looks things up. Changes nothing.

Domains and traffic

  • domain_overviewList the domain overview reports you can run for a domain.
  • traffic_overviewList the website traffic reports you can run.
  • competitors_researchList the competitor reports you can run for a domain.

Keywords and ads

  • organic_researchList the organic search reports you can run for a domain.
  • keyword_researchList the keyword research reports you can run.
  • paid_search_researchList the paid search reports you can run.
  • shopping_researchList the shopping research reports you can run.

Links and audience

  • backlinks_researchList the backlink reports you can run.
  • audience_researchList the audience reports you can run.

Projects and tracking

  • projectsList the reports you can run on your Semrush projects.
  • position_trackingList the Position Tracking reports you can run.
  • site_auditList the Site Audit reports you can run.

Run a report

  • get_report_schemaRead the parameters one report takes before you run it.
  • execute_reportRun one report and return its data. Spends Semrush API units.

You choose what Hermes Agent can use

When you approve Hermes Agent, pick Full access, Read only, or Custom. Read only allows the Read operations and nothing else. Custom picks apps and tools one by one.

Limits in Semrush

  • · Semrush's MCP is read-only. It reads reports and project data. It cannot create projects, change settings or edit anything in Semrush, so there is nothing to undo.
  • · Every report spends API units from your Semrush plan, the same as a direct API request. Semrush charges no extra fee for MCP. Ask for fewer rows to spend fewer units.
  • · The key covers your Semrush account. One saved connection holds one key; connect again for a second account.
  • · Disconnecting stops ApexGenius access. It does not restore units a report already spent. Manage or revoke the key itself in Semrush under API Keys.

What it looks like in Hermes Agent

An illustrative read-only request and response. Your results come from the account and dates you choose.

How the route works
Hermes Agent
Hermes AgentApexGenius MCP route
Show a Semrush domain overview for my website in the US database. Run only that one report.
ApexGenius
Working with ApexGenius1 tool search · 3 reads
RequestDomain overview
Account scopeAuthorized connections checked
apex_search_toolsSemrush domain reports · Find the Semrush report routeComplete
apex_call_read_tooldomain_overview · Find domain overview reportsComplete
apex_call_read_toolget_report_schema · Read the report parametersComplete
apex_call_read_toolexecute_report · Run the one reportComplete
Hermes Agent

Illustrative example: the overview returns the domain’s organic and paid search summary for the US database. One report ran and spent Semrush API units. Nothing was changed.

Read-only route
Hermes Agent

Try asking

“Show a Semrush domain overview for my website in the US database. Run only that one report.”

“Which domains compete with my website in organic search? Keep it to the top ten.”

“Find related keywords for "project management software" with search volume. Limit it to 20 rows.”

“List my Semrush projects and summarize the latest Position Tracking results for one of them.”

More connections like this one

One ApexGenius account covers every pair below. Connect an app once and each agent you allow can use it.

Questions people ask first

Which Semrush plans work?

SEO data needs Semrush One Starter, Semrush One Pro+, SEO Classic Pro or SEO Classic Guru. Those plans include 50,000 API units that refresh on your renewal date. SEO Classic Business and Semrush One Advanced work with an API units package. Traffic and market data need a Trends API plan, Basic or Premium.

Does it use my Semrush API units?

Yes. Each report uses the same API units as a direct Semrush API request, and Semrush charges no extra MCP fee. Check your balance in Semrush under My Profile > Subscription info > Summary.

Where do I find my Semrush API key?

In Semrush, click your profile icon at the top right and choose API Keys in the My profile sidebar. Copy a key, or choose + Create API key for a new v4 key. A new key is shown in full only once.

Can my AI change anything in Semrush?

No. Semrush's MCP only reads. It can read your projects but cannot create projects, change settings or edit data, so there is nothing to undo.

Why an API key instead of signing in to Semrush?

ApexGenius connects with the API key method Semrush documents for AI agents. The key is sent only to mcp.semrush.com and stored encrypted. You manage the key itself in Semrush under API Keys.

Connect Semrush to Hermes Agent today

Start free

7 days free. No card required. Disconnect any time.