Skip to main content
Glama
machinemates-ai

Gemini Research MCP Server

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault

No arguments

Instructions

Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.

This server publishes no instructions, or was last inspected before Glama recorded them.

Capabilities

Features and capabilities supported by this server

Protocol revision2025-11-25

CapabilityDetails
tasks
{
  "list": {},
  "cancel": {},
  "requests": {
    "tools": {
      "call": {}
    },
    "prompts": {
      "get": {}
    },
    "resources": {
      "read": {}
    }
  }
}
tools
{
  "listChanged": true
}
logging
{}
prompts
{
  "listChanged": false
}
resources
{
  "subscribe": false,
  "listChanged": false
}
extensions
{
  "io.modelcontextprotocol/ui": {}
}
experimental
{}

Tools

Functions exposed to the LLM to take actions

NameDescription
research_webA

Fast web research with Gemini grounding. Returns answer with citations in seconds.

Uses a fixed high thinking level for higher-quality grounded answers.

Use for: quick lookups, fact-checking, current events, documentation, "what is", "how to", real-time information, news, API references, error messages.

research_deepB

Run the default Deep Research agent with optional File Search and MCP tools.

resume_researchA

Resume an interrupted or in-progress research_deep session.

Use when a research_deep call was cut short (client disconnect, transport error, cancellation) or when you want to check whether a long-running session has since completed on Gemini's servers.

Because research_deep persists its session at the start, the research continues on Gemini's side even when the MCP client goes away — this tool retrieves the result once it's ready.

Call with no arguments to list recoverable sessions. Call with an interaction_id (returned by the original research_deep call or by list_research_sessions) to check a specific session's status; if it has completed, the full report is returned. Hand the result off to export_research_session(format="docx") to save the report to disk.

export_research_sessionA

Save (export, download, archive) a completed research session to a file on disk — Word (.docx), Markdown (.md), or JSON. Use this to recover your report after a research_deep run completes or is interrupted, and to convert reports into a shareable Word document.

Disk-first contract. The file is always written to disk, and the absolute path is returned on the first line of the response as Saved to: <path>. When output_path is omitted the file lands in GEMINI_RESEARCH_EXPORT_DIR (default ~/.gemini-research/exports/). An EmbeddedResource is still attached so GUI hosts can expose their native "Save As" affordance.

Similar to Google's Deep Research export feature, the DOCX output is a professional Word document suitable for sharing, archiving, or further editing.

Supported formats:

  • docx: Word document with headings, lists, and table of contents

  • markdown: Clean .md file with full report and citations

  • json: Machine-readable, all metadata preserved

Typical recovery flow:

  1. research_deep(...) completes (or is resumed via resume_research).

  2. export_research_session(format="docx") — no other arguments needed; the path on disk is returned in the response text.

search_toolsA

Search for tools using natural language.

Returns matching tool definitions ranked by relevance, in the same format as list_tools.

call_toolB

Call a tool by name with the given arguments.

Use this to execute tools discovered via search_tools.

Prompts

Interactive templates invoked by user choice

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription
get_research_modelsList available research models and their capabilities. Returns information about the models used by this server: - Quick research model (Gemini + Google Search grounding) - Deep Research Agent (autonomous multi-step research)
Available ExportsList all currently cached exports ready for download.

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/machinemates-ai/gemini-research-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server