@stabgan/openrouter-mcp-multimodal 4.5.3 → 4.6.1

package/dist/tool-handlers.js

@@ -14,7 +14,12 @@ import { handleAnalyzeVideo } from './tool-handlers/analyze-video.js';
 import { handleGenerateVideo, handleGetVideoStatus, handleGenerateVideoFromImage, } from './tool-handlers/generate-video.js';
 import { handleRerankDocuments } from './tool-handlers/rerank.js';
 import { handleHealthCheck } from './tool-handlers/health-check.js';
+import { handleGenerateImageDedicated } from './tool-handlers/generate-image-dedicated.js';
+import { handleTextToSpeech } from './tool-handlers/text-to-speech.js';
+import { handleSpeechToText } from './tool-handlers/speech-to-text.js';
+import { handleStartChatCompletion, handleGetChatCompletionStatus, } from './tool-handlers/async-chat.js';
 import { TOOL_DESCRIPTIONS } from './tool-descriptions.js';
+import { TOOL_ICONS } from './tool-icons.js';
 function wrapToolArgs(a) {
     return { params: { arguments: a ?? {} } };
 }
@@ -88,8 +93,9 @@ export class ToolHandlers {
                             model: {
                                 type: 'string',
                                 description: 'Model ID (optional, uses default). Append `:nitro` for the fastest variant, ' +
-                                    '`:floor` for the cheapest, or `:exacto` for the best tool-calling accuracy. ' +
-                                    'Example: `openai/gpt-4o:nitro`.',
+                                    '`:floor` for the cheapest, `:free` for the free tier, `:online` for web search, ' +
+                                    'or `:exacto` for the best tool-calling accuracy. ' +
+                                    'Example: `openai/gpt-4o:nitro`. Or pass `online: true` for programmatic web search control.',
                             },
                             messages: {
                                 type: 'array',
@@ -166,6 +172,68 @@ export class ToolHandlers {
                         required: ['messages'],
                     },
                 },
+                {
+                    name: 'start_chat_completion',
+                    description: TOOL_DESCRIPTIONS.start_chat_completion,
+                    annotations: {
+                        title: 'Start async chat completion',
+                        readOnlyHint: false,
+                        destructiveHint: false,
+                        idempotentHint: false,
+                        openWorldHint: true,
+                    },
+                    inputSchema: {
+                        type: 'object',
+                        properties: {
+                            model: { type: 'string', description: 'Model ID (same as chat_completion).' },
+                            messages: {
+                                type: 'array',
+                                minItems: 1,
+                                items: {
+                                    type: 'object',
+                                    properties: {
+                                        role: { type: 'string', enum: ['system', 'user', 'assistant'] },
+                                        content: {
+                                            oneOf: [{ type: 'string' }, { type: 'array', items: { type: 'object' } }],
+                                        },
+                                    },
+                                    required: ['role', 'content'],
+                                },
+                            },
+                            temperature: { type: 'number', minimum: 0, maximum: 2 },
+                            max_tokens: { type: 'number', minimum: 1 },
+                            provider: { type: 'object' },
+                            include_reasoning: { type: 'boolean' },
+                            online: { type: 'boolean' },
+                            web_max_results: { type: 'number', minimum: 1 },
+                            cache: { type: 'boolean' },
+                            cache_ttl: { type: 'string' },
+                            cache_clear: { type: 'boolean' },
+                        },
+                        required: ['messages'],
+                    },
+                },
+                {
+                    name: 'get_chat_completion_status',
+                    description: TOOL_DESCRIPTIONS.get_chat_completion_status,
+                    annotations: {
+                        title: 'Get async chat completion status',
+                        readOnlyHint: true,
+                        destructiveHint: false,
+                        idempotentHint: true,
+                        openWorldHint: false,
+                    },
+                    inputSchema: {
+                        type: 'object',
+                        properties: {
+                            job_id: {
+                                type: 'string',
+                                description: 'The job_id returned by start_chat_completion.',
+                            },
+                        },
+                        required: ['job_id'],
+                    },
+                },
                 {
                     name: 'analyze_image',
                     description: TOOL_DESCRIPTIONS.analyze_image,
@@ -394,6 +462,69 @@ export class ToolHandlers {
                         required: ['prompt'],
                     },
                 },
+                {
+                    name: 'generate_image_dedicated',
+                    description: TOOL_DESCRIPTIONS.generate_image_dedicated,
+                    annotations: {
+                        title: 'Generate image (dedicated API)',
+                        readOnlyHint: false,
+                        destructiveHint: false,
+                        idempotentHint: false,
+                        openWorldHint: true,
+                    },
+                    inputSchema: {
+                        type: 'object',
+                        properties: {
+                            prompt: {
+                                type: 'string',
+                                description: 'Text prompt describing the image to generate.',
+                            },
+                            model: {
+                                type: 'string',
+                                description: 'Image model ID. Default: google/gemini-2.5-flash-image. Browse available at https://openrouter.ai/collections/image-models',
+                            },
+                            resolution: {
+                                type: 'string',
+                                enum: ['512', '0.5K', '1K', '2K', '4K'],
+                                description: 'Normalized resolution tier. Provider maps to closest supported size.',
+                            },
+                            aspect_ratio: {
+                                type: 'string',
+                                description: 'Aspect ratio (e.g. "1:1", "16:9", "9:16", "4:3", "21:9").',
+                            },
+                            quality: {
+                                type: 'string',
+                                enum: ['auto', 'low', 'medium', 'high'],
+                                description: 'Image quality level.',
+                            },
+                            output_format: {
+                                type: 'string',
+                                enum: ['png', 'jpeg', 'webp', 'svg'],
+                                description: 'Output image format.',
+                            },
+                            n: {
+                                type: 'number',
+                                minimum: 1,
+                                maximum: 10,
+                                description: 'Number of images to generate (model-dependent, default 1).',
+                            },
+                            input_references: {
+                                type: 'array',
+                                items: { type: 'string' },
+                                description: 'Reference images for image-to-image workflows. Each entry: local path, http(s) URL, or data URL.',
+                            },
+                            save_path: { type: 'string', description: 'Save generated image to this path.' },
+                            provider: {
+                                type: 'object',
+                                description: 'Provider routing overrides (order, sort, allow_fallbacks, etc.).',
+                            },
+                            cache: { type: 'boolean' },
+                            cache_ttl: { type: 'string' },
+                            cache_clear: { type: 'boolean' },
+                        },
+                        required: ['prompt'],
+                    },
+                },
                 {
                     name: 'generate_audio',
                     description: TOOL_DESCRIPTIONS.generate_audio,
@@ -416,6 +547,97 @@ export class ToolHandlers {
                         required: ['prompt'],
                     },
                 },
+                {
+                    name: 'text_to_speech',
+                    description: TOOL_DESCRIPTIONS.text_to_speech,
+                    annotations: {
+                        title: 'Text to speech (dedicated API)',
+                        readOnlyHint: false,
+                        destructiveHint: false,
+                        idempotentHint: false,
+                        openWorldHint: true,
+                    },
+                    inputSchema: {
+                        type: 'object',
+                        properties: {
+                            input: {
+                                type: 'string',
+                                description: 'Text to convert to speech.',
+                            },
+                            model: {
+                                type: 'string',
+                                description: 'TTS model. Default: openai/gpt-4o-mini-tts-2025-12-15. Also: google/gemini-flash-tts, mistral/voxtral-mini-tts.',
+                            },
+                            voice: {
+                                type: 'string',
+                                description: 'Voice ID (model-specific). Default: alloy. OpenAI voices: alloy, echo, fable, onyx, nova, shimmer.',
+                            },
+                            response_format: {
+                                type: 'string',
+                                enum: ['mp3', 'opus', 'aac', 'flac', 'wav', 'pcm'],
+                                description: 'Output audio format. Default: mp3.',
+                            },
+                            speed: {
+                                type: 'number',
+                                minimum: 0.25,
+                                maximum: 4.0,
+                                description: 'Speed of speech (0.25 to 4.0). Default: 1.0.',
+                            },
+                            instructions: {
+                                type: 'string',
+                                description: 'Tone/style instructions (e.g. "speak in a warm, friendly tone"). OpenAI models only.',
+                            },
+                            save_path: { type: 'string', description: 'Save audio to this path.' },
+                            cache: { type: 'boolean' },
+                            cache_ttl: { type: 'string' },
+                            cache_clear: { type: 'boolean' },
+                        },
+                        required: ['input'],
+                    },
+                },
+                {
+                    name: 'speech_to_text',
+                    description: TOOL_DESCRIPTIONS.speech_to_text,
+                    annotations: {
+                        title: 'Speech to text (dedicated API)',
+                        readOnlyHint: true,
+                        destructiveHint: false,
+                        idempotentHint: false,
+                        openWorldHint: true,
+                    },
+                    inputSchema: {
+                        type: 'object',
+                        properties: {
+                            audio_path: {
+                                type: 'string',
+                                description: 'Audio file: local path (sandboxed), http(s) URL, or base64 data URL. Formats: mp3, wav, flac, ogg, webm, mp4.',
+                            },
+                            model: {
+                                type: 'string',
+                                description: 'STT model. Default: openai/whisper-1. Also: openai/gpt-4o-transcribe, openai/gpt-4o-mini-transcribe.',
+                            },
+                            language: {
+                                type: 'string',
+                                description: 'ISO-639-1 language code (e.g. "en", "es", "fr"). Improves accuracy.',
+                            },
+                            response_format: {
+                                type: 'string',
+                                enum: ['json', 'text', 'srt', 'verbose_json', 'vtt'],
+                                description: 'Output format for transcription. Default: json.',
+                            },
+                            temperature: {
+                                type: 'number',
+                                minimum: 0,
+                                maximum: 1,
+                                description: 'Sampling temperature for transcription (0-1).',
+                            },
+                            cache: { type: 'boolean' },
+                            cache_ttl: { type: 'string' },
+                            cache_clear: { type: 'boolean' },
+                        },
+                        required: ['audio_path'],
+                    },
+                },
                 {
                     name: 'generate_video',
                     description: TOOL_DESCRIPTIONS.generate_video,
@@ -566,7 +788,10 @@ export class ToolHandlers {
                         ],
                     },
                 },
