For the complete documentation index, see llms.txt. This page is also available as Markdown.

OpenCode

OpenCode is an open-source AI coding assistant that supports Model Context Protocol (MCP) servers. By connecting the SERPHouse MCP Server, OpenCode can use SERPHouse as a native search provider for SEO research, Google Search, News, Images, Shopping, and other supported tools.


Prerequisites

Before configuring SERPHouse MCP Server, ensure you have:

  • OpenCode installed

  • An active SERPHouse account

  • A valid SERPHouse API key


Configure the SERPHouse MCP Server

Edit ~/.config/opencode/opencode.json (or your project-local opencode.json) and add:

{
  "mcp": {
    "serphouse": {
      "enabled": true,
      "type": "remote",
      "url": "https://mcp.serphouse.com/YOUR_SERPHouse_API_KEY/mcp"
    }
  }
}

Replace YOUR_SERPHouse_API_KEY with your actual SERPHouse API key. Save the configuration. Close the current OpenCode session, then start a new session.


Verify Configuration

Open a new session and ask:

If configured correctly, OpenCode automatically calls the SERPHouse MCP server.


Using SERPHouse

Once configured, OpenCode automatically invokes SERPHouse whenever a request requires search engine data.

Example prompts:

No additional commands are required during normal usage.


Troubleshooting

Server doesn't load — Verify that your OpenCode configuration file contains valid JSON. OpenCode ignores invalid MCP configurations without displaying an error.

Unable to connect to the MCP server — Confirm your MCP endpoint is in the format https://mcp.serphouse.com/YOUR_SERPHouse_API_KEY/mcp and that your internet connection or firewall is not blocking outbound HTTPS requests.

401 Unauthorized or Authentication failed — Verify that your SERPHouse API key is valid and active. Ensure you've replaced YOUR_SERPHouse_API_KEY in the endpoint URL with your actual API key. Make sure there are no extra spaces or missing characters in the API key.

SERPHouse tools are unavailable — Restart OpenCode after saving your configuration. MCP servers are loaded when a new session starts.

Tool calls fail or return no results — Check the OpenCode debug logs (opencode --debug) for MCP connection or configuration errors. Most issues are caused by an incorrect endpoint URL, malformed configuration, or an invalid API key.

Search requests return no data — Verify that your SERPHouse account has available API credits and that the requested search feature is enabled for your account.

Still having issues? — Remove the SERPHouse MCP configuration, add it again, restart OpenCode, and verify that your configuration matches the latest documentation.

Last updated