Google Surf MCP

What you can do with it

We have not written a plain-language summary for this one yet. Below are the facts we read from the registry.

• Connection: Runs on your computer
• Transport: stdio
• Category: Search & AI memory
• You need to fill in: SEARCH_API, GITHUB_TOKEN, ANTHROPIC_API_KEY, ORCAROUTER_API_KEY

Install

Pick the AI app you use, then copy the settings.

You need

• npmNode.js installed (for the npx command)

Which app do you use?

{
  "mcpServers": {
    "google-surf": {
      "command": "npx",
      "args": [
        "-y",
        "google-surf-mcp"
      ],
      "env": {
        "SEARCH_API": "your-value",
        "SURF_SEARCH_PROVIDER": "your-value",
        "SURF_SCHOLAR_PROVIDER": "your-value",
        "SURF_BROWSER_ENGINE": "your-value",
        "CHROME_PATH": "your-value",
        "SURF_PROFILE_ROOT": "your-value",
        "SURF_RESEARCH": "your-value",
        "SURF_RETRIEVAL_MODE": "your-value",
        "SURF_RESEARCH_ROOT": "your-value",
        "SURF_RESEARCH_VECTOR_MODEL": "your-value",
        "SURF_RESEARCH_VECTOR_LOW_MEMORY": "your-value",
        "SURF_RESEARCH_VECTOR_THREADS": "your-value",
        "SURF_RESEARCH_REPO_AUTO": "your-value",
        "SURF_RESEARCH_REPO_AUTO_MAX_MB": "your-value",
        "SURF_RESEARCH_REPO_AUTO_MAX_FILES": "your-value",
        "SURF_RESEARCH_BROKER_IDLE_MS": "your-value",
        "SURF_RESEARCH_READ_CONCURRENCY": "your-value",
        "SURF_RESEARCH_QUERY_TIMEOUT_MS": "your-value",
        "GITHUB_TOKEN": "your-value",
        "SURF_LOCALE": "your-value",
        "SURF_TZ": "your-value",
        "SURF_HEADLESS": "your-value",
        "SURF_IDLE_CLOSE_MS": "your-value",
        "SURF_ALLOW_PRIVATE": "your-value",
        "SURF_LLM_HEAL": "your-value",
        "SURF_LLM_PROVIDER": "your-value",
        "SURF_LLM_MODEL": "your-value",
        "ANTHROPIC_API_KEY": "your-value",
        "ORCAROUTER_API_KEY": "your-value"
      }
    }
  }
}

claude mcp add google-surf --env SEARCH_API=your-value --env SURF_SEARCH_PROVIDER=your-value --env SURF_SCHOLAR_PROVIDER=your-value --env SURF_BROWSER_ENGINE=your-value --env CHROME_PATH=your-value --env SURF_PROFILE_ROOT=your-value --env SURF_RESEARCH=your-value --env SURF_RETRIEVAL_MODE=your-value --env SURF_RESEARCH_ROOT=your-value --env SURF_RESEARCH_VECTOR_MODEL=your-value --env SURF_RESEARCH_VECTOR_LOW_MEMORY=your-value --env SURF_RESEARCH_VECTOR_THREADS=your-value --env SURF_RESEARCH_REPO_AUTO=your-value --env SURF_RESEARCH_REPO_AUTO_MAX_MB=your-value --env SURF_RESEARCH_REPO_AUTO_MAX_FILES=your-value --env SURF_RESEARCH_BROKER_IDLE_MS=your-value --env SURF_RESEARCH_READ_CONCURRENCY=your-value --env SURF_RESEARCH_QUERY_TIMEOUT_MS=your-value --env GITHUB_TOKEN=your-value --env SURF_LOCALE=your-value --env SURF_TZ=your-value --env SURF_HEADLESS=your-value --env SURF_IDLE_CLOSE_MS=your-value --env SURF_ALLOW_PRIVATE=your-value --env SURF_LLM_HEAL=your-value --env SURF_LLM_PROVIDER=your-value --env SURF_LLM_MODEL=your-value --env ANTHROPIC_API_KEY=your-value --env ORCAROUTER_API_KEY=your-value -- npx -y google-surf-mcp

