@chrischall/gemini-mcp 1.14.2 → 2.1.0

package/dist/tools/files.js

@@ -89,7 +89,7 @@ export function registerFileTools(server, client) {
                 : ' To upload a local file without base64: mint a signed PUT URL with gemini_get_upload_url, PUT the bytes to it, ' +
                     'then pass the returned r2_key here.'),
         annotations: { readOnlyHint: false, openWorldHint: true },
-        inputSchema: {
+        inputSchema: z.object({
             url: z
                 .string()
                 .url()
@@ -126,7 +126,7 @@ export function registerFileTools(server, client) {
                 .describe('Override the detected MIME type (sniffed from the bytes / taken from the server response otherwise)'),
             display_name: z.string().min(1).optional().describe('Human-readable name recorded against the upload'),
             confirm: schemaConfirm,
-        },
+        }),
     }, async (args, extra) => {
         const sources = [args.url && 'url', args.data_base64 && 'data_base64', args.r2_key && 'r2_key', args.path && 'path'].filter(Boolean);
         if (sources.length !== 1) {
@@ -184,9 +184,9 @@ export function registerFileTools(server, client) {
         description: 'List files, images and photos currently uploaded to the Gemini Files API under this API key, with their reusable `file_uri` (`files/<id>`) references, ' +
             'MIME types and expiry times. Retention is ~48h, so an entry that has vanished has expired rather than failed.',
         annotations: { readOnlyHint: true, openWorldHint: true },
-        inputSchema: {
+        inputSchema: z.object({
             page_size: z.number().int().positive().max(100).optional().describe('Maximum files to return (1-100, default 100)'),
-        },
+        }),
     }, async (args) => {
         const files = await client.listFiles(args.page_size ?? 100);
         return minifiedResult({
@@ -216,9 +216,9 @@ export function registerFileTools(server, client) {
                 'end — re-sign it instead of re-generating (and re-paying for) the image. Keywords: expired link, refresh url, ' +
                 're-sign, media url, download again.',
             annotations: { readOnlyHint: true, openWorldHint: false },
-            inputSchema: {
+            inputSchema: z.object({
                 r2_key: z.string().min(1).describe('The `media[].r2_key` from an earlier generation result'),
-            },
+            }),
         }, async (args) => {
             const sink = client.mediaSink;
             if (!sink?.resign) {
@@ -260,9 +260,9 @@ export function registerFileTools(server, client) {
                 'Costs image tokens on the turns you use it, which is why it is a separate call and not part of every result. ' +
                 'Keywords: see the image, view, look at, verify output, check the result, preview.',
             annotations: { readOnlyHint: true, openWorldHint: false },
-            inputSchema: {
+            inputSchema: z.object({
                 r2_key: z.string().min(1).describe('The `media[].r2_key` from a generation result or gemini_list_recent_media'),
-            },
+            }),
         }, async (args) => {
             const key = args.r2_key.trim();
             const { bytes, mimeType } = await client.readStoredMedia(key);
@@ -287,14 +287,14 @@ export function registerFileTools(server, client) {
                 'to find what already exists BEFORE re-running (and re-paying for) it. Keywords: lost result, orphaned job, ' +
                 'missing image, what did I generate, recover, recent media.',
             annotations: { readOnlyHint: true, openWorldHint: false },
-            inputSchema: {
+            inputSchema: z.object({
                 limit: z.number().int().positive().max(100).optional().describe('How many to return (default 20, newest first)'),
                 since_day: z
                     .string()
                     .regex(/^\d{4}-\d{2}-\d{2}$/)
                     .optional()
                     .describe('Only media stored on or after this UTC day, e.g. "2026-08-18"'),
-            },
+            }),
         }, async (args) => {
             const sink = client.mediaSink;
             if (!sink?.listRecent) {
@@ -338,10 +338,10 @@ export function registerFileTools(server, client) {
         description: 'Delete an uploaded file, image or photo (by file_uri) from the Gemini Files API before its ~48h expiry. Any tool call still referencing it ' +
             'will then fail with a generic 404, so delete only references you are finished with.',
         annotations: { readOnlyHint: false, destructiveHint: true, openWorldHint: true },
-        inputSchema: {
+        inputSchema: z.object({
             file_uri: z.string().min(1).describe('The `files/<id>` reference (or full uri) to delete'),
             confirm: schemaConfirm,
-        },
+        }),
     }, async (args) => {
         // Deleting is a remote mutation with no undo — confirm-gated per the
         // fleet convention (unlike writing a generated image, which is local).

package/dist/tools/generate.js

@@ -19,7 +19,7 @@ export function registerGenerateTools(server, client) {
         description: 'Generate image(s) from a text prompt with a Gemini image model (Nano Banana / Nano Banana Pro). ' +
             'If the result will likely be refined iteratively, prefer gemini_interact (multi-turn) as the entry point.',
         annotations: { readOnlyHint: false, openWorldHint: true },
-        inputSchema: {
+        inputSchema: z.object({
             prompt: z.string().min(1).describe('Text prompt describing the image'),
             count: z.number().int().positive().max(8).optional().describe('Number of independent images (default 1)'),
             filename: z.string().optional().describe('Base filename for the output image (extension stripped; default: slugified prompt)'),
@@ -34,7 +34,7 @@ export function registerGenerateTools(server, client) {
             video_path: videoPathSchema,
             confirm: schemaConfirm,
             ...sharedImageSchema,
-        },
+        }),
     }, async (args, extra) => {
         // Local-path / clipboard / disk-upload inputs simply do not exist on the
         // hosted connector. Fail here — before the confirm gate previews files and
@@ -161,7 +161,7 @@ export function registerGenerateTools(server, client) {
             'and avoids re-processing the full image each round; use gemini_image_edit for one-off edits or composing multiple distinct inputs. ' +
             'Gemini over-preserves the input; there is no edit-strength control — for large structural changes, reroll with a different `seed` or more forceful wording.',
         annotations: { readOnlyHint: false, openWorldHint: true },
-        inputSchema: {
+        inputSchema: z.object({
             prompt: z.string().min(1).describe('Instruction describing the edit or composition'),
             images: z.array(z.string().min(1)).optional().describe('Paths to input image file(s) (1 = edit, 2+ = compose)'),
             images_url: imagesUrlSchema('Input images'),
@@ -173,7 +173,7 @@ export function registerGenerateTools(server, client) {
             filename: z.string().optional().describe('Base filename for the output image (extension stripped; default: slugified prompt)'),
             confirm: schemaConfirm,
             ...sharedImageSchema,
-        },
+        }),
     }, async (args, extra) => {
         assertLocalInputsAvailable(client.mediaSink, args);
         // Saved characters count as input images for the required-input check —

package/dist/tools/interact.js

@@ -91,7 +91,7 @@ export function registerInteractTools(server, client) {
             recoveryDescription +
             'Output is JPEG.',
         annotations: { readOnlyHint: false, openWorldHint: true },
-        inputSchema: {
+        inputSchema: z.object({
             input: z.string().min(1).describe('Text prompt or editing instruction'),
             previous_interaction_id: z
                 .string()
@@ -161,7 +161,7 @@ export function registerInteractTools(server, client) {
                 .optional()
                 .describe('Use the image currently on the macOS system clipboard as an input (downscaled to JPEG)'),
             confirm: schemaConfirm,
-        },
+        }),
     }, async (args, extra) => {
         assertLocalInputsAvailable(client.mediaSink, args);
         // Every sidecar-backed recovery below reads the output dir off disk. A

package/dist/tools/jobs.js

@@ -24,10 +24,10 @@ export function registerJobTools(server, client) {
         // NOT read-only any more: recovering a killed job writes the media it
         // pulls back, exactly as the generation tool would have.
         annotations: { readOnlyHint: false, openWorldHint: true },
-        inputSchema: {
+        inputSchema: z.object({
             job_id: z.string().min(1).describe('The job_id returned by a generation tool called with async: true'),
             output_dir: z.string().optional().describe('Where to write media recovered from a killed job (default: $GEMINI_OUTPUT_DIR or cwd)'),
-        },
+        }),
     }, async (args) => {
         try {
             return await client.session.jobs.getResult(args.job_id);

package/dist/tools/library.js

@@ -63,7 +63,7 @@ export function registerLibraryTools(server, client) {
             '— so a name saved once keeps working in every later session. Re-saving a name replaces it. ' +
             USE_CHARACTERS_HINT,
         annotations: { readOnlyHint: false, openWorldHint: false },
-        inputSchema: {
+        inputSchema: z.object({
             name: NAME_FIELD,
             description: z
                 .string()
@@ -75,7 +75,7 @@ export function registerLibraryTools(server, client) {
                 .optional()
                 .describe('Reference image already in this connector\'s store: an `r2_key` from gemini_get_upload_url + PUT, or from a generation result\'s media[].r2_key'),
             image_url: z.string().url().optional().describe('Reference image as a public https URL the SERVER fetches'),
-        },
+        }),
     }, async (args, extra) => {
         const image = (await withProgressHeartbeat(extra, 'Loading the reference image', () => resolveLibraryImage(client, args, true)));
         const record = await library.saveCharacter({ name: args.name, description: args.description, image });
@@ -93,7 +93,7 @@ export function registerLibraryTools(server, client) {
         description: 'List this account\'s saved characters (persistent reference library): names, descriptions and timestamps. ' +
             USE_CHARACTERS_HINT,
         annotations: { readOnlyHint: true, openWorldHint: false },
-        inputSchema: {},
+        inputSchema: z.object({}),
     }, async () => {
         const characters = await library.listCharacters();
         return minifiedResult({
@@ -113,7 +113,7 @@ export function registerLibraryTools(server, client) {
     server.registerTool('gemini_delete_character', {
         description: 'Delete a saved character from this account\'s reference library. Generation calls naming it will then fail until it is re-saved.',
         annotations: { readOnlyHint: false, destructiveHint: true, openWorldHint: false },
-        inputSchema: { name: NAME_FIELD, confirm: schemaConfirm },
+        inputSchema: z.object({ name: NAME_FIELD, confirm: schemaConfirm }),
     }, async (args) => {
         const gate = previewUnlessConfirmed(args.confirm, 'Delete a saved character (its reference image and description)', 'DELETE', `characters/${args.name}`);
         if (gate)
@@ -129,7 +129,7 @@ export function registerLibraryTools(server, client) {
             'optionally a reference image) that a single word then applies to any generation. No expiry; re-saving a name replaces it. ' +
             USE_STYLE_HINT,
         annotations: { readOnlyHint: false, openWorldHint: false },
-        inputSchema: {
+        inputSchema: z.object({
             name: NAME_FIELD,
             prompt_fragment: z
                 .string()
@@ -137,7 +137,7 @@ export function registerLibraryTools(server, client) {
                 .describe('The style text appended to generation prompts, e.g. "bold cartoon style, thick outlines, saturated colors"'),
             image_r2_key: z.string().min(1).optional().describe('Optional style reference image already in this connector\'s store (an r2_key)'),
             image_url: z.string().url().optional().describe('Optional style reference image as a public https URL the SERVER fetches'),
-        },
+        }),
     }, async (args, extra) => {
         const image = await withProgressHeartbeat(extra, 'Loading the style reference image', () => resolveLibraryImage(client, args, false));
         const record = await library.saveStyle({ name: args.name, promptFragment: args.prompt_fragment, image });
@@ -154,7 +154,7 @@ export function registerLibraryTools(server, client) {
     server.registerTool('gemini_list_styles', {
         description: 'List this account\'s saved style presets (persistent reference library). ' + USE_STYLE_HINT,
         annotations: { readOnlyHint: true, openWorldHint: false },
-        inputSchema: {},
+        inputSchema: z.object({}),
     }, async () => {
         const styles = await library.listStyles();
         return minifiedResult({
@@ -172,7 +172,7 @@ export function registerLibraryTools(server, client) {
     server.registerTool('gemini_delete_style', {
         description: 'Delete a saved style preset from this account\'s reference library.',
         annotations: { readOnlyHint: false, destructiveHint: true, openWorldHint: false },
-        inputSchema: { name: NAME_FIELD, confirm: schemaConfirm },
+        inputSchema: z.object({ name: NAME_FIELD, confirm: schemaConfirm }),
     }, async (args) => {
         const gate = previewUnlessConfirmed(args.confirm, 'Delete a saved style preset', 'DELETE', `styles/${args.name}`);
         if (gate)

package/dist/tools/music.js

@@ -30,7 +30,7 @@ export function registerMusicTools(server, client) {
             'cannot be refined by a follow-up call, so put the whole brief in the prompt. Runs long — give it a `max_wait_ms` ' +
             'budget (or `async: true` + gemini_get_result on a local install), or raise `timeout_ms`. Needs a funded account.',
         annotations: { readOnlyHint: false, openWorldHint: true },
-        inputSchema: {
+        inputSchema: z.object({
             prompt: z.string().min(1).describe('Description of the music: mood, genre, instruments, tempo, structure, or lyrics'),
             model: z.enum(MUSIC_MODELS).optional().describe(`Lyria model (default: ${DEFAULT_MUSIC_MODEL} — 30s, $0.04). lyria-3.5 and lyria-3-pro-preview run minutes-long at $0.08.`),
             images: z.array(z.string().min(1)).optional().describe('Optional reference image path(s) to condition the music'),
@@ -47,7 +47,7 @@ export function registerMusicTools(server, client) {
             async: asyncSchema,
             max_wait_ms: maxWaitMsSchema,
             confirm: schemaConfirm,
-        },
+        }),
     }, async (args, extra) => {
         assertLocalInputsAvailable(client.mediaSink, args);
         const model = args.model ?? DEFAULT_MUSIC_MODEL;

package/dist/tools/set.js

@@ -13,7 +13,7 @@ export function registerSetTools(server, client) {
         description: 'Generate a consistent SET of images: a master image from master_prompt, then one image per scene that references the master so the subject/style stays consistent. Provide `scenes` (explicit per-image prompts) OR `count` (variations of the master). ' +
             'Scene generations run in parallel (reference_mode "master", the default). On the hosted connector: saved `characters` and a saved `style` can seed the whole set by name, multi-image results include a `bundle_url` zip of every image (one curl instead of N), and `max_wait_ms` returns a pollable job handle if the batch runs long.',
         annotations: { readOnlyHint: false, openWorldHint: true },
-        inputSchema: {
+        inputSchema: z.object({
             master_prompt: z.string().min(1).describe('Prompt for the master/reference image'),
             scenes: z.array(z.string().min(1)).min(1).max(8).optional().describe('Per-image prompts (1-8); each references the master'),
             count: z.number().int().positive().max(8).optional().describe('Number of variations of master_prompt (when scenes omitted)'),
@@ -28,7 +28,7 @@ export function registerSetTools(server, client) {
             master_images_base64: imagesBase64Schema('Reference images for the master generation', 'master_images'),
             confirm: schemaConfirm,
             ...sharedImageSchema,
-        },
+        }),
     }, async (args, extra) => {
         assertLocalInputsAvailable(client.mediaSink, args);
         // `scenes` is min(1) at the schema, so a non-undefined value is non-empty.

package/dist/tools/shared.js

@@ -356,8 +356,8 @@ const HEARTBEAT_DEFAULT_MS = 10_000;
  * `fn`'s result/rejection passes through untouched.
  */
 export async function withProgressHeartbeat(extra, message, fn) {
-    const progressToken = extra?._meta?.progressToken;
-    const send = extra?.sendNotification;
+    const progressToken = extra?.mcpReq?._meta?.progressToken;
+    const send = extra?.mcpReq?.notify;
     const env = Number(readEnvVar('GEMINI_HEARTBEAT_MS'));
     const intervalMs = Number.isFinite(env) ? env : HEARTBEAT_DEFAULT_MS;
     const debug = !!readEnvVar('GEMINI_DEBUG');
@@ -376,7 +376,7 @@ export async function withProgressHeartbeat(extra, message, fn) {
             const reason = progressToken === undefined
                 ? 'no progressToken from host (host cannot extend its tools/call timeout; long calls will hit it)'
                 : !send
-                    ? 'host provided no sendNotification channel'
+                    ? 'no mcpReq.notify on the request extra (SDK v2 renamed v1\'s sendNotification; without it there is no channel to send progress on)'
                     : 'heartbeat disabled (GEMINI_HEARTBEAT_MS=0)';
             console.error(`[gemini-mcp] heartbeat inactive: ${reason} — ${message}`);
         }

package/dist/tools/uploads.js

@@ -52,7 +52,7 @@ export function registerUploadUrlTools(server, client) {
             `${wholeMb(UPLOAD_MAX_BYTES)}MB. The PUT must send exactly the Content-Type this URL was minted for — the signature ` +
             'covers it, so a mismatched header is rejected.',
         annotations: { readOnlyHint: true, openWorldHint: false },
-        inputSchema: {
+        inputSchema: z.object({
             filename: z
                 .string()
                 .min(1)
@@ -64,7 +64,7 @@ export function registerUploadUrlTools(server, client) {
                 // serves from the connector's own origin (see RASTER_IMAGE_TYPE_PATTERN).
                 .regex(RASTER_IMAGE_TYPE_PATTERN, 'must be a raster image MIME type like image/jpeg (SVG is not accepted)')
                 .describe('MIME type of the bytes that will be PUT — raster images only (jpeg/png/webp/gif/avif/heic/heif/bmp/tiff; not SVG). The PUT must send exactly this Content-Type.'),
-        },
+        }),
     }, async (args) => {
         // `step` names the operation in the message, and `surfaceToolErrors`
         // (wired in index.ts) prefixes the tool and flattens the cause chain —

package/dist/tools/usage.js

@@ -34,12 +34,12 @@ export function registerUsageTools(server, client) {
             'Call it before and after a workflow and subtract to get that workflow\'s cost; call it after a ' +
             'single generation for that call\'s. Reports tokens AND an estimated USD cost, priced per call against each call\'s own model and stamped with the date its rates were read (override with GEMINI_RATE_CARD). Note there is no account-balance endpoint to query — Google Cloud is post-paid and its billing data lags by hours — so this is the accurate way to attribute spend to a call.',
         annotations: toolAnnotations({ readOnly: true }),
-        inputSchema: {
+        inputSchema: z.object({
             reset: z
                 .boolean()
                 .optional()
                 .describe('Zero the running total after reporting it, so the next call measures from here. Use it to bracket a workflow without arithmetic.'),
-        },
+        }),
     }, async (args) => {
         const usage = client.session.usageTotal;
         const calls = client.session.billedCalls;

package/dist/tools/video.js

@@ -38,7 +38,7 @@ export function registerVideoTools(server, client) {
             'Output is written to disk as MP4 (video has no inline MCP block). Video runs long — give it a `max_wait_ms` budget ' +
             '(or `async: true` + gemini_get_result on a local install), or raise `timeout_ms`. Needs a funded account.',
         annotations: { readOnlyHint: false, openWorldHint: true },
-        inputSchema: {
+        inputSchema: z.object({
             prompt: z.string().min(1).describe('Description of the video to generate (or the edit instruction when task=edit)'),
             aspect_ratio: z.enum(VIDEO_ASPECT_RATIOS).optional().describe('Exact output aspect ratio (omni: 16:9 or 9:16). `orientation` is the plain-language shorthand; this wins if both are given.'),
             orientation: orientationSchema,
@@ -65,7 +65,7 @@ export function registerVideoTools(server, client) {
             async: asyncSchema,
             max_wait_ms: maxWaitMsSchema,
             confirm: schemaConfirm,
-        },
+        }),
     }, async (args, extra) => {
         assertLocalInputsAvailable(client.mediaSink, args);
         let previousInteractionId = args.previous_interaction_id;

package/dist/version.js

@@ -1,2 +1,2 @@
 /** Single source of the server version. release-please bumps the literal below. */
-export const VERSION = '1.14.2'; // x-release-please-version
+export const VERSION = '2.1.0'; // x-release-please-version

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@chrischall/gemini-mcp",
-  "version": "1.14.2",
+  "version": "2.1.0",
   "mcpName": "io.github.chrischall/gemini-mcp",
   "description": "Gemini image-generation MCP server for Claude — developed and maintained by AI (Claude Code)",
   "author": "Claude Code (AI) <https://www.anthropic.com/claude>",
@@ -38,7 +38,7 @@
   ],
   "scripts": {
     "build": "tsc && npm run bundle",
-    "bundle": "esbuild src/index.ts --bundle --platform=node --format=esm --external:dotenv --outfile=dist/bundle.js",
+    "bundle": "esbuild src/index.ts --bundle --alias:zod/v4=./node_modules/zod/v4/index.cjs --platform=node --format=esm --external:dotenv --outfile=dist/bundle.js",
     "dev": "node dist/index.js",
     "test": "npm run typecheck && vitest run",
     "test:watch": "vitest",
@@ -46,12 +46,13 @@
     "typecheck": "tsc -p tsconfig.test.json"
   },
   "dependencies": {
-    "@chrischall/mcp-utils": "^0.26.1",
-    "@modelcontextprotocol/sdk": "^1.30.0",
+    "@chrischall/mcp-utils": "^1.0.0",
+    "@modelcontextprotocol/server": "^2.0.0",
     "dotenv": "^17.4.0",
-    "zod": "^4.5.4"
+    "zod": "^4.6.2"
   },
   "devDependencies": {
+    "@modelcontextprotocol/client": "^2.0.0",
     "@types/node": "^26.0.0",
     "@vitest/coverage-v8": "^5.0.0",
     "esbuild": "^0.28.0",

package/server.json

@@ -6,12 +6,12 @@
     "url": "https://github.com/chrischall/gemini-mcp",
     "source": "github"
   },
-  "version": "1.14.2",
+  "version": "2.1.0",
   "packages": [
     {
       "registryType": "npm",
       "identifier": "@chrischall/gemini-mcp",
-      "version": "1.14.2",
+      "version": "2.1.0",
       "transport": {
         "type": "stdio"
       },