AgentSidekick

google-surf-mcp

MCP serverby HarimxChoiSRC

Web, academic and code search with graph RAG, data lineage, ontology and cross-project schema links.

SRC Publisher-stated: these are the publisher's own words, not an assessment.

RepositorySource listing

Key facts

Type
MCP server · mcp-localSRC
Publisher
HarimxChoi · individualSRC
Licence
MITSRC
Open source
YesDER
Hosting
Local (runs on your machine)SRC
Latest version
1.1.8SRC
Languages
typescriptSRC
First published
SRC
In this catalogue since
DER
Last verified
Not verified by a researcher. Last seen in a source on 2026-11-21.

Capabilities and categories

Assigned by keyword rules from the description unless marked otherwise. The matched word is shown so you can judge the match.

CapabilityEvidenceKind
Browser Controlmatched playwrightDER
Document Processingmatched pdfDER
Knowledge Graphsmatched ontologyDER
Retrieval-Augmented Generationmatched ragDER
Web Searchmatched google searchDER
Data Catalogs & Lineagematched data lineageDER
Graph RAGmatched graph ragDER
Headless Browsingmatched playwrightDER
PDF Processingmatched pdfDER

Filed underData & KnowledgeWeb & BrowserBrowser Automation & Computer UseData Engineering & AnalyticsFiles & DocumentsRetrieval & RAGWeb DataData Warehouses

Integrations DER

No third-party service is named in the description or package metadata.

Platform compatibility

No pairing has been tested by AgentSidekick. Each status says what kind of evidence exists, not whether it works for you.

Protocol-level29

Each platform listed officially documents support for MCP. This specific pairing has not been tested.

Platform discontinued1
PlatformBasis
Roo CodeDiscontinuedRoo Code documented support for MCP but is discontinued. Project shut down and repository archived.
Unknown17
PlatformBasis
OpenClawCould not confirm whether OpenClaw supports MCP.
OpenHandsOpenHands documents MCP support, but it runs only on web, api, slack surfaces and this server runs locally as a process on your machine. Whether OpenHands can reach a local server is not established.
AiderCould not confirm whether Aider supports MCP.
Bolt (bolt.new)Bolt (bolt.new) documents MCP support, but it runs only on web surfaces and this server runs locally as a process on your machine. Whether Bolt (bolt.new) can reach a local server is not established.
Amazon Q DeveloperWinding downCould not confirm whether Amazon Q Developer supports MCP.
Amazon Bedrock Agents (Agents Classic)Maintenance onlyCould not confirm whether Amazon Bedrock Agents (Agents Classic) supports MCP.
GPTs (custom GPTs)Winding downCould not confirm whether GPTs (custom GPTs) supports MCP.
Gemini (app)Gemini (app) documents MCP support, but it runs only on web, mobile surfaces and this server runs locally as a process on your machine. Whether Gemini (app) can reach a local server is not established.
Gemini Enterprise Agent Platform (formerly Vertex AI / Vertex AI Agent Builder)Gemini Enterprise Agent Platform (formerly Vertex AI / Vertex AI Agent Builder) documents MCP support, but it runs only on web, api surfaces and this server runs locally as a process on your machine. Whether Gemini Enterprise Agent Platform (formerly Vertex AI / Vertex AI Agent Builder) can reach a local server is not established.
GitHub Copilot ExtensionsDiscontinuedCould not confirm whether GitHub Copilot Extensions supports MCP.
Google AI StudioCould not confirm whether Google AI Studio supports MCP.
JulesWinding downCould not confirm whether Jules supports MCP.
Microsoft CopilotCould not confirm whether Microsoft Copilot supports MCP.
Microsoft Copilot StudioMicrosoft Copilot Studio documents MCP support, but it runs only on web surfaces and this server runs locally as a process on your machine. Whether Microsoft Copilot Studio can reach a local server is not established.
Replit AgentReplit Agent documents MCP support, but it runs only on web surfaces and this server runs locally as a process on your machine. Whether Replit Agent can reach a local server is not established.
Sourcegraph CodyCould not confirm whether Sourcegraph Cody supports MCP.
v0v0 documents MCP support, but it runs only on web, api surfaces and this server runs locally as a process on your machine. Whether v0 can reach a local server is not established.

Install

Read from registry metadata. Follow the publisher's instructions; we have not run this.

Packages
RegistryPackageTransportRuntime
npmgoogle-surf-mcpstdionot stated