{
  "mcpServers": {
    "google-surf": {
      "command": "npx",
      "args": [
        "-y",
        "google-surf-mcp"
      ],
      "env": {
        "SEARCH_API": "your-value",
        "SURF_SEARCH_PROVIDER": "your-value",
        "SURF_SCHOLAR_PROVIDER": "your-value",
        "SURF_BROWSER_ENGINE": "your-value",
        "CHROME_PATH": "your-value",
        "SURF_PROFILE_ROOT": "your-value",
        "SURF_RESEARCH": "your-value",
        "SURF_RETRIEVAL_MODE": "your-value",
        "SURF_RESEARCH_ROOT": "your-value",
        "SURF_RESEARCH_VECTOR_MODEL": "your-value",
        "SURF_RESEARCH_VECTOR_LOW_MEMORY": "your-value",
        "SURF_RESEARCH_VECTOR_THREADS": "your-value",
        "SURF_RESEARCH_REPO_AUTO": "your-value",
        "SURF_RESEARCH_REPO_AUTO_MAX_MB": "your-value",
        "SURF_RESEARCH_REPO_AUTO_MAX_FILES": "your-value",
        "SURF_RESEARCH_BROKER_IDLE_MS": "your-value",
        "SURF_RESEARCH_READ_CONCURRENCY": "your-value",
        "SURF_RESEARCH_QUERY_TIMEOUT_MS": "your-value",
        "GITHUB_TOKEN": "your-value",
        "SURF_LOCALE": "your-value",
        "SURF_TZ": "your-value",
        "SURF_HEADLESS": "your-value",
        "SURF_IDLE_CLOSE_MS": "your-value",
        "SURF_ALLOW_PRIVATE": "your-value",
        "SURF_LLM_HEAL": "your-value",
        "SURF_LLM_PROVIDER": "your-value",
        "SURF_LLM_MODEL": "your-value",
        "ANTHROPIC_API_KEY": "your-value",
        "ORCAROUTER_API_KEY": "your-value"
      }
    }
  }
}

{
  "servers": {
    "google-surf": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "google-surf-mcp"
      ],
      "env": {
        "SEARCH_API": "your-value",
        "SURF_SEARCH_PROVIDER": "your-value",
        "SURF_SCHOLAR_PROVIDER": "your-value",
        "SURF_BROWSER_ENGINE": "your-value",
        "CHROME_PATH": "your-value",
        "SURF_PROFILE_ROOT": "your-value",
        "SURF_RESEARCH": "your-value",
        "SURF_RETRIEVAL_MODE": "your-value",
        "SURF_RESEARCH_ROOT": "your-value",
        "SURF_RESEARCH_VECTOR_MODEL": "your-value",
        "SURF_RESEARCH_VECTOR_LOW_MEMORY": "your-value",
        "SURF_RESEARCH_VECTOR_THREADS": "your-value",
        "SURF_RESEARCH_REPO_AUTO": "your-value",
        "SURF_RESEARCH_REPO_AUTO_MAX_MB": "your-value",
        "SURF_RESEARCH_REPO_AUTO_MAX_FILES": "your-value",
        "SURF_RESEARCH_BROKER_IDLE_MS": "your-value",
        "SURF_RESEARCH_READ_CONCURRENCY": "your-value",
        "SURF_RESEARCH_QUERY_TIMEOUT_MS": "your-value",
        "GITHUB_TOKEN": "your-value",
        "SURF_LOCALE": "your-value",
        "SURF_TZ": "your-value",
        "SURF_HEADLESS": "your-value",
        "SURF_IDLE_CLOSE_MS": "your-value",
        "SURF_ALLOW_PRIVATE": "your-value",
        "SURF_LLM_HEAL": "your-value",
        "SURF_LLM_PROVIDER": "your-value",
        "SURF_LLM_MODEL": "your-value",
        "ANTHROPIC_API_KEY": "your-value",
        "ORCAROUTER_API_KEY": "your-value"
      }
    }
  }
}

Your choice stays on this device in a cookie; no account needed.

Values you fill in

• SEARCH_API secret env
  SearchApi API key. Required only for SearchApi primary or fallback modes.
• SURF_SEARCH_PROVIDER env
  Provider for search and search_parallel: browser, searchapi, or fallback. Defaults to browser.
• SURF_SCHOLAR_PROVIDER env
  Provider for scholar_search: browser, searchapi, or fallback. Defaults to browser.
• SURF_BROWSER_ENGINE env
  Browser engine: auto, native, or playwright. Auto uses one hidden native Chrome broker shared across local MCP sessions.
• CHROME_PATH env
  Absolute path to the Chrome binary. Auto-detected on Windows/macOS/Linux when omitted.
• SURF_PROFILE_ROOT env
  Directory for the warm Chrome profile. Defaults to ~/.google-surf-mcp.
• SURF_RESEARCH env
  Enable Google Surf Auto Ontology: local project memory, evidence capture, and hybrid retrieval. Defaults to true. The SURF_RESEARCH setting name is unchanged.
