> 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/agent-harnesses/cursor.md).

# Cursor

Cursor is an AI-powered code editor with support for Model Context Protocol (MCP) servers. By connecting the SERPHouse MCP Server, Cursor can access live search engine data directly from SERPHouse while you code.

Once configured, Cursor can automatically use SERPHouse tools to perform Google searches, retrieve SERP data, analyze search results, and assist with SEO and research tasks without manually calling the SERPHouse API.

***

### Prerequisites

Before configuring SERPHouse MCP Server, ensure you have:

* Cursor installed
* An active SERPHouse account
* A valid SERPHouse API key

***

### Configure the SERPHouse MCP Server

Open your configuration file  `~/.cursor/mcp.json` and add:

```json
{
  "mcpServers": {
    "serphouse": {
      "type": "http",
      "url": "https://mcp.serphouse.com/YOUR_SERPHouse_API_KEY/mcp"
    }
  }
}
```

Replace `YOUR_SERPHouse_API_KEY` with your actual SERPHouse API key.\
Save the configuration.\
Reload the Cursor window or start a new Cursor chat session.

***

### Verify Configuration

Start a new Cursor chat session and ask:

```
Search Google for "WordPress SEO Plugins".
```

If configured correctly, Cursor will automatically invoke the SERPHouse MCP Server.

***

### Using SERPHouse

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

Example prompts:

```
Search Google for "Laravel Horizon".
```

```
Show me the top 10 search results for "AI SEO tools".
```

```
Find related searches for "Laravel queue monitoring".
```

```
Search Google News for "OpenAI".
```

No additional commands are required during normal usage.

***

### Troubleshooting

**SERPHouse server doesn't appear** — Verify that the MCP server configuration has been saved successfully. If necessary, reload the Cursor window or start a new Cursor chat session.

**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** — Start a new Cursor chat session after updating your MCP configuration. Cursor loads MCP servers when a new session begins.

**Search requests return no results** — 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 server, add it again with your API key, restart Cursor, and verify your configuration against the latest documentation.