OpenClaw

Connect the SERPHouse MCP Server to OpenClaw for always-on search in your personal AI assistant.

OpenClaw is the open-source personal AI assistant that connects Discord, Telegram, WhatsApp, Slack, and more to AI agents on your own hardware. It runs as a persistent Gateway daemon with memory that survives across sessions. By adding the SERPHouse MCP Server, OpenClaw can pull live Google, Bing, and Yahoo results from any channel.

Why SERPHouse + OpenClaw

The Gateway runs 24/7 on your own hardware, so SERPHouse search is always one message away. No browser, no scraping, no maintenance.

What You'll Build

Capability	How it works
Always-on search	Message from any platform, get live Google / Bing / Yahoo results back
Local business data	Google Local results for nearby businesses on demand
Media search	Bing Images, Google News, Yahoo News from any channel
Multi-engine compare	Ask for the same query across engines and get a comparison

Prerequisites

A machine running Linux or macOS to host the Gateway
An active SERPHouse account (free credits included on signup)
A SERPHouse API key from your dashboard

OpenClaw's install wizard asks for a model provider and API key during onboarding. Have those ready.

Step 1: Get Your SERPHouse API Key

Open your Dashboard and copy the API key shown there.

Keep it handy. You'll add it to OpenClaw 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 OpenClaw

If you haven't set OpenClaw up yet:

curl -fsSL https://openclaw.ai/install.sh | bash
openclaw onboard --install-daemon

Run the install script above.

Run openclaw onboard --install-daemon to start onboarding and install the Gateway as a background daemon.

Follow the wizard: pick a model provider, set an API key, and configure the Gateway.

Confirm the daemon is running:

openclaw gateway status

Already running OpenClaw?

Skip straight to the next step. The SERPHouse server plugs into an existing install without re-onboarding.

Step 3: Add the SERPHouse MCP Server

MCP server definitions live under mcp.servers in ~/.openclaw/openclaw.json. Add the SERPHouse hosted endpoint:

{
  "mcp": {
    "servers": {
      "serphouse": {
        "url": "https://mcp.serphouse.com/YOUR_SERPHouse_API_KEY/mcp",
        "transport": "streamable-http",
        "enabled": true
      }
    }
  }
}

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

Restart the Gateway to pick up the new definition:

openclaw gateway restart

Prefer the CLI?

The same server can be added in one command:

openclaw mcp add serphouse \
  --url https://mcp.serphouse.com/YOUR_SERPHouse_API_KEY/mcp \
  --transport streamable-http

Other ways to add it

You can also add the server from the Control UI: Settings → MCP → Add server, or in a chat via + → Connectors → Add MCP server….

Step 4: Verify the Server

Probe the server to confirm it connects and advertises tools:

openclaw mcp doctor serphouse --probe

Probe passes

A successful probe lists the SERPHouse tools (search, images, news, and more) that OpenClaw can now call.

Run the doctor probe above.

Confirm serphouse reports connected and the tool list is non-empty.

Message your assistant from any channel and ask your first search query.

Using SERPHouse

Once connected, message your assistant from any channel. OpenClaw picks the right SERPHouse tool automatically.

Try these example prompts to get started

Pick any prompt and send it from Discord, Telegram, WhatsApp, Slack, or the web chat.

Where do we rank for "crm software" on Google US desktop?
Who owns the top 5 spots for "project management software" in London?

Troubleshooting

Issue	Solution
Server appears but exposes no tools	Run `openclaw mcp doctor serphouse --probe`. Check `toolFilter.include`/`exclude` if you added one.
401 Unauthorized	Verify your API key is valid and active in your dashboard.
Changes don't reach the agent	Restart the Gateway or run `openclaw mcp reload`.
Credits exhausted	Check your account credit balance in the SERPHouse dashboard.
Yahoo search fails	Use a regional domain: call the domain list tool first; `yahoo.com` is invalid.

Still stuck?

Re-verify your API key, credit balance, and the endpoint URL first. If it persists, contact SERPHouse support at [email protected].

What You'll Build

Prerequisites

Step 1: Get Your SERPHouse API Key

Step 2: Install OpenClaw

Step 3: Add the SERPHouse MCP Server

Prefer the CLI?

Step 4: Verify the Server

Using SERPHouse

Troubleshooting

Hermes

MCP Server

Agent Skills

On this page