• SURF_RETRIEVAL_MODE env
  Shared route for search and search_parallel: live or hybrid. Defaults to hybrid.
• SURF_RESEARCH_ROOT env
  Embedded SurrealDB data directory. Defaults to /research.
• SURF_RESEARCH_VECTOR_MODEL env
  Local model for HNSW retrieval and shared reranking. Defaults to Xenova/multilingual-e5-small; use off to disable.
• SURF_RESEARCH_VECTOR_LOW_MEMORY env
  Disable ONNX CPU memory arena and memory pattern. Defaults to true.
• SURF_RESEARCH_VECTOR_THREADS env
  ONNX intra-op thread count from 1 to 16. Defaults to 4.
• SURF_RESEARCH_REPO_AUTO env
  Sparse-index at most one eligible small GitHub repository per search call. Defaults to true.
• SURF_RESEARCH_REPO_AUTO_MAX_MB env
  Maximum searchable repository source-text size in MB. Assets are excluded. Defaults to 20.
• SURF_RESEARCH_REPO_AUTO_MAX_FILES env
  Maximum repository source file count for automatic indexing. Defaults to 2000.
• SURF_RESEARCH_BROKER_IDLE_MS env
  Shared Auto Ontology broker idle lifetime in milliseconds. Defaults to 60000.
• SURF_RESEARCH_READ_CONCURRENCY env
  Maximum concurrent Auto Ontology broker reads. Defaults to 4.
• SURF_RESEARCH_QUERY_TIMEOUT_MS env
  Timeout per embedded SurrealDB query in milliseconds. Defaults to 120000; timed-out retrieval lanes are reported as partial.
• GITHUB_TOKEN secret env
  Optional token that raises GitHub API limits for repository inspection.
• SURF_LOCALE env
  Browser locale, e.g. en-US.
• SURF_TZ env
  IANA timezone, e.g. America/New_York. Defaults to system timezone.
• SURF_HEADLESS env
  Controls Playwright extraction, compatibility, and recovery paths. Native search hides normal system Chrome and shows it only for CAPTCHA recovery.
• SURF_IDLE_CLOSE_MS env
  Idle ms before closing the sequential ctx and pool. 0 disables idle auto-close. Defaults to 30000.
• SURF_ALLOW_PRIVATE env
  Set to 'true' to allow extract on private/loopback addresses (localhost, 10.x, 192.168.x, 169.254.x, etc). Default blocks them as an SSRF guard.
• SURF_LLM_HEAL env
  Enable the optional workflow-only LLM selector repair path. Defaults to false.
• SURF_LLM_PROVIDER env
  LLM selector repair provider: anthropic or orcarouter. Defaults to anthropic.
• SURF_LLM_MODEL env
  Optional model override. OrcaRouter defaults to orcarouter/auto.
• ANTHROPIC_API_KEY secret env
  Anthropic API key for optional LLM-assisted selector repair.
• ORCAROUTER_API_KEY secret env
  OrcaRouter API key for optional LLM-assisted selector repair.

These settings are generated from the maker’s registry entry. If the README says otherwise, follow the README.

What it can do

Runs on your computer; the tool list appears in your AI app after you install it.

Basic checksi

We check information anyone can see; we have not read the code. Checks that do not apply are left out of the count. · Checked Nov 9, 2026

• ✓ Pass

  Maker matches the repo

  The registry name was verified with the GitHub account HarimxChoi, which owns the repo

• … Not checked yet

  Still maintained

  We have not read this repo from GitHub yet

• … Not checked yet

  Has a licence

  We have not read this repo from GitHub yet

• – Not applicable

  Endpoint responds

  This one runs on your computer; there is no internet endpoint

• – Not applicable

  Sign-in with OAuth

  Runs on your computer and uses local settings instead

• … Not checked yet

  No hidden instructions in tool descriptions

  Runs on your computer; we can only read tool lists from internet endpoints

Compared with others in Search & AI memoryi

• More stars than 0% of the other 5727 servers in this category
• Published to the registry more recently than 95% of the other 5727 servers in this category
• Basic checks equal to or better than 100% of the other 5727 servers in this category

Compared with every active server in this category in the registry. Stars count only when the publisher owns the repo.

Alternatives

Servers in the same category from other makers, sorted by stars.

Reading a card:↓ Downloads per weeki★ GitHub starsiThree pillars: reviews · checks · usageiUpdated = latest version published to the registryi

README from the maker

{

Web + papers + code + project records

project_memory(action="export", project_id="my-project", export_format="html", export_view="graph")