Modernise MCP stack, improve stability, and preserve Gemini CLI OAuth

CHANGELOG.md

@@ -2,6 +2,17 @@
 
 ## [Unreleased]
 
+## [1.2.0] - 2026-04-30
+
+### Added
+- `--no-fallback` CLI flag: when set, quota exceeded (429) errors from the underlying
+  `gemini` CLI are propagated unchanged instead of silently falling back to `gemini-flash`.
+- `GEMINI_MCP_NO_FALLBACK=1` environment variable: equivalent to `--no-fallback`.
+  Useful for process-level opt-out without changing CLI invocation.
+
+Admonish users: the Admonish extract adapter always passes `--no-fallback`; no
+configuration needed on your end. Requires `@jacobcxdev/gemini-mcp-tool >= 1.2.0`.
+
 ## [1.1.3]
 - "gemini reads, claude edits"
 - Added `changeMode` parameter to ask-gemini tool for structured edit responses using claude edit diff.

README.md

@@ -30,7 +30,7 @@ This is a simple Model Context Protocol (MCP) server that allows AI assistants t
 
 Before using this tool, ensure you have:
 
-1. **[Node.js](https://nodejs.org/)** (v16.0.0 or higher)
+1. **[Node.js](https://nodejs.org/)** (v20.12.0 or higher)
 2. **[Google Gemini CLI](https://github.com/google-gemini/gemini-cli)** installed and configured
 
 

docs/api.md

@@ -1,3 +1,38 @@
 # API
 
-Stay tuned.
+## Tools
+
+### `ask-gemini`
+
+Runs the installed Gemini CLI through `gemini -p <prompt>` and returns stdout to the MCP client. Authentication is provided by the Gemini CLI OAuth state on the host machine; this server does not require `GEMINI_API_KEY`.
+
+Parameters:
+
+- `prompt` (required): question or analysis request. Gemini CLI `@file` syntax is supported.
+- `model` (optional): Gemini model passed to the CLI with `-m`.
+- `sandbox` (optional): when true, passes `-s` to the Gemini CLI.
+- `changeMode` (optional): requests structured edit output and post-processes Gemini's response.
+
+### `ping`
+
+Echoes a message and is useful for checking that the MCP server is reachable.
+
+### `Help`
+
+Runs `gemini -help` and returns the Gemini CLI help text.
+
+## Runtime diagnostics
+
+Tracing is disabled by default. Set `GEMINI_MCP_TRACE=1` to write lifecycle diagnostics to a temporary trace file, or set `GEMINI_MCP_TRACE_FILE` to choose the destination. Trace output omits raw tool arguments by default.
+
+Progress notifications are disabled by default because some MCP clients mishandle long-running progress messages. Set `GEMINI_MCP_ENABLE_PROGRESS=1` to re-enable progress notifications for clients that support them correctly.
+
+## Stability validation
+
+Run the local verification script before registering the MCP server:
+
+```bash
+npm run verify
+```
+
+Then validate with your MCP client by listing tools, calling `ping`, and making repeated `ask-gemini` calls to confirm the server stays connected.

docs/getting-started.md

@@ -31,7 +31,7 @@
 
 Before installing, ensure you have:
 
-- **[Node.js](https://nodejs.org/)** v16.0.0 or higher
+- **[Node.js](https://nodejs.org/)** v20.12.0 or higher
 - **[Google Gemini CLI](https://github.com/google-gemini/gemini-cli)** installed and configured on your system
 - **[Claude Desktop](https://claude.ai/download)** or **[Claude Code](https://www.anthropic.com/claude-code)** with MCP support
 

docs/installation.md

@@ -4,7 +4,7 @@ Multiple ways to install Gemini MCP Tool, depending on your needs.
 
 ## Prerequisites
 
-- Node.js v16.0.0 or higher
+- Node.js v20.12.0 or higher
 - Claude Desktop or Claude Code with MCP support
 - Gemini CLI installed (`npm install -g @google/gemini-cli`)