playbooks

home / mcp / gemini researcher mcp server

Gemini Researcher MCP Server

Provides read-only, structured analyses of local codebases by offloading heavy work to the Gemini CLI, reducing agent token usage.

Installation
Add the following to your MCP client configuration file.

Configuration

View docs
{
  "mcpServers": {
    "capybearista-gemini-researcher": {
      "command": "npx",
      "args": [
        "gemini-researcher"
      ],
      "env": {
        "GEMINI_API_KEY": "your-api-key-here"
      }
    }
  }
}

Available tools

quick_query

Fast analysis for quick questions about specific files or small code sections using a concise response style.

deep_research

In-depth, multi-file analysis for architecture reviews, security assessments, and large-scale code understanding.

analyze_directory

Map the directory structure and generate an overview of a codebase with depth control.

validate_paths

Pre-checks to ensure referenced paths exist before executing expensive queries.

health_check

Diagnostics to troubleshoot server or Gemini CLI issues.

fetch_chunk

Retrieve remaining parts of large responses that are returned in chunks.