Schema | gemini_mcp

Server Configuration

Describes the environment variables required to run the server.

Name	Required	Description	Default
No arguments

Capabilities

Features and capabilities supported by this server

Capability	Details
`tools`	{ "listChanged": false }
`prompts`	{ "listChanged": false }
`resources`	{ "subscribe": false, "listChanged": false }
`experimental`	{}

Tools

Functions exposed to the LLM to take actions

Name	Description
gemini	Invokes Gemini via ACP (Agent Client Protocol) for AI-driven tasks. Return structure: - `success`: boolean indicating execution status - `SESSION_ID`: ACP session identifier (auto-managed per workspace) - `agent_messages`: concatenated assistant response text - `thought`: agent reasoning/thinking (when available) - `stop_reason`: why the agent stopped (end_turn, max_tokens, etc.) - `tool_calls`: list of tool invocations made by the agent (if any) - `plan`: agent execution plan entries (if any) - `error`: error description when `success=False` Best practices: - Sessions auto-reuse per workspace with turn-count eviction - ALWAYS pass `model`. Use `gemini-3.1-pro-preview` for complex tasks, `gemini-3-flash-preview` for simple tasks - Use `approval_mode` to control tool approval: yolo (default), auto_edit, default, plan - On 429 capacity errors, automatically retries with `gemini-3-flash-preview` - Pass `image_path` for vision analysis (requires agent image support) - Pass `context` to inject text as embedded resource (ACP resource ContentBlock) - Pass `allowed_mcp_servers` to filter which MCP servers Gemini loads
list_models	List available Gemini models and current bridge state. Returns known models, current active model, and agent info.
list_sessions	List all active ACP sessions managed by the bridge. Shows workspace path, session ID, turn count, and model for each session.
reset_session	Reset (clear) the ACP session for a workspace. The next gemini call for this workspace will create a fresh session. Pass workspace path, or omit to reset all sessions.

Prompts

Interactive templates invoked by user choice

Name	Description
No prompts

Resources

Contextual data attached and managed by the client

Name	Description
No resources

gemini_mcp

Server Configuration

Capabilities

Tools

Prompts

Resources

Latest Blog Posts

MCP directory API