Environment variables SRC

NameRequiredSecretPublisher's description
SEARCH_APINoSecretSearchApi API key. Required only for SearchApi primary or fallback modes.
SURF_SEARCH_PROVIDERNoNoProvider for search and search_parallel: browser, searchapi, or fallback. Defaults to browser.
SURF_SCHOLAR_PROVIDERNoNoProvider for scholar_search: browser, searchapi, or fallback. Defaults to browser.
SURF_BROWSER_ENGINENoNoBrowser engine: auto, native, or playwright. Auto uses one hidden native Chrome broker shared across local MCP sessions.
CHROME_PATHNoNoAbsolute path to the Chrome binary. Auto-detected on Windows/macOS/Linux when omitted.
SURF_PROFILE_ROOTNoNoDirectory for the warm Chrome profile. Defaults to ~/.google-surf-mcp.
SURF_RESEARCHNoNoEnable Google Surf Auto Ontology: local project memory, evidence capture, and hybrid retrieval. Defaults to true. The SURF_RESEARCH setting name is unchanged.
SURF_RETRIEVAL_MODENoNoShared route for search and search_parallel: live or hybrid. Defaults to hybrid.
SURF_RESEARCH_ROOTNoNoEmbedded SurrealDB data directory. Defaults to <profile>/research.
SURF_RESEARCH_VECTOR_MODELNoNoLocal model for HNSW retrieval and shared reranking. Defaults to Xenova/multilingual-e5-small; use off to disable.
SURF_RESEARCH_VECTOR_LOW_MEMORYNoNoDisable ONNX CPU memory arena and memory pattern. Defaults to true.
SURF_RESEARCH_VECTOR_THREADSNoNoONNX intra-op thread count from 1 to 16. Defaults to 4.
SURF_RESEARCH_REPO_AUTONoNoSparse-index at most one eligible small GitHub repository per search call. Defaults to true.
SURF_RESEARCH_REPO_AUTO_MAX_MBNoNoMaximum searchable repository source-text size in MB. Assets are excluded. Defaults to 20.
SURF_RESEARCH_REPO_AUTO_MAX_FILESNoNoMaximum repository source file count for automatic indexing. Defaults to 2000.
SURF_RESEARCH_BROKER_IDLE_MSNoNoShared Auto Ontology broker idle lifetime in milliseconds. Defaults to 60000.
SURF_RESEARCH_READ_CONCURRENCYNoNoMaximum concurrent Auto Ontology broker reads. Defaults to 4.
SURF_RESEARCH_QUERY_TIMEOUT_MSNoNoTimeout per embedded SurrealDB query in milliseconds. Defaults to 120000; timed-out retrieval lanes are reported as partial.
GITHUB_TOKENNoSecretOptional token that raises GitHub API limits for repository inspection.
SURF_LOCALENoNoBrowser locale, e.g. en-US.
SURF_TZNoNoIANA timezone, e.g. America/New_York. Defaults to system timezone.
SURF_HEADLESSNoNoControls Playwright extraction, compatibility, and recovery paths. Native search hides normal system Chrome and shows it only for CAPTCHA recovery.
SURF_IDLE_CLOSE_MSNoNoIdle ms before closing the sequential ctx and pool. 0 disables idle auto-close. Defaults to 30000.
SURF_ALLOW_PRIVATENoNoSet 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_HEALNoNoEnable the optional workflow-only LLM selector repair path. Defaults to false.
SURF_LLM_PROVIDERNoNoLLM selector repair provider: anthropic or orcarouter. Defaults to anthropic.
SURF_LLM_MODELNoNoOptional model override. OrcaRouter defaults to orcarouter/auto.
ANTHROPIC_API_KEYNoSecretAnthropic API key for optional LLM-assisted selector repair.
ORCAROUTER_API_KEYNoSecretOrcaRouter API key for optional LLM-assisted selector repair.

Permissions and signals

Signals, not a safety verdict. They describe what the product's metadata references. Security review: not reviewed.

SignalEvidenceHow observedObserved
Runs a local processruns locally via npmregistry metadata 2026-11-21
Asks for a secretdeclares secret env var(s): SEARCH_API, GITHUB_TOKEN, ANTHROPIC_API_KEY, ORCAROUTER_API_KEYregistry metadata 2026-11-21

Known advisories for the published package SRC