-            ],
+            ].map((tool) => ({
+                ...tool,
+                icons: TOOL_ICONS[tool.name],
+            })),
         }));
         server.setRequestHandler(CallToolRequestSchema, async (request) => {
             const { name, arguments: args } = request.params;
@@ -581,6 +806,10 @@ export class ToolHandlers {
                 switch (name) {
                     case 'chat_completion':
                         return handleChatCompletion(wrapToolArgs(args), this.openai, this.defaultModel);
+                    case 'start_chat_completion':
+                        return handleStartChatCompletion(wrapToolArgs(args), this.openai, this.defaultModel);
+                    case 'get_chat_completion_status':
+                        return handleGetChatCompletionStatus(wrapToolArgs(args));
                     case 'analyze_image':
                         return handleAnalyzeImage(wrapToolArgs(args), this.openai, this.defaultModel);
                     case 'analyze_audio':
@@ -595,8 +824,14 @@ export class ToolHandlers {
                         return handleValidateModel(wrapToolArgs(args), this.modelCache, this.apiClient);
                     case 'generate_image':
                         return handleGenerateImage(wrapToolArgs(args), this.openai);
+                    case 'generate_image_dedicated':
+                        return handleGenerateImageDedicated(wrapToolArgs(args), this.apiClient);
                     case 'generate_audio':
                         return handleGenerateAudio(wrapToolArgs(args), this.openai);
+                    case 'text_to_speech':
+                        return handleTextToSpeech(wrapToolArgs(args), this.apiClient);
+                    case 'speech_to_text':
+                        return handleSpeechToText(wrapToolArgs(args), this.apiClient);
                     case 'generate_video':
                         return handleGenerateVideo(wrapToolArgs(args), this.apiClient, buildProgressHook(this.server, extractProgressToken(request)));
                     case 'generate_video_from_image':

package/dist/tool-icons.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Tool icons for MCP 2025-11-25+ clients that render icons in the tool list.
+ * Each icon is a minimal SVG data URI — no external hosting needed.
+ *
+ * Clients that don't support icons simply ignore the `icons` field.
+ */
+export type ToolIcon = Array<{
+    src: string;
+    mimeType: string;
+    sizes: string[];
+}>;
+/** Map of tool name → icons array for use in tool definitions. */
+export declare const TOOL_ICONS: Record<string, ToolIcon>;
+/** Server icon for use in the Server initialization metadata. */
+export declare const SERVER_ICON: ToolIcon;

package/dist/tool-icons.js

@@ -0,0 +1,59 @@
+/**
+ * Tool icons for MCP 2025-11-25+ clients that render icons in the tool list.
+ * Each icon is a minimal SVG data URI — no external hosting needed.
+ *
+ * Clients that don't support icons simply ignore the `icons` field.
+ */
+/** Encode an SVG string as a data URI. */
+function svgDataUri(svg) {
+    return `data:image/svg+xml,${encodeURIComponent(svg.trim())}`;
+}
+// Minimal 24x24 SVG icons using simple shapes
+const ICONS = {
+    chat: svgDataUri(`<svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24" fill="none" stroke="#6366f1" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><path d="M21 15a2 2 0 0 1-2 2H7l-4 4V5a2 2 0 0 1 2-2h14a2 2 0 0 1 2 2z"/></svg>`),
+    chatAsync: svgDataUri(`<svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24" fill="none" stroke="#8b5cf6" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><path d="M21 15a2 2 0 0 1-2 2H7l-4 4V5a2 2 0 0 1 2-2h14a2 2 0 0 1 2 2z"/><circle cx="17" cy="7" r="3" fill="#8b5cf6"/></svg>`),
+    image: svgDataUri(`<svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24" fill="none" stroke="#10b981" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><rect x="3" y="3" width="18" height="18" rx="2"/><circle cx="8.5" cy="8.5" r="1.5"/><path d="m21 15-5-5L5 21"/></svg>`),
+    audio: svgDataUri(`<svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24" fill="none" stroke="#f59e0b" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><path d="M9 18V5l12-2v13"/><circle cx="6" cy="18" r="3"/><circle cx="18" cy="16" r="3"/></svg>`),
+    mic: svgDataUri(`<svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24" fill="none" stroke="#ef4444" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><path d="M12 2a3 3 0 0 0-3 3v7a3 3 0 0 0 6 0V5a3 3 0 0 0-3-3Z"/><path d="M19 10v2a7 7 0 0 1-14 0v-2"/><line x1="12" x2="12" y1="19" y2="22"/></svg>`),
+    video: svgDataUri(`<svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24" fill="none" stroke="#ec4899" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><path d="m22 8-6 4 6 4V8Z"/><rect x="2" y="6" width="14" height="12" rx="2"/></svg>`),
+    search: svgDataUri(`<svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24" fill="none" stroke="#06b6d4" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><circle cx="11" cy="11" r="8"/><path d="m21 21-4.3-4.3"/></svg>`),
+    info: svgDataUri(`<svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24" fill="none" stroke="#06b6d4" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><circle cx="12" cy="12" r="10"/><path d="M12 16v-4"/><path d="M12 8h.01"/></svg>`),
+    check: svgDataUri(`<svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24" fill="none" stroke="#22c55e" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><path d="M22 11.08V12a10 10 0 1 1-5.93-9.14"/><path d="m9 11 3 3L22 4"/></svg>`),
+    rerank: svgDataUri(`<svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24" fill="none" stroke="#a855f7" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><line x1="8" x2="21" y1="6" y2="6"/><line x1="8" x2="21" y1="12" y2="12"/><line x1="8" x2="21" y1="18" y2="18"/><line x1="3" x2="3.01" y1="6" y2="6"/><line x1="3" x2="3.01" y1="12" y2="12"/><line x1="3" x2="3.01" y1="18" y2="18"/></svg>`),
+    health: svgDataUri(`<svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24" fill="none" stroke="#22c55e" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><path d="M22 12h-4l-3 9L9 3l-3 9H2"/></svg>`),
+    speaker: svgDataUri(`<svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24" fill="none" stroke="#f97316" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><polygon points="11 5 6 9 2 9 2 15 6 15 11 19 11 5"/><path d="M15.54 8.46a5 5 0 0 1 0 7.07"/><path d="M19.07 4.93a10 10 0 0 1 0 14.14"/></svg>`),
+    poll: svgDataUri(`<svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24" fill="none" stroke="#64748b" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><path d="M12 2v4"/><path d="m16.2 7.8 2.9-2.9"/><path d="M18 12h4"/><path d="m16.2 16.2 2.9 2.9"/><path d="M12 18v4"/><path d="m4.9 19.1 2.9-2.9"/><path d="M2 12h4"/><path d="m4.9 4.9 2.9 2.9"/></svg>`),
+};
+function icon(src) {
+    return [{ src, mimeType: 'image/svg+xml', sizes: ['24x24'] }];
+}
+/** Map of tool name → icons array for use in tool definitions. */
+export const TOOL_ICONS = {
+    chat_completion: icon(ICONS.chat),
+    start_chat_completion: icon(ICONS.chatAsync),
+    get_chat_completion_status: icon(ICONS.poll),
+    analyze_image: icon(ICONS.image),
+    analyze_audio: icon(ICONS.audio),
+    analyze_video: icon(ICONS.video),
+    search_models: icon(ICONS.search),
+    get_model_info: icon(ICONS.info),
+    validate_model: icon(ICONS.check),
+    generate_image: icon(ICONS.image),
+    generate_image_dedicated: icon(ICONS.image),
+    generate_audio: icon(ICONS.audio),
+    text_to_speech: icon(ICONS.speaker),
+    speech_to_text: icon(ICONS.mic),
+    generate_video: icon(ICONS.video),
+    generate_video_from_image: icon(ICONS.video),
+    get_video_status: icon(ICONS.poll),
+    rerank_documents: icon(ICONS.rerank),
+    health_check: icon(ICONS.health),
+};
+/** Server icon for use in the Server initialization metadata. */
+export const SERVER_ICON = [
+    {
+        src: svgDataUri(`<svg xmlns="http://www.w3.org/2000/svg" width="48" height="48" viewBox="0 0 48 48" fill="none"><rect width="48" height="48" rx="12" fill="#1a1a2e"/><path d="M14 24h20M24 14v20" stroke="#6366f1" stroke-width="3" stroke-linecap="round"/><circle cx="24" cy="24" r="8" stroke="#22c55e" stroke-width="2"/><circle cx="24" cy="24" r="3" fill="#6366f1"/></svg>`),
+        mimeType: 'image/svg+xml',
+        sizes: ['48x48'],
+    },
+];

package/dist/version.d.ts

@@ -6,7 +6,7 @@
  * Bumped in lockstep with package.json / server.json / smithery.yaml /
  * scripts/build-manifest.mjs during release prep.
  */
-export declare const SERVER_VERSION = "4.5.3";
+export declare const SERVER_VERSION = "4.6.1";
 /**
  * MCP protocol version our SDK speaks. Hardcoded to match the version
  * bundled with `@modelcontextprotocol/sdk`; update when upgrading the

package/dist/version.js

@@ -6,7 +6,7 @@
  * Bumped in lockstep with package.json / server.json / smithery.yaml /
  * scripts/build-manifest.mjs during release prep.
  */
-export const SERVER_VERSION = '4.5.3';
+export const SERVER_VERSION = '4.6.1';
 /**
  * MCP protocol version our SDK speaks. Hardcoded to match the version
  * bundled with `@modelcontextprotocol/sdk`; update when upgrading the

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "@stabgan/openrouter-mcp-multimodal",
-  "version": "4.5.3",
+  "version": "4.6.1",
   "mcpName": "io.github.stabgan/openrouter-multimodal",
-  "description": "MCP server for OpenRouter with text chat, image analysis + generation, audio analysis + generation, video analysis, and video generation (Veo 3.1 / Sora 2 Pro / Seedance / Wan)",
+  "description": "MCP server for OpenRouter — chat with 300+ LLMs, analyze images/audio/video, generate images (dedicated API), TTS/STT, video generation (Veo 3.1 / Seedance / Wan), async completions, response caching",
   "type": "module",
   "main": "dist/index.js",
   "bin": {