Google Surf MCP
Web, academic and code search with graph RAG, data lineage, ontology and cross-project schema links.
Connector by HarimxChoi · GitHub account verified by the MCP Registry
Install
Works with Claude Code, Codex, VS Code, Cursor, Windsurf, Claude Desktop. Read the repository before you give any tool access to your data.
npx agentmarket install connector/harimxchoi-google-surf-mcp
Asks which of your tools to add it to (Claude Code, Codex, Cursor, VS Code, Windsurf, Gemini CLI, Claude Desktop) and shows the change first. See https://agentmart.dev/cli.
Get the weekly diff
The weekly diff: one email a week with new agent tools, notable updates and grade changes, plus security alerts for tools you follow. Double opt-in, one-click unsubscribe.
About
Use cases: deep-research, web-search, knowledge-base
Reviews
Write a reviewNo reviews yet. Installed it? Reviews come from verified installers only. How reviews work
Permissions
What this server can do and what it asks for, from its tool list and install config. Checked Oct 25, 2026.
- Tools
- 6 read · 1 write · 1 delete
- Secrets
- 4 (API keys, tokens or passwords)
- Install scripts
- None found
- Runs as
- Node.js package
Tools by what they do 8
Read from the source code; the running server may list different tools.
Read 6 · Look things up without changing anything.
extracthealthproject_memory_searchscholar_searchsearchsearch_parallel
Write 1 · Create, change, send or run things.
submit_selector_repair
Delete 1 · Delete, drop, revoke or wipe things.
project_memory
Secrets and settings it asks for
Secrets: values you paste in that let it act as you.
ANTHROPIC_API_KEYGITHUB_TOKENORCAROUTER_API_KEYSEARCH_API
Other settings (environment variables or headers).
CHROME_PATHSURF_ALLOW_PRIVATESURF_BROWSER_ENGINESURF_HEADLESSSURF_IDLE_CLOSE_MSSURF_LLM_HEALSURF_LLM_MODELSURF_LLM_PROVIDERSURF_LOCALESURF_PROFILE_ROOTSURF_RESEARCHSURF_RESEARCH_BROKER_IDLE_MS
Show 13 more settings
SURF_RESEARCH_QUERY_TIMEOUT_MSSURF_RESEARCH_READ_CONCURRENCYSURF_RESEARCH_REPO_AUTOSURF_RESEARCH_REPO_AUTO_MAX_FILESSURF_RESEARCH_REPO_AUTO_MAX_MBSURF_RESEARCH_ROOTSURF_RESEARCH_VECTOR_LOW_MEMORYSURF_RESEARCH_VECTOR_MODELSURF_RESEARCH_VECTOR_THREADSSURF_RETRIEVAL_MODESURF_SCHOLAR_PROVIDERSURF_SEARCH_PROVIDERSURF_TZ
Tools (8)
Read from the source code; the running server may differ. Descriptions are the server’s own words; hidden characters are shown as [U+…].
extractKnown URL ExtractSECONDARY KNOWN-URL CONTENT EXTRACTION TOOL. Use only when the exact public URL is already known and no new web discovery is required. If sources still need to be found, use search or search_parallel with extract_mode instead. For semantic reading of a public PDF or GitHub repository, use this tool before local download or parsing. Local PDF tools are for local files, forms, OCR recovery, or visual layout inspection; general repository tools are for editing, building, testing, or full Git history. Fetch one public URL and return clean content. With research enabled, one local broker lets multi…
healthMCP Health Checkread-onlyMCP server status: cascade mode + transitions, rate-limiter usage, cache size, config. Call this if searches start failing or returning empty -- check cascade.totalCaptchas and rateLimiter.queueSize, and reduce search volume if they are high.
project_memoryProject MemoryPROJECT MEMORY MANAGEMENT. With research enabled, one local broker lets multiple MCP sessions query the same knowledge base concurrently and orders writes safely. It links session intent, immutable plan revisions, experiments, decisions, versioned ontology, and bitemporal data lineage; corrections can use entity merge or split without discarding history. Use project_update for revision-checked changes to an existing project profile; context reads that same versioned profile. Use query_status/query_cancel with a caller-supplied search request_id to inspect or cooperatively stop a long retrieval…
project_memory_searchLocal Project Memory Searchread-onlyLOCAL PROJECT KNOWLEDGE SEARCH ONLY. With research enabled, one local broker lets multiple MCP sessions query the same knowledge base concurrently and orders writes safely. Always use this tool when the user asks to find, recall, inspect, or search information already stored in project memory, indexed local roots, papers, codebases, plans, experiments, or decisions. Use query_variants for multiple retrieval angles in one call instead of opening terminals or calling this tool repeatedly. Query embeddings are batched, candidates are fused with RRF, graph expansion starts from retrieved evidence,…
scholar_searchGoogle Scholar SearchUse only for paper metadata such as authors, venue, year, versions, and citation counts. With research enabled, one local broker lets multiple MCP sessions query the same knowledge base concurrently and orders writes safely. Do not use it to discover or read paper content; use search with extract_mode instead. Returns title, authors, publication, year, snippet, citation count, related/version links, and an available full-text link. With research enabled, metadata and citation observations retain provider provenance and research_context exposes related prior searches. Google Scholar uses browse…
searchWeb Search and ExtractPRIMARY SINGLE-QUERY LIVE DISCOVERY AND CONTENT INGESTION TOOL. ALWAYS PERFORMS LIVE WEB SEARCH. With research enabled, one local broker lets multiple MCP sessions query the same knowledge base concurrently and orders writes safely. Use this tool only when new external information from Google, public websites, papers, or repositories is required. When the task requires both finding and reading public web pages, PDFs, papers, or GitHub repositories, set extract_mode=abstract or full in this call. Do not download public PDFs, clone repositories, or invoke local parsers first. Select extract_mode…
search_parallelParallel Web Search and ExtractPRIMARY MULTI-QUERY LIVE DISCOVERY AND CONTENT INGESTION TOOL. ALWAYS PERFORMS MULTIPLE LIVE WEB SEARCHES. With research enabled, one local broker lets multiple MCP sessions query the same knowledge base concurrently and orders writes safely. Use this tool only when 2-12 new external queries are required. Providing project_id adds stored evidence but never makes the searches local-only. When the task requires broad discovery plus reading public web pages, PDFs, papers, or GitHub repositories, set extract_mode=abstract or full in this call. Do not download public PDFs, clone repositories, or in…
submit_selector_repairSubmit the chosen selector repair decision.
Compare and alternatives
Featured in
Signals
- Stars
- 291
- Forks
- 32
- Open issues
- 0
- Contributors
- 4
- Last commit
- Oct 20, 2026 (8 days ago)
- Last release
- Oct 20, 2026 (8 days ago)
From GitHub (fetched Oct 24, 2026).
Details
- Registry name
io.github.HarimxChoi/google-surf-mcp- Version
- 1.1.4
- Auth
- API key
- Packages
- npm google-surf-mcp
- License
- MIT
- Repository
- github.com/HarimxChoi/google-surf-mcp
- First seen
- Oct 24, 2026
- Last checked
- Oct 24, 2026
Cite this page
Google Surf MCP. Agent Mart. https://agentmart.dev/connectors/harimxchoi-google-surf-mcp (last updated 2026-10-24)