Skip to main content
Glama
Google Researcher MCP

Google Researcher MCP

google-researcher-mcp — DEPRECATED

⚠️ This project has been superseded by web-researcher-mcp.

A complete rewrite in Go: same tools, but it cites real sources and stays honest — citation verification, retraction flagging, eight search providers behind one interface, and a single signed static binary. No Node.js, no npm.


Migrate in one line

Your API keys and tool calls don't change — only how the server is launched. Pick whichever you prefer (no Node required):

# macOS / Linux — installs the binary and registers it with Claude Code automatically:
curl -fsSL https://raw.githubusercontent.com/zoharbabin/web-researcher-mcp/main/install.sh | sh

# Windows (PowerShell):
powershell -ExecutionPolicy Bypass -c "irm https://raw.githubusercontent.com/zoharbabin/web-researcher-mcp/main/install.ps1 | iex"

# Python users (uv) — run with no install:
uvx web-researcher-mcp

Before / after (MCP client config)

The config keeps the same shape — swap the command/args, keep your env:

// BEFORE — google-researcher-mcp (npx / Node)
{
  "mcpServers": {
    "google-researcher": {
      "command": "npx",
      "args": ["-y", "google-researcher-mcp"],
      "env": { "GOOGLE_CUSTOM_SEARCH_API_KEY": "…", "GOOGLE_CUSTOM_SEARCH_ID": "…" }
    }
  }
}

// AFTER — web-researcher-mcp (installed binary; or use "uvx" + args ["web-researcher-mcp"])
{
  "mcpServers": {
    "web-researcher": {
      "command": "web-researcher-mcp",
      "env": { "GOOGLE_CUSTOM_SEARCH_API_KEY": "…", "GOOGLE_CUSTOM_SEARCH_ID": "…" }
    }
  }
}

Don't run both at once — they register identical tool names. Remove the google-researcher entry before adding web-researcher.

→ Full migration guide

Your existing GOOGLE_CUSTOM_SEARCH_API_KEY and GOOGLE_CUSTOM_SEARCH_ID work unchanged.


Related MCP server: mcp-research

Why the Rewrite?

Open Issue

Resolution in web-researcher-mcp

#108 — Orphan detection fails via npx

Go binary has native process lifecycle (EOF/SIGPIPE) — no npm wrapper

#107 — Google discontinuing 'entire web' search

Eight providers (Brave, Serper, SearXNG, SearchAPI, Tavily, Exa, DuckDuckGo + Google PSE for lenses) with automatic fallback

#55 — Support alternative search engines

Multiple engines behind one interface, plus a zero-config DuckDuckGo default

#72 — Add Redis caching

Hybrid cache: memory + AES-encrypted disk + optional Redis

#40 — Split server.ts into modules

Fully modular Go architecture (one package per concern)

Plus what's new: verify_citation and audit_bibliography (catch fabricated/retracted citations), academic / patent / SEC-filing / US-case-law / economic / clinical-trial search, and authority-weighted search lenses.


Available Tools

8 tools
scrape_pageScrape Page (+ YouTube, PDF, DOCX, PPTX)A
Read-only

Extract text content from a URL. Automatically handles: web pages (static + JavaScript-rendered), YouTube videos (extracts transcript), and documents (PDF, DOCX, PPTX).

When to use:

  • You already have a specific URL to extract content from

  • Need content from YouTube videos, PDFs, or Office documents

  • Want to check page structure before fetching full content (preview mode)

When to use search_and_scrape instead:

  • Researching a topic across multiple sources

Content size control:

  • max_length: Limit response size (default: server max of 50KB)

  • mode: 'full' returns content, 'preview' returns metadata + structure only

Preview mode benefits:

  • Check content size before fetching full content

  • Get page structure (headings) to decide which sections to read

  • Avoid context exhaustion with very large pages

Caching: Results cached for 1 hour.

Inputs: url (required), max_length, mode. Returns: url, content, contentType, contentLength, +7 more

search_and_scrapeSearch and ScrapeA
Read-only

Search Google AND retrieve content from top results in one call. Returns combined, deduplicated content with source attribution.

When to use:

  • Primary tool for answering questions that need web research

  • Need content from multiple sources combined

  • More efficient than calling google_search + scrape_page separately

When to use other tools instead:

  • google_search: When you only need URLs without content

  • scrape_page: When you already have a specific URL

Content size control:

  • max_length_per_source: Limit content per source (default: 50KB)

  • total_max_length: Limit total combined content (default: 300KB)

  • filter_by_query: Only include paragraphs containing query keywords

Caching: Search results cached for 30 minutes, scraped pages for 1 hour.

Inputs: query (required), num_results, include_sources, deduplicate, +3 more. Returns: query, sources, combinedContent, summary, +1 more

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A4.6/5.0

    Scored across 8 tools

    Disambiguation5/5

    Each tool targets a distinct type of content or action: academic papers, images, news, general web, patents, page scraping, combined search+scrape, and progress tracking. Their purposes are clearly differentiated by name and description, leaving little ambiguity.

    Naming Consistency4/5

    Most tools follow a descriptive pattern (e.g., academic_search, google_news_search, patent_search), but there are minor inconsistencies: scrape_page and search_and_scrape break the 'type_search' pattern, and sequential_search uses an adjective. Overall, names are clear and mostly consistent.

    Tool Count5/5

    With 8 tools, the server is well-scoped for a research assistant. It covers essential search types and content extraction without being overwhelming. Each tool adds distinct value, and the count feels appropriate for the domain.

    Completeness5/5

    The tool set covers the major facets of web research: various search verticals (web, academic, news, images, patents), page scraping, combined search+scrape, and even a research progress tracker. There are no obvious gaps; it provides a comprehensive workflow.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • F
      license
      A
      quality
      Not graded
      maintenance
      Enables AI assistants to perform comprehensive research by searching Google, mining Reddit discussions, scraping web content with JS rendering, and synthesizing findings with citations into structured context.
      5
      165 npm
      3
      -
    • A
      license
      A
      quality
      D
      maintenance
      Enables AI assistants to perform comprehensive web research through tiered search, secure URL fetching with markdown conversion, and automated multi-source synthesis pipelines. Provides read-only tools with configurable caching, SSRF protection, and optional LLM-powered summarization for search results and content analysis.
      8
      1
      MIT
    • A
      license
      A
      quality
      B
      maintenance
      Web tools for AI agents. Search the web for full page content, fetch URLs as clean markdown including PDFs, extract structured data from a page with a prompt, and run multi-source deep research that returns a cited report.
      4
      2
      MIT
    • F
      license
      Not graded
      quality
      B
      maintenance
      Enables AI agents to perform deep web research by searching, fetching, chunking, retrieving, and synthesizing cited answers from exact source passages via a deep_research tool.
      -