> For the complete documentation index, see [llms.txt](https://docs.serphouse.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.serphouse.com/mcp-server.md).
# MCP Server
### Overview
The SERPHouse MCP Server enables AI assistants to access SERPHouse APIs through the Model Context Protocol (MCP). Once configured, supported AI clients can perform Google searches, retrieve SERP data, analyze search results, and use SERPHouse tools directly within conversations.
The SERPHouse MCP Server is fully managed by SERPHouse, so there's no server to install, host, or maintain.
#### Endpoint
```
https://mcp.serphouse.com/YOUR_SERPHouse_API_KEY/mcp
```
***
### Why SERPHouse MCP
| **21 MCP tools** | Live Google, Bing, and Yahoo SERP, Google verticals, and account lookups — all exposed with typed schemas |
| ------------------------- | -------------------------------------------------------------------------------------------------------------------------------- |
| **Zero glue code** | Your assistant picks the right tool; you describe what you need in plain language |
| **Hosted or self-hosted** | Use the managed endpoint at `https://mcp.serphouse.com/YOUR_SERPHouse_API_KEY/mcp`, or run the server on your own infrastructure |
| **Built-in context** | MCP resources (`serphouse_capabilities`, `serphouse_constraints`, `serphouse_examples`) teach the AI usage rules automatically |
***
### Prerequisites
Before configuring the SERPHouse MCP Server, ensure you have:
* A SERPHouse account
* An active SERPHouse API key
* An MCP-compatible AI client such as Claude Code, Claude CLI, or OpenCode
You can generate your API key from your [SERPHouse](https://www.serphouse.com/) Dashboard.
***
### Quick Start (Hosted)
The fastest path — no build step, no server to maintain.
**1.** Get your API key from the [SERPHouse Dashboard](https://www.serphouse.com/).
**2.** Add the server to your MCP client config:
```json
{
"mcpServers": {
"serphouse": {
"url": "https://mcp.serphouse.com/YOUR_SERPHouse_API_KEY/mcp"
}
}
}
```
Replace `YOUR_SERPHouse_API_KEY` with your SERPHouse API key.
**3.** Start chatting. Ask your assistant to search Google, Bing, or Yahoo, look up locations, fetch jobs, or check your account — it will route to the correct tool.
***
### What You Can Ask
For SEO teams, agencies, and SaaS marketers who need live search data inside their AI workflow — no dashboards, scripts, or context switching.
| Why you use it | Example prompt |
| ------------------------- | -------------------------------------------------------------------------- |
| **Track your rankings** | *"Where do we rank for 'crm software' on Google US desktop?"* |
| **Beat competitors** | *"Who owns the top 5 spots for 'project management software' in London?"* |
| **Own local search** | *"Top Google Local results for 'emergency plumber' in Chicago."* |
| **Discover keywords** | *"What does Autocomplete suggest for 'best saas for'?"* |
| **Monitor positions** | *"Run a mobile Bing SERP check for our brand in NYC and report our rank."* |
| **Multi-engine coverage** | *"Compare Yahoo and Google news results for 'electric vehicles'."* |
***
### Authentication
SERPHouse MCP authenticates using your API key as part of the MCP endpoint URL.
```json
{
"mcpServers": {
"serphouse": {
"url": "https://mcp.serphouse.com/YOUR_SERPHouse_API_KEY/mcp"
}
}
}
```
Replace `YOUR_SERPHouse_API_KEY` with your actual API key.
***
### Available Tools
SERPHouse MCP Server can provide access to:
| Tool | Description |
| ---------------- | --------------------- |
| Google Search | Search Google results |
| Google Maps | Local business search |
| Shopping | Product search |
| Images | Google Images |
| News | Google News |
| Autocomplete | Google Suggestions |
| Related Searches | Related keywords |
***
### Use cases & examples
#### Basic Search
```
Search Google for "Laravel 13 documentation".
```
***
#### SEO Research
```
Find the top 10 pages ranking for "technical SEO checklist".
```
***
#### Competitor Analysis
```
Search Google for "best rank tracker" and summarize the first page results.
```
***
#### Keyword Research
```
Search Google for "AI coding assistants" and list related searches.
```
***
#### Local Search
```
Search Google Maps for coffee shops in Berlin.
```
***
#### Shopping
```
Search Google Shopping for mechanical keyboards.
```
***
### Troubleshooting
#### Authentication Failed
Verify that your SERPHouse API key is valid and active, and that your MCP endpoint is in the format:
```
https://mcp.serphouse.com/YOUR_SERPHouse_API_KEY/mcp
```
***
#### Connection Failed
Ensure your MCP endpoint is:
```
https://mcp.serphouse.com/YOUR_SERPHouse_API_KEY/mcp
```
Also verify that your internet connection or firewall is not blocking outbound HTTPS requests.
***
#### MCP Server Not Detected
Restart your AI client after adding the MCP server.
You can also list the configured MCP servers to confirm that **serphouse** has been registered successfully.
***
#### Request Failed
If the AI assistant reports an API error:
* Verify that your API key has sufficient credits.
* Confirm that the requested tool is supported.
* Ensure your MCP client is using the latest configuration.
***
### Support
If you encounter any issues while configuring or using the SERPHouse MCP Server, we're here to help.
* Contact the SERPHouse support team for assistance.
* Report bugs or request features by opening an issue on the GitHub repository.
GitHub Repository