✨ feat: Update changelog and documentation for image-to-image query improvements

🔧 fix: Adjust image query handling to support multiple references correctly
📄 docs: Clarify image URL requirements in README and schemas
🔄 chore: Bump version to 1.3.1 in package files

Author: sizzlebop

CHANGELOG.md

@@ -217,3 +217,9 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ### Notes
 - Model behavior details for `kontext`, `nanobanana`, and `seedream` are documented in `new_models_integration.md`. `kontext` uses only the first reference; `nanobanana` is safe up to ~4 refs; `seedream` up to 10.
+## [1.3.1] - `2025-09-26`
+
+### Fixed
+- Image-to-image query construction for kontext, nanobanana, and seedream:
+  - Now sends multiple reference images as repeated `image` parameters instead of a single comma-encoded string. This matches the API examples and fixes 400/403 errors some users saw when passing multiple references.
+  - Continues to accept a single URL or a comma-separated string; comma strings are split and sent as repeated params.

README.md

@@ -303,6 +303,8 @@ Perfect for creating variations and new styles:
 
 Multi-reference images: `editImage` and `generateImageFromReference` accept `imageUrl` as a single URL or an array of URLs. The server encodes arrays as the comma-separated `image` parameter used by the API. Ordering matters; kontext uses only the first image, nanobanana is safe up to ~4 refs, and seedream supports up to 10.
 
+Important: URLs only. The image-to-image tools require publicly accessible HTTP(S) URLs. Local file paths, file uploads, and base64/data URLs are not supported by this MCP server (it does not upload files). If you need to work from a local image, host it somewhere accessible (e.g., a temporary file host, object storage, or a raw link in a repo) and pass the URL.
+
 ### **Example Usage**
 ```javascript
 // Edit an existing image

package-lock.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://json.schemastore.org/package.json",
   "name": "@pinkpixel/mcpollinations",
-  "version": "1.3.0",
+  "version": "1.3.1",
   "description": "Model Context Protocol (MCP) server for the Pollinations APIs with image saving functionality.",
   "license": "MIT",
   "type": "module",

package.json

@@ -177,7 +177,7 @@ log('Default params:', {
 const server = new Server(
   {
     name: '@pinkpixel/mcpollinations',
-    version: '1.3.0',
+    version: '1.3.1',
   },
   {
     capabilities: {

pollinations-mcp-server.js

@@ -128,7 +128,7 @@ export const editImageSchema = {
           { type: 'string' },
           { type: 'array', items: { type: 'string' } }
         ],
-        description: 'URL of the input image to edit. Accepts a string or an array for multiple references (first is most important).'
+        description: 'Public HTTP(S) URL(s) of the input image(s) to edit. Accepts a string or an array for multiple references (first is most important). Local file paths, file uploads, or base64/data URLs are not supported.'
       },
       model: {
         type: 'string',
@@ -189,7 +189,7 @@ export const generateImageFromReferenceSchema = {
           { type: 'string' },
           { type: 'array', items: { type: 'string' } }
         ],
-        description: 'URL(s) of reference images. Accepts a string or an array for multi-reference (comma-joined).'
+        description: 'Public HTTP(S) URL(s) of reference images. Accepts a string or an array for multi-reference. Local file paths, file uploads, or base64/data URLs are not supported.'
       },
       model: {
         type: 'string',

src/services/imageSchema.js

@@ -224,15 +224,20 @@ export async function editImage(prompt, imageUrl, model = 'kontext', seed = Math
     throw new Error('Image URL(s) are required and must be a string or array of strings');
   }
 
-  // Support multi-reference images using comma-separated encoding expected by API
-  const imageParam = Array.isArray(imageUrl)
-    ? imageUrl.filter(Boolean).join(',')
-    : imageUrl;
+  // Support multi-reference images. Prefer repeating the `image` param per URL
+  // to avoid comma-encoding ambiguities.
+  const imageList = Array.isArray(imageUrl)
+    ? imageUrl.filter(Boolean)
+    : (typeof imageUrl === 'string' && imageUrl.includes(','))
+      ? imageUrl.split(',').map(s => s.trim()).filter(Boolean)
+      : [imageUrl];
 
   // Build the query parameters
   const queryParams = new URLSearchParams();
   queryParams.append('model', model);
-  queryParams.append('image', imageParam); // Add one or more input image URLs
+  for (const u of imageList) {
+    queryParams.append('image', u);
+  }
   if (seed !== undefined) queryParams.append('seed', seed);
   if (width !== 1024) queryParams.append('width', width);
   if (height !== 1024) queryParams.append('height', height);
@@ -378,14 +383,18 @@ export async function generateImageFromReference(prompt, imageUrl, model = 'kont
     throw new Error('Reference image URL(s) are required and must be a string or array of strings');
   }
 
-  const imageParam = Array.isArray(imageUrl)
-    ? imageUrl.filter(Boolean).join(',')
-    : imageUrl;
+  const imageList = Array.isArray(imageUrl)
+    ? imageUrl.filter(Boolean)
+    : (typeof imageUrl === 'string' && imageUrl.includes(','))
+      ? imageUrl.split(',').map(s => s.trim()).filter(Boolean)
+      : [imageUrl];
 
   // Build the query parameters
   const queryParams = new URLSearchParams();
   queryParams.append('model', model);
-  queryParams.append('image', imageParam); // Add one or more reference image URLs
+  for (const u of imageList) {
+    queryParams.append('image', u);
+  }
   if (seed !== undefined) queryParams.append('seed', seed);
   if (width !== 1024) queryParams.append('width', width);
   if (height !== 1024) queryParams.append('height', height);