gsearch MCP Server

by rayenmlayehio.github.RayenMlayeh/gsearchv0.1.0

Real Google Search for AI agents: real URLs, AI Overview and People also ask as typed JSON.

0Pythonstdioofficial registry

context tax

pending

security

pending

cold start

pending

freshness

pending

Our reading of gsearch, from the data

gsearch is a web search MCP server from rayenmlayeh, listed in the official MCP Registry.

We haven't measured its tool list yet, so its token cost is unknown.

With 0 GitHub stars it ranks #403 of 738 web search servers we index.

It runs locally on your machine over stdio and needs one secret (GSEARCH_PROXY); use a scoped, least-privilege key.

Install gsearch MCP server

claude mcp add gsearch-agent -e GSEARCH_PROXY='<gsearch-proxy>' -- uvx gsearch-agent

{
  "mcpServers": {
    "gsearch-agent": {
      "command": "uvx",
      "args": [
        "gsearch-agent"
      ],
      "env": {
        "GSEARCH_PROXY": "<gsearch-proxy>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project).

{
  "mcpServers": {
    "gsearch-agent": {
      "command": "uvx",
      "args": [
        "gsearch-agent"
      ],
      "env": {
        "GSEARCH_PROXY": "<gsearch-proxy>"
      }
    }
  }
}

Settings → Developer → Edit Config (claude_desktop_config.json), then restart.

{
  "servers": {
    "gsearch-agent": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "gsearch-agent"
      ],
      "env": {
        "GSEARCH_PROXY": "<gsearch-proxy>"
      }
    }
  }
}

Add to .vscode/mcp.json in your workspace.

{
  "mcpServers": {
    "gsearch-agent": {
      "command": "uvx",
      "args": [
        "gsearch-agent"
      ],
      "env": {
        "GSEARCH_PROXY": "<gsearch-proxy>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json.

Configuration

Variable	Required	Secret	Description
GSEARCH_PROXY	—	yes	Optional proxies in any format (host:port:user:pass, user:pass@host:port, socks5://...), or a file listing them. Unset: your own IP, at most 20 searches an hour.
GSEARCH_DATA_LIMIT_MB	—	—	Optional hard limit on proxy data, in MB, counted across restarts.

Freshness

Not enough public signals yet to judge maintenance.

Last commit (default branch)
2026-10-18 · today · GitHub
Latest release
2026-10-18 · today · GitHub · v0.1.0
Package published
no data · npm/PyPI
Registry entry updated
2026-10-18 · today · official registry · v0.1.0

How it compares in Web Search

Against the most-starred web search servers we index. Token cost is per model turn, measured from each server's live tool list.

Server	Stars	Tools	Tokens / turn	Freshness	Runs
gsearch (this)	0	—	not measured	—	local
Fetch	91,356	—	not measured	Active	local
Wigolo	5,486	—	not measured	Active	local
Exa	5,138	2	564	Active	local + hosted
Arxiv	3,224	—	not measured	Active	local
Devflowinc	2,720	—	not measured	Stale	—

All web search MCP servers

FAQ

›How do I install the gsearch MCP server in Claude Code?

Run: claude mcp add gsearch-agent -e GSEARCH_PROXY='<gsearch-proxy>' -- uvx gsearch-agent. For Cursor, VS Code, Claude Desktop and Windsurf, use the install tabs above.

›Does gsearch require an API key?

Yes. It expects GSEARCH_PROXY, of which 1 is a secret.

›Can I use gsearch as a remote (hosted) MCP server?

No hosted endpoint is published; it runs locally over stdio.

›Is gsearch in the official MCP registry?

Yes, as io.github.RayenMlayeh/gsearch.

Sources and method

Official MCP Registry entry: updated 2026-10-18
GitHub repository: fetched 2026-10-19
Package registry (npm / PyPI): listed
Last checked against all sources: 2026-10-19

The description, packages and links come from the maintainer's own published metadata. Token cost, security signals, freshness and the reading above are MCPSkillHub's own measurements; see the methodology. Spot an error? Request a correction or claim the listing.