
How to add Web Search MCP Server to Cursor
Free web search via Google results scraping — no API keys required. Paste the config into ~/.cursor/mcp.json and restart Cursor.
Last updated June 14, 2026 · 452★ · stdio · no auth
Cursor config for Web Search MCP Server
npm install && npm run build{
"mcpServers": {
"web-search-mcp-server": {
"command": "node",
"args": [
"/path/to/web-search/build/index.js"
]
}
}
}Setup steps
- 1Open Cursor → Settings → MCP → Add new MCP server (or edit ~/.cursor/mcp.json directly).
- 2Paste the Web Search MCP Server 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 Web Search MCP Server's tools to confirm it's connected.
Before you start
- Node.js (to run the built server with `node`)
- Clone or download the repository, then run `npm install` and `npm run build`
What Web Search MCP Server can do in Cursor
searchPerforms a web search using Google search results. Accepts `query` (string, the search query) and optional `limit` (number, results to return — default 5, max 10). Returns an array of results, each with `title`, `url`, and `description`.
Security
Works by scraping Google search result HTML. Google may temporarily block requests if too many searches are performed in a short time; keep search frequency reasonable and consider adding delays. The parser depends on Google's HTML structure and may break if it changes. Intended for personal use only — respect Google's terms of service.
Web Search MCP Server + Cursor FAQ
Where is the Cursor config file?
Cursor reads MCP servers from ~/.cursor/mcp.json. Paste the Web Search MCP Server config there under the "mcpServers" key and restart the client.
Is Web Search MCP Server safe to use with Cursor?
Works by scraping Google search result HTML. Google may temporarily block requests if too many searches are performed in a short time; keep search frequency reasonable and consider adding delays. The parser depends on Google's HTML structure and may break if it changes. Intended for personal use only — respect Google's terms of service.
Do I need an API key?
No. The server uses free Google search results and requires no API keys or authentication.
How many results can I get per search?
Use the optional `limit` parameter. The default is 5 results and the maximum is 10.
Why might searches fail or return incomplete data?
It scrapes Google's HTML, so Google may rate-limit requests if too many run quickly, and changes to Google's HTML structure can cause missing descriptions or other parsing issues. Keep searches to a reasonable frequency.