An advisory existing does not mean the listed version is affected: compare the vulnerable range with the version you install. None found is not evidence of safety.

No advisories found

No published advisory matches a package this product declares. Products without a declared package cannot be matched at all. This is not evidence of safety.

Evaluation

Separate dimensions, each with its evidence. There is no overall score: the dimensions do not add up to one number honestly.

Source authority

Publisher-submitted

Published to the official MCP Registry by the namespace owner. Field values are the publisher's own claims.

Publisher verification

Namespace verified by registry

The MCP Registry verifies namespace ownership (GitHub login or DNS) before publishing. This confirms who published it, not what it does.

Maintenance activity

Active

Last push 2026-11-19 (2 days before this page was built).

Licence clarity

MIT

Licence identifier as reported by GitHub repository metadata.

Installation clarity

Machine-readable

1 package(s) and 0 remote endpoint(s) declared in registry metadata.

Documentation

Repository / website only

No dedicated documentation URL on record. AgentSidekick has not assessed documentation quality.

Compatibility evidence

Protocol-level only

Compatibility is inferred from the standard it implements. No pairing has been tested.

Security review

Not reviewed

AgentSidekick has not audited this product. 2 automated signal(s) are listed under Permissions & signals — they describe what it references, not whether it is safe.

Pricing

Not published in any source we track. The code is open source, which says nothing about the cost of any hosted service.

Repository activity

harimxchoi/google-surf-mcp. Read from the GitHub API on 2026-11-21.

303SRCGitHub stars
32SRCForks
0SRCOpen issues
2d agoSRCLast push2026-11-19
v1.1.8SRCLatest release2026-11-19

Version history SRC

  1. 1.1.8
  2. 1.1.6
  3. 1.1.5
  4. 1.1.4
  5. 1.1.3
  6. 1.1.2
  7. 1.1.1
  8. 1.0.10
21 earlier versions
  1. 1.0.9
  2. 1.0.8
  3. 1.0.7
  4. 1.0.6
  5. 1.0.5
  6. 1.0.4
  7. 1.0.3
  8. 1.0.2
  9. 1.0.1
  10. 1.0.0
  11. 0.9.9
  12. 0.9.8
  13. 0.9.6
  14. 0.9.5
  15. 0.7.0
  16. 0.4.6
  17. 0.4.0
  18. 0.3.2
  19. 0.3.1
  20. 0.2.0
  21. 0.1.1

Change history

What changed between two ingests of the same source, and when the product was first seen. Registry releases are under Version history.

  1. First seen

Competitors and alternativesDER

Paired by shared capabilities and integrations. Similar on paper; not tested side by side.

Direct

Same type, overlapping capabilities.

Puptra PDF Snapshot

MCP serverby saastemly.comSRC

push date unknownlicence unknown

SharesDocument ProcessingPDF ProcessingBrowser ControlHeadless Browsing

mcp

MCP serverby kitewrightSRC

24 GitHub starspushed 1mo agoMIT

SharesDocument ProcessingPDF ProcessingBrowser ControlHeadless Browsing

searxNcrawl

MCP serverby DasDigitaleMomentumSRC

193 GitHub starspushed 3d agoMIT

SharesRetrieval-Augmented GenerationBrowser ControlHeadless BrowsingWeb Search

Provenance

Which source set each field, what kind of claim it is, and when.

FieldSourceKindSet on
Canonical URLOfficial MCP RegistrySRC2026-11-21
PublisherOfficial MCP RegistrySRC2026-11-21
DescriptionOfficial MCP RegistrySRC2026-11-21
HostingOfficial MCP RegistrySRC2026-11-21
Integration typeOfficial MCP RegistrySRC2026-11-21
LanguagesGitHub repository metadataSRC2026-11-21
Latest versionOfficial MCP RegistrySRC2026-11-21
LicenceGitHub repository metadataSRC2026-11-21
NameOfficial MCP RegistrySRC2026-11-21
Open sourceGitHub repository metadataDER2026-11-21
TypeOfficial MCP RegistrySRC2026-11-21
PublishedOfficial MCP RegistrySRC2026-11-21
RepositoryOfficial MCP RegistrySRC2026-11-21
source_updated_atOfficial MCP RegistrySRC2026-11-21
Source URLOfficial MCP RegistrySRC2026-11-21

Sources

Not verified by a researcher. Last seen in a source on . Report incorrect information

Page data last updated .