Hermes

Connect the SERPHouse MCP Server to Hermes Agent for persistent, self-improving web search in your personal AI assistant.

Hermes Agent is the open-source, self-improving AI agent built by Nous Research. It runs anywhere, remembers across sessions, and connects to 20+ messaging platforms. By adding the SERPHouse MCP Server to Hermes, your personal agent gains live Google, Bing, and Yahoo search across every platform you use it on.

Why SERPHouse + Hermes

No browser, no scraping, no rate-limit headaches. Hermes gets structured, real-time SERP data from 30+ search engines with a single hosted MCP endpoint. Zero extra infrastructure to run.

What You'll Build

Capability	How it works
Live web search	Hermes calls `mcp_serphouse_search` for fresh Google results on demand
News & media	Google / Bing / Yahoo news, images, and videos from any connected platform
Rank tracking	Ask about your position for any keyword, engine, and location
Daily briefings	Cron-scheduled SERPHouse searches delivered to Telegram, Discord, and more

Prerequisites

An active SERPHouse account (free credits included on signup)
A SERPHouse API key from your dashboard
A machine with Bash and network access to install Hermes

Hermes supports macOS and Linux. Windows users can use WSL2.

Step 1: Get Your SERPHouse API Key

Open your Dashboard and copy the API key shown there.

Keep it somewhere safe. You'll paste it into the Hermes config next.

Keep your key secure

Your API key maps directly to your credit usage. Never commit it to a repository, share it in public channels, or paste it into a screenshot.

Step 2: Install Hermes

Install the latest Hermes Agent with the official script:

curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash

Run the installer above in your terminal.

Follow the on-screen prompts to pick your model provider and set your API key.

Confirm the CLI is available:

hermes --version

Prefer a guided setup?

The installer accepts flags like --yes for unattended installs. Run

curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash -- --help

to see every option.

Step 3: Add the SERPHouse MCP Server

MCP servers are declared in ~/.hermes/config.yaml under mcp_servers. Open the file and add the SERPHouse hosted endpoint:

mcp_servers:
  serphouse:
    url: "https://mcp.serphouse.com/YOUR_SERPHouse_API_KEY/mcp"

Replace YOUR_SERPHouse_API_KEY with your actual SERPHouse API key. The key is forwarded to the SERPHouse API as a Bearer token.

Step 4: Start (or Restart) Hermes

hermes chat

Tools auto-register

SERPHouse tools are discovered and registered automatically at startup. Tools appear as mcp_serphouse_*, for example mcp_serphouse_search.

Step 5: Verify the Server

To confirm the server is reachable before using it, reload the MCP config inside a session:

/reload-mcp

Any connection error will be reported immediately.

Type /reload-mcp in the chat session.

Watch for a confirmation that serphouse connected with no errors.

Ask your first search query (see below).

Tune the tool surface

You can narrow the tool surface at any time by editing the server entry. See the Hermes MCP docs.

Using SERPHouse

Once connected, just ask. Hermes picks the right SERPHouse tool automatically.

Try these example prompts to get started

Pick any prompt and send it to Hermes from any connected platform.

Where do we rank for "crm software" on Google US desktop?
Show me the top 20 results for "AI SEO tools" using max_pages.

Scheduling Searches

Hermes has built-in cron. Combine it with SERPHouse for daily briefings delivered to any connected platform:

/cron add "0 7 * * *" "Search Google News for 'AI SEO' and send a summary here."

Make it yours

Swap the time, query, or channel in the cron expression to fit your routine, like a Monday-morning competitor digest or a Friday industry roundup.

Troubleshooting

Issue	Solution
Server doesn't load	Verify the entry is valid YAML under `mcp_servers` and restart Hermes.
401 Unauthorized	Verify your API key is valid and active in your dashboard.
Tools not appearing	Run `/reload-mcp` or restart Hermes; then ask for a search.
Credits exhausted	Check your account credit balance in the SERPHouse dashboard.
Yahoo search fails	Call the domain list tool first. `yahoo.com` is invalid; use a regional domain like `uk.yahoo.com`.

Still stuck?

Most issues are fixed by re-verifying your API key, credit balance, and the endpoint URL. If it persists, contact SERPHouse support at [email protected].