Google Researcher MCP
Google Researcher MCP Server
Professional research tools for AI assistants - Google Search, web scraping, academic papers, patents, and more
Features
Tool | Description |
| Web search with site, date, and language filters |
| News search with freshness controls |
| Image search with type, size, color filters |
| Extract content from web pages, PDFs, DOCX |
| Combined search + content extraction |
| Papers from arXiv, PubMed, IEEE, Springer |
| Patent search with assignee/inventor filters |
YouTube | Automatic transcript extraction |
| Multi-step research tracking |
Related MCP server: mcp-research
Use Cases
Research Assistants: Enable Claude to search the web and synthesize information
Content Creation: Gather sources, citations, and supporting evidence
Academic Research: Find papers, extract citations, track research progress
Competitive Intelligence: Patent searches, company research, market analysis
News Monitoring: Track breaking news, industry updates, specific sources
Technical Documentation: Extract content from docs, tutorials, and references
Comparison with Alternatives
Feature | Google Researcher | Basic Web Search | Manual Research |
Web Search | Yes | Yes | No |
News Search | Yes | No | No |
Image Search | Yes | No | No |
Academic Papers | Yes | No | Yes |
Patent Search | Yes | No | Yes |
YouTube Transcripts | Yes | No | No |
PDF Extraction | Yes | No | No |
Citation Generation | Yes | No | Yes |
Response Caching | Yes (30min) | No | N/A |
Rate Limiting | Yes | No | N/A |
This is a Model Context Protocol (MCP) server that enables AI assistants like Claude, GPT, and other LLMs to:
Search the web via Google (general, images, news)
Read any webpage including JavaScript-rendered sites
Extract YouTube transcripts automatically
Parse documents (PDF, DOCX, PPTX)
Built for production use with caching, quality scoring, and enterprise security.
Quick Start
Claude Desktop (macOS)
Add to ~/Library/Application Support/Claude/claude_desktop_config.json:
{
"mcpServers": {
"google-researcher": {
"command": "npx",
"args": ["-y", "google-researcher-mcp"],
"env": {
"GOOGLE_CUSTOM_SEARCH_API_KEY": "YOUR_API_KEY_HERE",
"GOOGLE_CUSTOM_SEARCH_ID": "YOUR_SEARCH_ID_HERE"
}
}
}
}Claude Desktop (Windows)
Add to %APPDATA%\Claude\claude_desktop_config.json:
{
"mcpServers": {
"google-researcher": {
"command": "npx",
"args": ["-y", "google-researcher-mcp"],
"env": {
"GOOGLE_CUSTOM_SEARCH_API_KEY": "YOUR_API_KEY_HERE",
"GOOGLE_CUSTOM_SEARCH_ID": "YOUR_SEARCH_ID_HERE"
}
}
}
}One-Click Install (MCPB)
Download the latest .mcpb bundle from GitHub Releases and double-click to install in Claude Desktop. You'll be prompted to enter your Google API credentials.
Claude Code
Add to ~/.claude.json:
{
"mcpServers": {
"google-researcher": {
"command": "npx",
"args": ["-y", "google-researcher-mcp"],
"env": {
"GOOGLE_CUSTOM_SEARCH_API_KEY": "YOUR_API_KEY_HERE",
"GOOGLE_CUSTOM_SEARCH_ID": "YOUR_SEARCH_ID_HERE"
}
}
}
}Cursor
Add to Cursor's MCP settings (Settings > MCP):
{
"mcpServers": {
"google-researcher": {
"command": "npx",
"args": ["-y", "google-researcher-mcp"],
"env": {
"GOOGLE_CUSTOM_SEARCH_API_KEY": "YOUR_API_KEY_HERE",
"GOOGLE_CUSTOM_SEARCH_ID": "YOUR_SEARCH_ID_HERE"
}
}
}
}Windsurf / Cline / Roo Code / Other MCP Clients
Use the same JSON configuration above in your MCP client's settings. Any MCP-compatible client that supports STDIO transport will work.
Need API keys? See the API Setup Guide for step-by-step instructions to get your Google API credentials.
Local Development
git clone https://github.com/zoharbabin/google-researcher-mcp.git && cd google-researcher-mcp
npm install # Installs deps + Chromium browser automatically
cp .env.example .env # Then add your Google API keys to .env
npm run dev # Server is now running on STDIO transportNote: This starts the server in STDIO mode, which is all you need for local AI assistant integrations. HTTP transport with OAuth is only required for web-based or multi-client setups — see Choosing a Transport.
Verify It Works
Once configured, ask your AI assistant:
"Search for the latest news about AI regulations"
The assistant will use the google_news_search tool and return current articles. If you see search results, the server is working correctly.
For AI Assistants (LLMs)
If you are an AI assistant reading this, here's how to use this MCP server:
Recommended Tool Selection
Your Task | Use This Tool |
Research a topic, answer a question |
|
Complex multi-step investigation |
|
Find academic papers |
|
Search patents |
|
Find recent news |
|
Find images |
|
Get a list of URLs only |
|
Read a specific URL |
|
Example Tool Calls
// Research a topic (RECOMMENDED for most queries)
{ "name": "search_and_scrape", "arguments": { "query": "climate change effects 2024", "num_results": 5 } }
// Multi-step research with tracking (for complex investigations)
{ "name": "sequential_search", "arguments": { "searchStep": "Starting research on quantum computing", "stepNumber": 1, "totalStepsEstimate": 4, "nextStepNeeded": true } }
// Find academic papers (peer-reviewed sources with citations)
{ "name": "academic_search", "arguments": { "query": "transformer neural networks", "num_results": 5 } }
// Search patents (prior art, FTO analysis)
{ "name": "patent_search", "arguments": { "query": "machine learning optimization", "search_type": "prior_art" } }
// Get recent news
{ "name": "google_news_search", "arguments": { "query": "AI regulations", "freshness": "week" } }
// Find images
{ "name": "google_image_search", "arguments": { "query": "solar panel installation", "type": "photo" } }
// Read a specific page
{ "name": "scrape_page", "arguments": { "url": "https://example.com/article" } }
// Get YouTube transcript
{ "name": "scrape_page", "arguments": { "url": "https://www.youtube.com/watch?v=VIDEO_ID" } }Key Behaviors
Caching: Results are cached (30 min for search, 1 hour for scrape). Repeated queries are fast.
Quality Scoring:
search_and_scraperanks sources by relevance, freshness, authority, and content quality.Graceful Failures: If some sources fail, you still get results from successful ones.
Document Support:
scrape_pageauto-detects PDFs, DOCX, PPTX and extracts text.
Table of Contents
Available Tools
When to Use Each Tool
Tool | Best For | Use When... |
| Research (recommended) | You need to answer a question using web sources. Most efficient — searches AND retrieves content in one call. Sources are quality-scored. |
| Complex investigations | 3+ searches needed with different angles, or research you might abandon early. Tracks progress, supports branching. You reason; it tracks state. |
| Peer-reviewed papers | Research requiring authoritative academic sources. Returns papers with citations (APA, MLA, BibTeX), abstracts, and PDF links. |
| Patent research | Prior art search, freedom to operate (FTO) analysis, patent landscaping. Returns patents with numbers, assignees, inventors, and PDF links. |
| Finding URLs only | You only need a list of URLs (not their content), or want to process pages yourself with custom logic. |
| Finding images | You need visual content — photos, illustrations, graphics. For text research, use search_and_scrape. |
| Current news | You need recent news articles. Use scrape_page on results to read full articles. |
| Reading a specific URL | You have a URL and need its content. Auto-handles YouTube transcripts and documents (PDF, DOCX, PPTX). |
Tool Reference
search_and_scrape (Recommended for research)
Searches Google and retrieves content from top results in one call. Returns quality-scored, deduplicated text with source attribution. Includes size metadata (estimatedTokens, sizeCategory, truncated) in response.
Parameter | Type | Default | Description |
| string | required | Search query (1-500 chars) |
| number | 3 | Number of results (1-10) |
| boolean | true | Append source URLs |
| boolean | true | Remove duplicate content |
| number | 50KB | Max content per source in chars |
| number | 300KB | Max total combined content in chars |
| boolean | false | Filter to only paragraphs containing query keywords |
google_search
Returns ranked URLs from Google. Use when you only need links, not content.
Parameter | Type | Default | Description |
| string | required | Search query (1-500 chars) |
| number | 5 | Number of results (1-10) |
| string | - |
|
| string | - | Limit to domain |
| string | - | Required phrase |
| string | - | Exclude words |
google_image_search
Searches Google Images with filtering options.
Parameter | Type | Default | Description |
| string | required | Search query (1-500 chars) |
| number | 5 | Number of results (1-10) |
| string | - |
|
| string | - |
|
| string | - |
|
| string | - |
|
google_news_search
Searches Google News with freshness and date sorting.
Parameter | Type | Default | Description |
| string | required | Search query (1-500 chars) |
| number | 5 | Number of results (1-10) |
| string | week |
|
| string | relevance |
|
| string | - | Filter to specific source |
scrape_page
Extracts text from any URL. Prefers markdown via content negotiation (Accept: text/markdown) for sites that support it (Cloudflare Markdown for Agents, llms.txt). Falls back to HTML extraction (static/JS), YouTube (transcript), documents (PDF/DOCX/PPTX).
Parameter | Type | Default | Description |
| string | required | URL to scrape (max 2048 chars) |
| number | 50KB | Maximum content length in chars. Content exceeding this is truncated at natural breakpoints. |
| string | full |
|
sequential_search
Tracks multi-step research state. Following the sequential_thinking pattern: you do the reasoning, the tool tracks state.
Parameter | Type | Default | Description |
| string | required | Description of current step (1-2000 chars) |
| number | required | Current step number (starts at 1) |
| number | 5 | Estimated total steps (1-50) |
| boolean | required |
|
| object | - | Source found: |
| string | - | Gap identified — what's still missing |
| boolean | - |
|
| number | - | Step number being revised |
| string | - | Identifier for branching research |
academic_search
Searches academic papers via Google Custom Search API, filtered to academic sources (arXiv, PubMed, IEEE, Nature, Springer, etc.). Returns papers with pre-formatted citations.
Parameter | Type | Default | Description |
| string | required | Search query (1-500 chars) |
| number | 5 | Number of papers (1-10) |
| number | - | Filter by min publication year |
| number | - | Filter by max publication year |
| string | all |
|
| boolean | false | Only return results with PDF links |
| string | relevance |
|
patent_search
Searches Google Patents for prior art, freedom to operate (FTO) analysis, and patent landscaping. Returns patents with numbers, assignees, inventors, and PDF links.
Parameter | Type | Default | Description |
| string | required | Search query (1-500 chars) |
| number | 5 | Number of results (1-10) |
| string | prior_art |
|
| string | all |
|
| string | - | Filter by assignee/company |
| string | - | Filter by inventor name |
| string | - | Filter by CPC classification code |
| number | - | Filter by min year |
| number | - | Filter by max year |
Features
Core Capabilities
Feature | Description |
Web Scraping | Fast static HTML + automatic Playwright fallback for JavaScript-rendered pages |
YouTube Transcripts | Robust extraction with retry logic and 10 classified error types |
Document Parsing | Auto-detects and extracts text from PDF, DOCX, PPTX |
Quality Scoring | Sources ranked by relevance (35%), freshness (20%), authority (25%), content quality (20%) |
MCP Protocol Support
Feature | Description |
Tools | 8 tools: |
Resources | Expose server state: |
Prompts | Pre-built templates: |
Annotations | Content tagged with audience, priority, and timestamps |
Production Ready
Feature | Description |
Caching | Two-layer (memory + disk) with per-tool namespaces, reduces API costs |
Dual Transport | STDIO for local clients, HTTP+SSE for web apps |
Security | OAuth 2.1, SSRF protection, granular scopes |
Resilience | Circuit breaker, timeouts, graceful degradation |
Monitoring | Admin endpoints for cache stats, event store, health checks |
For detailed documentation: YouTube Transcripts · Architecture · Testing
System Architecture
graph TD
A[MCP Client] -->|local process| B[STDIO Transport]
A -->|network| C[HTTP+SSE Transport]
C --> L[OAuth 2.1 + Rate Limiter]
L --> D
C -.->|session replay| K[Event Store]
B --> D[McpServer<br>MCP SDK routing + dispatch]
D --> F[google_search]
D --> G[scrape_page]
D --> I[search_and_scrape]
D --> IMG[google_image_search]
D --> NEWS[google_news_search]
I -.->|delegates| F
I -.->|delegates| G
I --> Q[Quality Scoring]
G --> N[SSRF Validator]
N --> S1[CheerioCrawler<br>static HTML]
S1 -.->|insufficient content| S2[Playwright<br>JS rendering]
G --> YT[YouTube Transcript<br>Extractor]
F & G & IMG & NEWS --> J[Persistent Cache<br>memory + disk]
D -.-> R[MCP Resources]
D -.-> P[MCP Prompts]
style J fill:#f9f,stroke:#333,stroke-width:2px
style K fill:#ccf,stroke:#333,stroke-width:2px
style L fill:#f99,stroke:#333,stroke-width:2px
style N fill:#ff9,stroke:#333,stroke-width:2px
style Q fill:#9f9,stroke:#333,stroke-width:2pxFor a detailed explanation, see the Architecture Guide.
Getting Started
Prerequisites
Node.js 20.0.0 or higher
Google API Keys:
Chromium (for JavaScript rendering): Installed automatically during
npm installvia postinstall hookOAuth 2.1 Provider (HTTP transport only): An external authorization server (e.g., Auth0, Okta) to issue JWTs. Not needed for STDIO.
Installation & Setup
Clone the Repository:
git clone https://github.com/zoharbabin/google-researcher-mcp.git cd google-researcher-mcpInstall Dependencies (includes Chromium browser automatically):
npm installConfigure Environment Variables:
cp .env.example .envOpen
.envand add your Google API keys. All other variables are optional — see the comments in.env.examplefor detailed explanations.
Running the Server
Development (auto-reload on file changes):
npm run devProduction:
npm run build npm start
Running with Docker
# Build the image
docker build -t google-researcher-mcp .
# Run in STDIO mode (default, for MCP clients)
docker run -i --rm --env-file .env google-researcher-mcp
# Run with HTTP transport on port 3000
# (MCP_TEST_MODE= overrides the Dockerfile default of "stdio" to enable HTTP)
docker run -d --rm --env-file .env -e MCP_TEST_MODE= -p 3000:3000 google-researcher-mcpDocker Compose (quick HTTP transport setup):
cp .env.example .env # Fill in your API keys
docker compose up --build
curl http://localhost:3000/healthDocker with Claude Code (~/.claude/claude_desktop_config.json):
{
"mcpServers": {
"google-researcher": {
"command": "docker",
"args": ["run", "-i", "--rm", "--env-file", "/path/to/.env", "google-researcher-mcp"]
}
}
}Security note: Never bake secrets into the Docker image. Always pass them at runtime via --env-file or -e flags.
Usage
Choosing a Transport
STDIO | HTTP+SSE | |
Best for | Local MCP clients (Claude Code, Cline, Roo Code) | Web apps, multi-client setups, remote access |
Auth | None needed (process-level isolation) | OAuth 2.1 Bearer tokens required |
Setup | Zero config — just provide API keys | Requires OAuth provider (Auth0, Okta, etc.) |
Scaling | One server per client process | Single server, many concurrent clients |
Recommendation: Use STDIO for local AI assistant integrations. Use HTTP+SSE only when you need a shared service or web application integration.
Client Integration
STDIO Client (Local Process)
import { Client } from "@modelcontextprotocol/sdk/client/index.js";
import { StdioClientTransport } from "@modelcontextprotocol/sdk/client/stdio.js";
const transport = new StdioClientTransport({
command: "node",
args: ["dist/server.js"]
});
const client = new Client({ name: "my-client" });
await client.connect(transport);
// Search Google
const searchResult = await client.callTool({
name: "google_search",
arguments: { query: "Model Context Protocol" }
});
console.log(searchResult.content[0].text);
// Extract a YouTube transcript
const transcript = await client.callTool({
name: "scrape_page",
arguments: { url: "https://www.youtube.com/watch?v=dQw4w9WgXcQ" }
});
console.log(transcript.content[0].text);HTTP+SSE Client (Web Application)
Requires a valid OAuth 2.1 Bearer token from your configured authorization server.
import { Client } from "@modelcontextprotocol/sdk/client/index.js";
import { StreamableHTTPClientTransport } from "@modelcontextprotocol/sdk/client/streamableHttp.js";
const transport = new StreamableHTTPClientTransport(
new URL("http://localhost:3000/mcp"),
{
getAuthorization: async () => `Bearer YOUR_ACCESS_TOKEN`
}
);
const client = new Client({ name: "my-client" });
await client.connect(transport);
const result = await client.callTool({
name: "search_and_scrape",
arguments: { query: "Model Context Protocol", num_results: 3 }
});
console.log(result.content[0].text);Management API
Administrative and monitoring endpoints (HTTP transport only):
Method | Endpoint | Description | Auth |
|
| Server health check (status, version, uptime) | Public |
|
| Server version and runtime info | Public |
|
| Cache performance statistics |
|
|
| Event store usage statistics |
|
|
| Clear specific cache entries |
|
|
| Force cache save to disk |
|
|
| Current OAuth configuration |
|
|
| OAuth scopes documentation | Public |
|
| Token details | Authenticated |
Security
OAuth 2.1 Authorization
All HTTP endpoints under /mcp/ (except public documentation) are protected by OAuth 2.1:
Token Validation: JWTs are validated against your authorization server's JWKS endpoint (
${OAUTH_ISSUER_URL}/.well-known/jwks.json).Scope Enforcement: Each tool and admin action requires a specific OAuth scope.
Configure OAUTH_ISSUER_URL and OAUTH_AUDIENCE in .env. See .env.example for details.
STDIO users: OAuth is not used for STDIO transport. You can skip all OAuth configuration.
Available Scopes
Tool Execution:
mcp:tool:google_search:executemcp:tool:google_image_search:executemcp:tool:google_news_search:executemcp:tool:scrape_page:executemcp:tool:search_and_scrape:execute
Administration:
mcp:admin:cache:readmcp:admin:cache:invalidatemcp:admin:cache:persistmcp:admin:event-store:readmcp:admin:config:read
MCP Resources
The server exposes state via the MCP Resources protocol. Use resources/list to discover available resources and resources/read to retrieve them.
URI | Description |
| Last 20 search queries with timestamps and result counts |
| Server configuration (version, start time, transport mode) |
| Cache statistics (hit rate, entry count, memory usage) |
| Event store statistics (event count, storage size) |
Example (using MCP SDK):
const resources = await client.listResources();
const recentSearches = await client.readResource({ uri: "search://recent" });MCP Prompts
Pre-built research workflow templates are available via the MCP Prompts protocol. Use prompts/list to discover prompts and prompts/get to retrieve a prompt with arguments.
Basic Research Prompts
Prompt | Arguments | Description |
|
| Multi-source research on a topic |
|
| Verify a claim against multiple sources |
|
| Summarize content from a single URL |
|
| Get current news summary on a topic |
Advanced Research Prompts
Prompt | Arguments | Description |
|
| Analyze a company's patent holdings |
|
| Compare companies/products |
|
| Academic literature synthesis |
|
| In-depth technical investigation |
Focus areas for technical-deep-dive: architecture, implementation, comparison, best-practices, troubleshooting
Example (using MCP SDK):
const prompts = await client.listPrompts();
// Basic research
const research = await client.getPrompt({
name: "comprehensive-research",
arguments: { topic: "quantum computing", depth: "standard" }
});
// Advanced: Patent analysis
const patents = await client.getPrompt({
name: "patent-portfolio-analysis",
arguments: { company: "Kaltura", includeSubsidiaries: true }
});
// Advanced: Competitive analysis
const comparison = await client.getPrompt({
name: "competitive-analysis",
arguments: { entities: "React, Vue, Angular", aspects: "performance, learning curve, ecosystem" }
});Testing
Script | Description |
| Run all unit/component tests (Jest) |
| Full end-to-end suite (STDIO + HTTP + YouTube) |
| Generate code coverage report |
| STDIO transport E2E only |
| HTTP transport E2E only |
| YouTube transcript E2E only |
All NPM scripts:
Script | Description |
| Run the built server (production) |
| Start with live-reload (development) |
| Compile TypeScript to |
| Open MCP Inspector for interactive debugging |
For testing philosophy and structure, see the Testing Guide.
Development Tools
MCP Inspector
The MCP Inspector is a visual debugging tool for MCP servers. Use it to interactively test tools, browse resources, and verify prompts.
Run the Inspector:
npm run inspectThis opens a browser interface at http://localhost:5173 connected to the server via STDIO.
What to Expect:
Primitive | Count | Items |
Tools | 8 |
|
Resources | 6 |
|
Prompts | 8 |
|
Troubleshooting Inspector Issues:
"Cannot find module" error: Run
npm run buildfirst — Inspector requires compiled JavaScript.Tool calls fail with API errors: Ensure
GOOGLE_CUSTOM_SEARCH_API_KEYandGOOGLE_CUSTOM_SEARCH_IDare set in your.envfile.Port 5173 in use: The Inspector UI runs on port 5173. Stop other services using that port or check if another Inspector instance is running.
Server crashes on startup: Check that all dependencies are installed (
npm install). Chromium is installed automatically via the postinstall hook.
Troubleshooting
Server won't start: Ensure
GOOGLE_CUSTOM_SEARCH_API_KEYandGOOGLE_CUSTOM_SEARCH_IDare set in.env. The server exits with a clear error if either is missing.Empty scrape results: The persistent cache may contain stale entries. Delete
storage/persistent_cache/namespaces/scrapePage/and restart to force fresh scrapes.Playwright/Chromium errors: Chromium is installed automatically during
npm install. If it failed, re-runnpx playwright install chromium. On Linux, also runnpx playwright install-deps chromiumfor system dependencies. In Docker, these are pre-installed. If the browser is missing at runtime, scrape_page returns a clear error message instead of crashing.Port 3000 in use: Stop the other process (
lsof -ti:3000 | xargs kill) or setPORT=3001 npm start.YouTube transcripts fail: Some videos have transcripts disabled by the owner. The error message includes the specific reason (e.g.,
TRANSCRIPT_DISABLED,VIDEO_UNAVAILABLE). See the YouTube Transcript Documentation for all error codes.Cache issues: Use
/mcp/cache-statsto inspect cache health, or/mcp/cache-persistto force a save. See the Management API.OAuth errors: Verify
OAUTH_ISSUER_URLandOAUTH_AUDIENCEin.env. Use/mcp/oauth-configto inspect current configuration.Docker health check failing: The health check hits
/healthon port 3000, which requires HTTP transport. In STDIO mode (MCP_TEST_MODE=stdio), the health check will fail — this is expected.
Roadmap
Feature requests and improvements are tracked as GitHub Issues. Contributions welcome.
Contributing
We welcome contributions of all kinds! Please see the Contribution Guidelines for details.
Star History
If you find this project useful, please consider giving it a star — it helps others discover it.
License
This project is licensed under the MIT License. See the LICENSE file for details.
Available Tools
8 toolsacademic_searchAcademic Paper SearchARead-only
Search academic papers using Google Custom Search API.
When to use:
Finding peer-reviewed, authoritative sources
Research requiring citations and references
Technical/scientific topics and literature reviews
Features:
Paper titles, authors, abstracts
Publication years and venues
Direct PDF links (when available)
Pre-formatted citations (APA, MLA, BibTeX)
Academic sources: arXiv, PubMed, IEEE, Nature, Springer, ResearchGate, JSTOR, and more.
Caching: Results cached for 30 minutes.
Inputs: query (required), num_results, year_from, year_to, +3 more. Returns: papers, query, totalResults, resultCount, +1 more
google_image_searchGoogle Image SearchARead-only
Search for images using Google Custom Search API. Returns image URLs, thumbnails, dimensions, and source page URLs.
When to use:
Finding visual content — photos, illustrations, graphics, diagrams
Need specific image formats, sizes, or color types
Key parameters:
size: huge, large, medium, small
type: clipart, face, lineart, photo, animated
color_type: color, gray, mono, trans (transparent)
file_type: jpg, gif, png, svg, webp
Caching: Results cached for 30 minutes.
Inputs: query (required), num_results, size, type, +4 more. Returns: images, query, resultCount
google_news_searchGoogle News SearchARead-only
Search for recent news articles with freshness filters and date sorting.
When to use:
Current events, breaking news, time-sensitive topics
Need headlines and snippets from news sources
Want to restrict by publication date
When to use scrape_page instead:
You need the full article content
Key parameters:
freshness: hour, day, week, month, year (default: week)
sort_by: relevance or date
news_source: Restrict to specific domain (e.g., 'bbc.com')
Caching: Results cached for 30 minutes.
Inputs: query (required), num_results, freshness, sort_by, +1 more. Returns: articles, query, resultCount, freshness, +1 more
google_searchGoogle SearchARead-only
Search the web using Google Custom Search API. Returns a list of URLs with titles and snippets.
When to use:
You need URLs to process yourself (e.g., selective scraping)
You only need links without full content
You want to filter/choose which URLs to scrape
When to use search_and_scrape instead:
You need actual page content for research
You want content from multiple sources combined
Caching: Results cached for 30 minutes.
Inputs: query (required), num_results, time_range, site_search, +6 more. Returns: urls, query, resultCount
patent_searchPatent SearchARead-only
Search patents using Google Custom Search API (site:patents.google.com).
When to use:
Prior art search before filing
Freedom to operate (FTO) analysis
Patent landscaping and competitive intelligence
Tracking innovation in specific domains
Features:
Patent titles, numbers, abstracts
Inventors and assignees
Filing and publication dates
Direct links to Google Patents and PDFs
Filter by patent office (USPTO, EPO, WIPO, JPO, CNIPA, KIPO)
Assignee search with automatic name variations
Important limitation: Google Custom Search doesn't index ALL patents. For comprehensive company patent research:
Use this tool for initial discovery with technology keywords
Use scrape_page on patents.google.com/?assignee=CompanyName for more complete results
Try multiple variations: company names without spaces, previous names, inventor names
Note that patents may be assigned to parent companies or subsidiaries
Search types:
prior_art: Find related existing patents
specific: Look up specific patent(s)
landscape: Broad overview of a technology area
Caching: Results cached for 30 minutes.
Inputs: query (required), num_results, search_type, patent_office, +5 more. Returns: patents, query, totalResults, resultCount, +2 more
scrape_pageScrape Page (+ YouTube, PDF, DOCX, PPTX)ARead-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 ScrapeARead-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
sequential_searchSequential SearchA
Track multi-step research progress across multiple API calls.
When to use:
Complex investigations requiring 3+ searches with different angles
Research you might abandon early (tracks partial progress)
Investigations where you need to show reasoning steps
Research with branching paths to explore alternatives
When to use search_and_scrape instead:
Simple queries that need content from multiple sources in one call
Key principle: You do the reasoning; this tool tracks state. It persists across API calls so you can build on previous steps.
Example flow:
Start: sequential_search(searchStep: "Starting research on X", stepNumber: 1, nextStepNeeded: true)
Search: search_and_scrape("topic")
Record: sequential_search(searchStep: "Found Y, need Z", stepNumber: 2, source: {...}, nextStepNeeded: true)
Complete: sequential_search(searchStep: "Research complete", stepNumber: 3, nextStepNeeded: false)
Inputs: searchStep (required), stepNumber (required), nextStepNeeded (required), totalStepsEstimate, +7 more. Returns: sessionId, currentStep, totalStepsEstimate, isComplete, +5 more
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 8 tools
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.
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.
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.
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
Related MCP Connectors
Papers, SEC filings, Wikipedia, HN and web reading for research agents. 15 tools, x402.
Web search, scraping, crawling, research, a browser agent, and company and people data.
Web knowledge fetching tools for your agent.
Web search, fetch, extract, and research for AI agents. Markdown output + AI-synthesized answers.
Related MCP Servers
- FlicenseAqualityNot gradedmaintenanceEnables 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.5165 npm3-
- AlicenseAqualityDmaintenanceEnables 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.81MIT
- AlicenseAqualityBmaintenanceWeb 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.42MIT
- FlicenseNot gradedqualityBmaintenanceEnables 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.-