How to add WebSearch MCP to Cursor

Real-time web search for MCP clients via a self-hosted crawler API over stdio. Paste the config into ~/.cursor/mcp.json and restart Cursor.

Last updated June 14, 2026 · 37★ · stdio · no auth

Cursor config for WebSearch MCP

npm install -g websearch-mcp

{
  "mcpServers": {
    "websearch-mcp": {
      "command": "npx",
      "args": [
        "websearch-mcp"
      ],
      "env": {
        "API_URL": "http://localhost:3001",
        "MAX_SEARCH_RESULT": "5"
      }
    }
  }
}

Setup steps

1Open Cursor → Settings → MCP → Add new MCP server (or edit ~/.cursor/mcp.json directly).
2Paste the WebSearch MCP config below into the "mcpServers" object.
3Fill in placeholder secrets, then save.
4Cursor reloads MCP servers automatically — check Settings → MCP for a green status dot.
5Ask Cursor to use one of WebSearch MCP's tools to confirm it's connected.

Before you start

Node.js with npx (to run the websearch-mcp package)
A running WebSearch Crawler API backend (Docker image laituanmanh/websearch-crawler) reachable at API_URL
FlareSolverr service (for bypassing Cloudflare protection), started via the provided docker-compose.yml
Docker and Docker Compose to run the crawler service

What WebSearch MCP can do in Cursor

web_search

Search the web in real time. Parameters: query (required); numResults (optional, default 5); language (optional, e.g. 'en'); region (optional, e.g. 'us'); excludeDomains (optional); includeDomains (optional); excludeTerms (optional); resultType (optional: 'all', 'news', or 'blogs'). Returns results with title, snippet, url, siteName, and byline.

Security

Requires a self-hosted WebSearch Crawler API backend (Docker image laituanmanh/websearch-crawler plus FlareSolverr) reachable at API_URL; no built-in authentication between the MCP server and the crawler. The MCP server itself takes no API key. Also installable via Smithery.

WebSearch MCP + Cursor FAQ

Where is the Cursor config file?

Cursor reads MCP servers from ~/.cursor/mcp.json. Paste the WebSearch MCP config there under the "mcpServers" key and restart the client.

Is WebSearch MCP safe to use with Cursor?

Does this need an API key?

No. The MCP server itself takes no API key; it talks to your self-hosted crawler service at API_URL. You are responsible for running and securing that crawler backend.

What backend does it require?

A WebSearch Crawler API service, provided as the Docker image laituanmanh/websearch-crawler, alongside a FlareSolverr container. The README includes a docker-compose.yml (with an Apple Silicon workaround) to start both.

How do I install it?

Run it with `npx websearch-mcp`, install globally with `npm install -g websearch-mcp`, or install for Claude Desktop automatically via Smithery (`npx -y @smithery/cli install @mnhlt/WebSearch-MCP --client claude`).

View repo Full WebSearch MCP page