@tinify-ai/mcp-server 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 One Punch Technology
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,202 @@
+# @tinify-ai/mcp-server
+
+[![npm version](https://img.shields.io/npm/v/@tinify-ai/mcp-server.svg)](https://www.npmjs.com/package/@tinify-ai/mcp-server)
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)
+[![MCP](https://img.shields.io/badge/MCP-Compatible-brightgreen.svg)](https://modelcontextprotocol.io)
+
+MCP server for [Tinify](https://tinify.ai) image optimization. One tool, max optimization.
+
+## Quick Start
+
+Add to your MCP client config:
+
+```json
+{
+  "mcpServers": {
+    "tinify": {
+      "command": "npx",
+      "args": ["-y", "@tinify-ai/mcp-server"]
+    }
+  }
+}
+```
+
+No signup required. Works out of the box with 20 free daily credits.
+
+### Client-Specific Setup
+
+<details>
+<summary><strong>Claude Desktop</strong></summary>
+
+Edit `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS) or `%APPDATA%\Claude\claude_desktop_config.json` (Windows):
+
+```json
+{
+  "mcpServers": {
+    "tinify": {
+      "command": "npx",
+      "args": ["-y", "@tinify-ai/mcp-server"]
+    }
+  }
+}
+```
+</details>
+
+<details>
+<summary><strong>Claude Code</strong></summary>
+
+```bash
+claude mcp add tinify -- npx -y @tinify-ai/mcp-server
+```
+</details>
+
+<details>
+<summary><strong>Cursor</strong></summary>
+
+Add to `.cursor/mcp.json` in your project root:
+
+```json
+{
+  "mcpServers": {
+    "tinify": {
+      "command": "npx",
+      "args": ["-y", "@tinify-ai/mcp-server"]
+    }
+  }
+}
+```
+</details>
+
+<details>
+<summary><strong>Windsurf</strong></summary>
+
+Edit `~/.codeium/windsurf/mcp_config.json`:
+
+```json
+{
+  "mcpServers": {
+    "tinify": {
+      "command": "npx",
+      "args": ["-y", "@tinify-ai/mcp-server"]
+    }
+  }
+}
+```
+</details>
+
+## Tool: `optimize_image`
+
+Optimizes an image with smart defaults: TinyPNG compression + SEO tag generation.
+
+### Parameters
+
+| Parameter | Type | Required | Default | Description |
+|-----------|------|----------|---------|-------------|
+| `input` | string | Yes | — | Local file path or remote URL |
+| `output_path` | string | No | auto | Where to save the result |
+| `output_format` | string | No | original | jpeg, png, webp, or original |
+| `output_width_px` | int | No | — | Target width in pixels |
+| `output_height_px` | int | No | — | Target height in pixels |
+| `output_upscale_factor` | float | No | — | Scale factor (2.0, 4.0) |
+| `output_resize_mode` | string | No | pad | pad or crop |
+| `output_aspect_lock` | bool | No | true | Maintain aspect ratio |
+| `output_seo_tag_gen` | bool | No | true | Generate SEO metadata |
+
+### Examples
+
+**Basic optimization:**
+> "Optimize hero.png"
+
+**Convert to WebP:**
+> "Optimize hero.png as webp"
+
+**Resize and optimize:**
+> "Optimize hero.png to 1920x1080"
+
+**Upscale a small image:**
+> "Upscale logo.png by 4x"
+
+**Save to specific path:**
+> "Optimize hero.png and save to ./dist/hero.webp"
+
+**Batch from URL:**
+> "Optimize https://example.com/photo.jpg"
+
+## Output
+
+Returns optimized file path and metadata:
+
+```
+Optimized: hero.tinified.webp
+Size: 142.3 KB
+Compression: 73%
+Format: webp
+Dimensions: 1920x1080
+Alt text: Modern office workspace with laptop and coffee cup on wooden desk
+```
+
+Structured metadata is also returned with `seo_keywords`, `seo_filename`, and full dimension/size data.
+
+## Supported Formats
+
+| Format | Input | Output |
+|--------|-------|--------|
+| JPEG | Yes | Yes |
+| PNG | Yes | Yes |
+| WebP | Yes | Yes |
+
+Max file size: 50 MB.
+
+## How It Works
+
+```
+Local file or URL
+  → Upload to Tinify API
+    → TinyPNG compression (smart lossy, typically 60-80% reduction)
+    → AI SEO tag generation (alt text, keywords, filename)
+    → Optional: resize, upscale, format conversion
+  → Download optimized file
+    → Save next to original as name.tinified.ext
+```
+
+All processing happens server-side via the [Tinify API](https://tinify.ai). The MCP server is a thin client that orchestrates the pipeline.
+
+## Credits
+
+| | Free Tier |
+|---|-----------|
+| Credits/day | 20 |
+| Images/day | 5 (with default settings) |
+| Cost per image | 4 credits (3 compression + 1 SEO tags) |
+| Signup required | No |
+
+Session tokens are stored locally at `~/.tinify/session.json` and persist across invocations.
+
+## Troubleshooting
+
+**Server not appearing in tool list:**
+- Restart your MCP client after editing the config
+- Ensure Node.js >= 18 is installed: `node --version`
+- Try running directly: `npx -y @tinify-ai/mcp-server` (should start without errors)
+
+**"Insufficient credits" error:**
+- Free tier allows 20 credits/day (resets daily)
+- Each image costs 4 credits with default settings
+- Disable SEO tags (`output_seo_tag_gen: false`) to reduce to 3 credits/image
+
+**File not found:**
+- Use absolute paths for local files
+- For URLs, ensure the image is publicly accessible
+
+**Timeout errors:**
+- Large images or AI upscaling can take 30-60 seconds
+- The server has a 60-second timeout per job
+
+## Requirements
+
+- Node.js >= 18
+- An MCP-compatible client (Claude Desktop, Claude Code, Cursor, Windsurf, Cline, etc.)
+
+## License
+
+MIT - see [LICENSE](LICENSE).

package/dist/api/client.d.ts

@@ -0,0 +1,11 @@
+export interface ClientConfig {
+    baseUrl: string;
+    sessionToken: string | null;
+}
+export declare const DEFAULT_BASE_URL = "https://api.tinify.ai";
+export declare class ApiError extends Error {
+    readonly status: number;
+    readonly detail?: string | undefined;
+    constructor(message: string, status: number, detail?: string | undefined);
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/api/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/api/client.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7B;AAED,eAAO,MAAM,gBAAgB,0BAA0B,CAAC;AAExD,qBAAa,QAAS,SAAQ,KAAK;aAGf,MAAM,EAAE,MAAM;aACd,MAAM,CAAC,EAAE,MAAM;gBAF/B,OAAO,EAAE,MAAM,EACC,MAAM,EAAE,MAAM,EACd,MAAM,CAAC,EAAE,MAAM,YAAA;CAKlC"}

package/dist/api/client.js

@@ -0,0 +1,12 @@
+export const DEFAULT_BASE_URL = "https://api.tinify.ai";
+export class ApiError extends Error {
+    status;
+    detail;
+    constructor(message, status, detail) {
+        super(message);
+        this.status = status;
+        this.detail = detail;
+        this.name = "ApiError";
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/api/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../../src/api/client.ts"],"names":[],"mappings":"AAKA,MAAM,CAAC,MAAM,gBAAgB,GAAG,uBAAuB,CAAC;AAExD,MAAM,OAAO,QAAS,SAAQ,KAAK;IAGf;IACA;IAHlB,YACE,OAAe,EACC,MAAc,EACd,MAAe;QAE/B,KAAK,CAAC,OAAO,CAAC,CAAC;QAHC,WAAM,GAAN,MAAM,CAAQ;QACd,WAAM,GAAN,MAAM,CAAS;QAG/B,IAAI,CAAC,IAAI,GAAG,UAAU,CAAC;IACzB,CAAC;CACF"}

package/dist/api/download.d.ts

@@ -0,0 +1,11 @@
+interface DownloadParams {
+    baseUrl: string;
+    jobId: string;
+}
+interface DownloadResult {
+    buffer: Buffer;
+    filename: string;
+}
+export declare function downloadFile(params: DownloadParams): Promise<DownloadResult>;
+export {};
+//# sourceMappingURL=download.d.ts.map

package/dist/api/download.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"download.d.ts","sourceRoot":"","sources":["../../src/api/download.ts"],"names":[],"mappings":"AAEA,UAAU,cAAc;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,UAAU,cAAc;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,wBAAsB,YAAY,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO,CAAC,cAAc,CAAC,CA2BlF"}

package/dist/api/download.js

@@ -0,0 +1,25 @@
+import { ApiError } from "./client.js";
+export async function downloadFile(params) {
+    const { baseUrl, jobId } = params;
+    const response = await fetch(`${baseUrl}/download/${jobId}`);
+    if (!response.ok) {
+        const body = await response.json().catch(() => ({}));
+        if (response.status === 410) {
+            throw new ApiError("Job has expired. Files are only available for a limited time.", 410);
+        }
+        if (response.status === 400) {
+            throw new ApiError("Job not completed yet.", 400);
+        }
+        if (response.status === 404) {
+            throw new ApiError("Job not found.", 404);
+        }
+        throw new ApiError(body.detail || "Download failed", response.status);
+    }
+    const arrayBuffer = await response.arrayBuffer();
+    const buffer = Buffer.from(arrayBuffer);
+    const disposition = response.headers.get("Content-Disposition") ?? "";
+    const filenameMatch = disposition.match(/filename="?([^";\s]+)"?/);
+    const filename = filenameMatch?.[1] ?? "output";
+    return { buffer, filename };
+}
+//# sourceMappingURL=download.js.map

package/dist/api/download.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"download.js","sourceRoot":"","sources":["../../src/api/download.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAYvC,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,MAAsB;IACvD,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,GAAG,MAAM,CAAC;IAElC,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,OAAO,aAAa,KAAK,EAAE,CAAC,CAAC;IAE7D,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;QACjB,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QACrD,IAAI,QAAQ,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;YAC5B,MAAM,IAAI,QAAQ,CAAC,+DAA+D,EAAE,GAAG,CAAC,CAAC;QAC3F,CAAC;QACD,IAAI,QAAQ,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;YAC5B,MAAM,IAAI,QAAQ,CAAC,wBAAwB,EAAE,GAAG,CAAC,CAAC;QACpD,CAAC;QACD,IAAI,QAAQ,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;YAC5B,MAAM,IAAI,QAAQ,CAAC,gBAAgB,EAAE,GAAG,CAAC,CAAC;QAC5C,CAAC;QACD,MAAM,IAAI,QAAQ,CAAC,IAAI,CAAC,MAAM,IAAI,iBAAiB,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;IACxE,CAAC;IAED,MAAM,WAAW,GAAG,MAAM,QAAQ,CAAC,WAAW,EAAE,CAAC;IACjD,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IAExC,MAAM,WAAW,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,qBAAqB,CAAC,IAAI,EAAE,CAAC;IACtE,MAAM,aAAa,GAAG,WAAW,CAAC,KAAK,CAAC,yBAAyB,CAAC,CAAC;IACnE,MAAM,QAAQ,GAAG,aAAa,EAAE,CAAC,CAAC,CAAC,IAAI,QAAQ,CAAC;IAEhD,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC;AAC9B,CAAC"}

package/dist/api/process.d.ts

@@ -0,0 +1,30 @@
+export interface ProcessingSettings {
+    output_format?: "original" | "jpeg" | "png" | "webp";
+    output_upscale_factor?: number;
+    output_width?: number;
+    output_height?: number;
+    output_aspect_lock?: boolean;
+    output_resize_mode?: "pad" | "crop";
+    output_seo_tag_gen?: boolean;
+    output_seo_rename?: boolean;
+}
+interface ProcessParams {
+    baseUrl: string;
+    tempFileIds: string[];
+    settings: ProcessingSettings;
+    sessionToken: string | null;
+}
+interface JobInfo {
+    id: string;
+    temp_file_id: string;
+    status: string;
+}
+export interface ProcessResult {
+    success: boolean;
+    jobs: JobInfo[];
+    credits_used: number;
+    credits_remaining: number;
+}
+export declare function triggerProcessing(params: ProcessParams): Promise<ProcessResult>;
+export {};
+//# sourceMappingURL=process.d.ts.map

package/dist/api/process.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"process.d.ts","sourceRoot":"","sources":["../../src/api/process.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,kBAAkB;IACjC,aAAa,CAAC,EAAE,UAAU,GAAG,MAAM,GAAG,KAAK,GAAG,MAAM,CAAC;IACrD,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,kBAAkB,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC;IACpC,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC7B;AAED,UAAU,aAAa;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,QAAQ,EAAE,kBAAkB,CAAC;IAC7B,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7B;AAED,UAAU,OAAO;IACf,EAAE,EAAE,MAAM,CAAC;IACX,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,EAAE,OAAO,EAAE,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;IACrB,iBAAiB,EAAE,MAAM,CAAC;CAC3B;AAED,wBAAsB,iBAAiB,CAAC,MAAM,EAAE,aAAa,GAAG,OAAO,CAAC,aAAa,CAAC,CAiCrF"}

package/dist/api/process.js

@@ -0,0 +1,28 @@
+import { ApiError } from "./client.js";
+export async function triggerProcessing(params) {
+    const { baseUrl, tempFileIds, settings, sessionToken } = params;
+    const headers = {
+        "Content-Type": "application/json",
+    };
+    if (sessionToken) {
+        headers["X-Session-Token"] = sessionToken;
+    }
+    const response = await fetch(`${baseUrl}/auto`, {
+        method: "POST",
+        headers,
+        body: JSON.stringify({
+            temp_file_ids: tempFileIds,
+            settings,
+        }),
+    });
+    if (!response.ok) {
+        const body = await response.json().catch(() => ({}));
+        if (response.status === 429) {
+            const remaining = response.headers.get("X-RateLimit-Remaining") ?? "0";
+            throw new ApiError(`Insufficient credits. ${remaining} of 20 daily credits left. ${body.detail ?? ""}`.trim(), 429, body.detail);
+        }
+        throw new ApiError(body.detail || "Processing failed", response.status, body.detail);
+    }
+    return response.json();
+}
+//# sourceMappingURL=process.js.map

package/dist/api/process.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"process.js","sourceRoot":"","sources":["../../src/api/process.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAiCvC,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,MAAqB;IAC3D,MAAM,EAAE,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,YAAY,EAAE,GAAG,MAAM,CAAC;IAEhE,MAAM,OAAO,GAA2B;QACtC,cAAc,EAAE,kBAAkB;KACnC,CAAC;IACF,IAAI,YAAY,EAAE,CAAC;QACjB,OAAO,CAAC,iBAAiB,CAAC,GAAG,YAAY,CAAC;IAC5C,CAAC;IAED,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,OAAO,OAAO,EAAE;QAC9C,MAAM,EAAE,MAAM;QACd,OAAO;QACP,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;YACnB,aAAa,EAAE,WAAW;YAC1B,QAAQ;SACT,CAAC;KACH,CAAC,CAAC;IAEH,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;QACjB,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QACrD,IAAI,QAAQ,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;YAC5B,MAAM,SAAS,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,uBAAuB,CAAC,IAAI,GAAG,CAAC;YACvE,MAAM,IAAI,QAAQ,CAChB,yBAAyB,SAAS,8BAA8B,IAAI,CAAC,MAAM,IAAI,EAAE,EAAE,CAAC,IAAI,EAAE,EAC1F,GAAG,EACH,IAAI,CAAC,MAAM,CACZ,CAAC;QACJ,CAAC;QACD,MAAM,IAAI,QAAQ,CAAC,IAAI,CAAC,MAAM,IAAI,mBAAmB,EAAE,QAAQ,CAAC,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;IACvF,CAAC;IAED,OAAO,QAAQ,CAAC,IAAI,EAAE,CAAC;AACzB,CAAC"}

package/dist/api/status.d.ts

@@ -0,0 +1,22 @@
+export interface CompletedJob {
+    job_id: string;
+    status: "completed" | "failed" | "expired";
+    processed_filename?: string | null;
+    processed_size?: number | null;
+    processed_format?: string | null;
+    processed_width?: number | null;
+    processed_height?: number | null;
+    processed_compression_ratio?: number | null;
+    seo_alt_text?: string | null;
+    seo_filename?: string | null;
+    seo_keywords?: string[] | null;
+    error?: string | null;
+}
+interface StatusParams {
+    baseUrl: string;
+    jobId: string;
+    timeoutMs?: number;
+}
+export declare function waitForCompletion(params: StatusParams): Promise<CompletedJob>;
+export {};
+//# sourceMappingURL=status.d.ts.map

package/dist/api/status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"status.d.ts","sourceRoot":"","sources":["../../src/api/status.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,WAAW,GAAG,QAAQ,GAAG,SAAS,CAAC;IAC3C,kBAAkB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,gBAAgB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,gBAAgB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,2BAA2B,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5C,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,YAAY,CAAC,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;IAC/B,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACvB;AAED,UAAU,YAAY;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,YAAY,CAAC,CAmD7E"}

package/dist/api/status.js

@@ -0,0 +1,36 @@
+import { ApiError } from "./client.js";
+import { EventSource as EventSourcePoly } from "eventsource";
+export function waitForCompletion(params) {
+    const { baseUrl, jobId, timeoutMs = 60000 } = params;
+    return new Promise((resolve, reject) => {
+        const ESConstructor = typeof EventSource !== "undefined" ? EventSource : EventSourcePoly;
+        const es = new ESConstructor(`${baseUrl}/status/${jobId}/stream`);
+        const timeout = setTimeout(() => {
+            es.close();
+            reject(new ApiError("Processing timed out after 60 seconds.", 504));
+        }, timeoutMs);
+        es.addEventListener("complete", (event) => {
+            clearTimeout(timeout);
+            es.close();
+            const data = JSON.parse(event.data);
+            if (data.status === "completed") {
+                resolve(data);
+            }
+            else {
+                reject(new ApiError(`Processing failed: ${data.error ?? "Unknown error"}`, 500, data.error ?? undefined));
+            }
+        });
+        es.addEventListener("error", (event) => {
+            clearTimeout(timeout);
+            es.close();
+            const data = event.data ? JSON.parse(event.data) : {};
+            reject(new ApiError(`Processing error: ${data.message ?? "Connection lost"}`, 500, data.message));
+        });
+        es.addEventListener("timeout", () => {
+            clearTimeout(timeout);
+            es.close();
+            reject(new ApiError("Processing timed out after 60 seconds.", 504));
+        });
+    });
+}
+//# sourceMappingURL=status.js.map

package/dist/api/status.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"status.js","sourceRoot":"","sources":["../../src/api/status.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACvC,OAAO,EAAE,WAAW,IAAI,eAAe,EAAE,MAAM,aAAa,CAAC;AAuB7D,MAAM,UAAU,iBAAiB,CAAC,MAAoB;IACpD,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,SAAS,GAAG,KAAK,EAAE,GAAG,MAAM,CAAC;IAErD,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACrC,MAAM,aAAa,GACjB,OAAO,WAAW,KAAK,WAAW,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAE,eAAuB,CAAC;QAC9E,MAAM,EAAE,GAAG,IAAI,aAAa,CAAC,GAAG,OAAO,WAAW,KAAK,SAAS,CAAC,CAAC;QAElE,MAAM,OAAO,GAAG,UAAU,CAAC,GAAG,EAAE;YAC9B,EAAE,CAAC,KAAK,EAAE,CAAC;YACX,MAAM,CAAC,IAAI,QAAQ,CAAC,wCAAwC,EAAE,GAAG,CAAC,CAAC,CAAC;QACtE,CAAC,EAAE,SAAS,CAAC,CAAC;QAEd,EAAE,CAAC,gBAAgB,CAAC,UAAU,EAAE,CAAC,KAAU,EAAE,EAAE;YAC7C,YAAY,CAAC,OAAO,CAAC,CAAC;YACtB,EAAE,CAAC,KAAK,EAAE,CAAC;YAEX,MAAM,IAAI,GAAiB,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YAElD,IAAI,IAAI,CAAC,MAAM,KAAK,WAAW,EAAE,CAAC;gBAChC,OAAO,CAAC,IAAI,CAAC,CAAC;YAChB,CAAC;iBAAM,CAAC;gBACN,MAAM,CACJ,IAAI,QAAQ,CACV,sBAAsB,IAAI,CAAC,KAAK,IAAI,eAAe,EAAE,EACrD,GAAG,EACH,IAAI,CAAC,KAAK,IAAI,SAAS,CACxB,CACF,CAAC;YACJ,CAAC;QACH,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,gBAAgB,CAAC,OAAO,EAAE,CAAC,KAAU,EAAE,EAAE;YAC1C,YAAY,CAAC,OAAO,CAAC,CAAC;YACtB,EAAE,CAAC,KAAK,EAAE,CAAC;YACX,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;YACtD,MAAM,CACJ,IAAI,QAAQ,CACV,qBAAqB,IAAI,CAAC,OAAO,IAAI,iBAAiB,EAAE,EACxD,GAAG,EACH,IAAI,CAAC,OAAO,CACb,CACF,CAAC;QACJ,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,gBAAgB,CAAC,SAAS,EAAE,GAAG,EAAE;YAClC,YAAY,CAAC,OAAO,CAAC,CAAC;YACtB,EAAE,CAAC,KAAK,EAAE,CAAC;YACX,MAAM,CAAC,IAAI,QAAQ,CAAC,wCAAwC,EAAE,GAAG,CAAC,CAAC,CAAC;QACtE,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/api/upload.d.ts

@@ -0,0 +1,16 @@
+interface UploadParams {
+    baseUrl: string;
+    fileBuffer: Buffer;
+    filename: string;
+    sessionToken: string | null;
+}
+interface UploadResult {
+    temp_file_id: string;
+    original_filename: string;
+    file_size: number;
+    mime_type: string;
+    session_token: string | null;
+}
+export declare function uploadFile(params: UploadParams): Promise<UploadResult>;
+export {};
+//# sourceMappingURL=upload.d.ts.map

package/dist/api/upload.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"upload.d.ts","sourceRoot":"","sources":["../../src/api/upload.ts"],"names":[],"mappings":"AAEA,UAAU,YAAY;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7B;AAED,UAAU,YAAY;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9B;AAED,wBAAsB,UAAU,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,YAAY,CAAC,CAyC5E"}

package/dist/api/upload.js

@@ -0,0 +1,27 @@
+import { ApiError } from "./client.js";
+export async function uploadFile(params) {
+    const { baseUrl, fileBuffer, filename, sessionToken } = params;
+    const formData = new FormData();
+    formData.append("file", new Blob([fileBuffer.buffer.slice(fileBuffer.byteOffset, fileBuffer.byteOffset + fileBuffer.byteLength)]), filename);
+    const headers = {};
+    if (sessionToken) {
+        headers["X-Session-Token"] = sessionToken;
+    }
+    const response = await fetch(`${baseUrl}/upload`, {
+        method: "POST",
+        headers,
+        body: formData,
+    });
+    if (!response.ok) {
+        const body = await response.json().catch(() => ({}));
+        if (response.status === 413) {
+            throw new ApiError("File exceeds maximum size limit.", response.status, body.detail);
+        }
+        if (response.status === 415 || body.detail?.includes("Unsupported")) {
+            throw new ApiError("Unsupported image format. Supported: JPEG, PNG, WebP, HEIC.", response.status, body.detail);
+        }
+        throw new ApiError(body.detail || "Upload failed", response.status, body.detail);
+    }
+    return response.json();
+}
+//# sourceMappingURL=upload.js.map

package/dist/api/upload.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"upload.js","sourceRoot":"","sources":["../../src/api/upload.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAiBvC,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,MAAoB;IACnD,MAAM,EAAE,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,YAAY,EAAE,GAAG,MAAM,CAAC;IAE/D,MAAM,QAAQ,GAAG,IAAI,QAAQ,EAAE,CAAC;IAChC,QAAQ,CAAC,MAAM,CACb,MAAM,EACN,IAAI,IAAI,CAAC,CAAC,UAAU,CAAC,MAAM,CAAC,KAAK,CAAC,UAAU,CAAC,UAAU,EAAE,UAAU,CAAC,UAAU,GAAG,UAAU,CAAC,UAAU,CAAgB,CAAC,CAAC,EACxH,QAAQ,CACT,CAAC;IAEF,MAAM,OAAO,GAA2B,EAAE,CAAC;IAC3C,IAAI,YAAY,EAAE,CAAC;QACjB,OAAO,CAAC,iBAAiB,CAAC,GAAG,YAAY,CAAC;IAC5C,CAAC;IAED,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,OAAO,SAAS,EAAE;QAChD,MAAM,EAAE,MAAM;QACd,OAAO;QACP,IAAI,EAAE,QAAQ;KACf,CAAC,CAAC;IAEH,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;QACjB,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QACrD,IAAI,QAAQ,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;YAC5B,MAAM,IAAI,QAAQ,CAAC,kCAAkC,EAAE,QAAQ,CAAC,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;QACvF,CAAC;QACD,IAAI,QAAQ,CAAC,MAAM,KAAK,GAAG,IAAI,IAAI,CAAC,MAAM,EAAE,QAAQ,CAAC,aAAa,CAAC,EAAE,CAAC;YACpE,MAAM,IAAI,QAAQ,CAChB,6DAA6D,EAC7D,QAAQ,CAAC,MAAM,EACf,IAAI,CAAC,MAAM,CACZ,CAAC;QACJ,CAAC;QACD,MAAM,IAAI,QAAQ,CAChB,IAAI,CAAC,MAAM,IAAI,eAAe,EAC9B,QAAQ,CAAC,MAAM,EACf,IAAI,CAAC,MAAM,CACZ,CAAC;IACJ,CAAC;IAED,OAAO,QAAQ,CAAC,IAAI,EAAE,CAAC;AACzB,CAAC"}

package/dist/errors.d.ts

@@ -0,0 +1,11 @@
+interface McpErrorResult {
+    [key: string]: unknown;
+    content: Array<{
+        type: "text";
+        text: string;
+    }>;
+    isError: true;
+}
+export declare function formatErrorForMcp(error: unknown): McpErrorResult;
+export {};
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAEA,UAAU,cAAc;IACtB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;IACvB,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC/C,OAAO,EAAE,IAAI,CAAC;CACf;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,cAAc,CAmBhE"}

package/dist/errors.js

@@ -0,0 +1,20 @@
+import { ApiError } from "./api/client.js";
+export function formatErrorForMcp(error) {
+    if (error instanceof ApiError) {
+        return {
+            content: [{ type: "text", text: error.message }],
+            isError: true,
+        };
+    }
+    if (error instanceof Error) {
+        return {
+            content: [{ type: "text", text: error.message }],
+            isError: true,
+        };
+    }
+    return {
+        content: [{ type: "text", text: "An unexpected error occurred." }],
+        isError: true,
+    };
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAQ3C,MAAM,UAAU,iBAAiB,CAAC,KAAc;IAC9C,IAAI,KAAK,YAAY,QAAQ,EAAE,CAAC;QAC9B,OAAO;YACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,CAAC,OAAO,EAAE,CAAC;YAChD,OAAO,EAAE,IAAI;SACd,CAAC;IACJ,CAAC;IAED,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;QAC3B,OAAO;YACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,CAAC,OAAO,EAAE,CAAC;YAChD,OAAO,EAAE,IAAI;SACd,CAAC;IACJ,CAAC;IAED,OAAO;QACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,+BAA+B,EAAE,CAAC;QAClE,OAAO,EAAE,IAAI;KACd,CAAC;AACJ,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}

package/dist/index.js

@@ -0,0 +1,108 @@
+#!/usr/bin/env node
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import * as z from "zod";
+import { optimizeImage } from "./tools/optimize.js";
+import { formatErrorForMcp } from "./errors.js";
+const server = new McpServer({
+    name: "tinify",
+    version: "1.0.0",
+});
+server.registerTool("optimize_image", {
+    title: "Optimize Image",
+    description: "Optimize an image with smart defaults: TinyPNG compression + SEO tag generation. " +
+        "Accepts local file paths or remote URLs. Returns the optimized file path and metadata.",
+    inputSchema: {
+        input: z
+            .string()
+            .describe("Local file path or remote URL of the image to optimize"),
+        output_path: z
+            .string()
+            .optional()
+            .describe("Where to save the optimized image. If omitted: local files save next to the original " +
+            "with a .tinified suffix, URLs save to the current working directory."),
+        output_format: z
+            .enum(["original", "jpeg", "png", "webp"])
+            .optional()
+            .describe("Output format. Defaults to 'original' (keep input format)."),
+        output_width_px: z
+            .number()
+            .int()
+            .positive()
+            .optional()
+            .describe("Target width in pixels. Triggers resize."),
+        output_height_px: z
+            .number()
+            .int()
+            .positive()
+            .optional()
+            .describe("Target height in pixels. Triggers resize."),
+        output_upscale_factor: z
+            .number()
+            .min(0.1)
+            .max(10)
+            .optional()
+            .describe("Upscale factor (e.g., 2.0 for 2x, 4.0 for 4x). Triggers AI upscaling."),
+        output_resize_mode: z
+            .enum(["pad", "crop"])
+            .optional()
+            .describe("Resize mode when aspect ratio changes. 'pad' adds white padding, 'crop' uses smart cropping. Default: 'pad'."),
+        output_aspect_lock: z
+            .boolean()
+            .optional()
+            .describe("Maintain aspect ratio during resize. Default: true."),
+        output_seo_tag_gen: z
+            .boolean()
+            .optional()
+            .describe("Generate SEO metadata (alt text, keywords, filename). Default: true."),
+    },
+    outputSchema: {
+        output_path: z.string(),
+        output_size_bytes: z.number(),
+        output_width_px: z.number().nullable(),
+        output_height_px: z.number().nullable(),
+        output_format: z.string().nullable(),
+        compression_ratio: z.number().nullable(),
+        seo_alt_text: z.string().nullable(),
+        seo_keywords: z.array(z.string()).nullable(),
+        seo_filename: z.string().nullable(),
+    },
+}, async (params) => {
+    try {
+        const result = await optimizeImage({
+            input: params.input,
+            output_path: params.output_path,
+            output_format: params.output_format,
+            output_width_px: params.output_width_px,
+            output_height_px: params.output_height_px,
+            output_upscale_factor: params.output_upscale_factor,
+            output_resize_mode: params.output_resize_mode,
+            output_aspect_lock: params.output_aspect_lock,
+            output_seo_tag_gen: params.output_seo_tag_gen,
+        });
+        const summary = [
+            `Optimized: ${result.output_path}`,
+            `Size: ${(result.output_size_bytes / 1024).toFixed(1)} KB`,
+            result.compression_ratio !== null
+                ? `Compression: ${(result.compression_ratio * 100).toFixed(0)}%`
+                : null,
+            result.output_format ? `Format: ${result.output_format}` : null,
+            result.output_width_px && result.output_height_px
+                ? `Dimensions: ${result.output_width_px}x${result.output_height_px}`
+                : null,
+            result.seo_alt_text ? `Alt text: ${result.seo_alt_text}` : null,
+        ]
+            .filter(Boolean)
+            .join("\n");
+        return {
+            content: [{ type: "text", text: summary }],
+            structuredContent: result,
+        };
+    }
+    catch (error) {
+        return formatErrorForMcp(error);
+    }
+});
+const transport = new StdioServerTransport();
+await server.connect(transport);
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/session/manager.d.ts

@@ -0,0 +1,8 @@
+export declare class SessionManager {
+    readonly sessionDir: string;
+    private readonly sessionFile;
+    constructor(sessionDir?: string);
+    getToken(): string | null;
+    saveToken(token: string): void;
+}
+//# sourceMappingURL=manager.d.ts.map

package/dist/session/manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manager.d.ts","sourceRoot":"","sources":["../../src/session/manager.ts"],"names":[],"mappings":"AAQA,qBAAa,cAAc;IACzB,SAAgB,UAAU,EAAE,MAAM,CAAC;IACnC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;gBAEzB,UAAU,CAAC,EAAE,MAAM;IAK/B,QAAQ,IAAI,MAAM,GAAG,IAAI;IAUzB,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;CAK/B"}

package/dist/session/manager.js

@@ -0,0 +1,27 @@
+import * as fs from "node:fs";
+import * as path from "node:path";
+import * as os from "node:os";
+export class SessionManager {
+    sessionDir;
+    sessionFile;
+    constructor(sessionDir) {
+        this.sessionDir = sessionDir ?? path.join(os.homedir(), ".tinify");
+        this.sessionFile = path.join(this.sessionDir, "session.json");
+    }
+    getToken() {
+        try {
+            const raw = fs.readFileSync(this.sessionFile, "utf-8");
+            const data = JSON.parse(raw);
+            return data.session_token ?? null;
+        }
+        catch {
+            return null;
+        }
+    }
+    saveToken(token) {
+        fs.mkdirSync(this.sessionDir, { recursive: true });
+        const data = { session_token: token };
+        fs.writeFileSync(this.sessionFile, JSON.stringify(data, null, 2));
+    }
+}
+//# sourceMappingURL=manager.js.map

package/dist/session/manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"manager.js","sourceRoot":"","sources":["../../src/session/manager.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAClC,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAM9B,MAAM,OAAO,cAAc;IACT,UAAU,CAAS;IAClB,WAAW,CAAS;IAErC,YAAY,UAAmB;QAC7B,IAAI,CAAC,UAAU,GAAG,UAAU,IAAI,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,SAAS,CAAC,CAAC;QACnE,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,cAAc,CAAC,CAAC;IAChE,CAAC;IAED,QAAQ;QACN,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;YACvD,MAAM,IAAI,GAAgB,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;YAC1C,OAAO,IAAI,CAAC,aAAa,IAAI,IAAI,CAAC;QACpC,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IAED,SAAS,CAAC,KAAa;QACrB,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,UAAU,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACnD,MAAM,IAAI,GAAgB,EAAE,aAAa,EAAE,KAAK,EAAE,CAAC;QACnD,EAAE,CAAC,aAAa,CAAC,IAAI,CAAC,WAAW,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;IACpE,CAAC;CACF"}

package/dist/tools/optimize.d.ts

@@ -0,0 +1,27 @@
+export interface OptimizeImageParams {
+    input: string;
+    output_path?: string;
+    output_format?: "original" | "jpeg" | "png" | "webp";
+    output_width_px?: number;
+    output_height_px?: number;
+    output_upscale_factor?: number;
+    output_resize_mode?: "pad" | "crop";
+    output_aspect_lock?: boolean;
+    output_seo_tag_gen?: boolean;
+    baseUrl?: string;
+    timeoutMs?: number;
+}
+export interface OptimizeImageResult {
+    [key: string]: unknown;
+    output_path: string;
+    output_size_bytes: number;
+    output_width_px: number | null;
+    output_height_px: number | null;
+    output_format: string | null;
+    compression_ratio: number | null;
+    seo_alt_text: string | null;
+    seo_keywords: string[] | null;
+    seo_filename: string | null;
+}
+export declare function optimizeImage(params: OptimizeImageParams): Promise<OptimizeImageResult>;
+//# sourceMappingURL=optimize.d.ts.map

package/dist/tools/optimize.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"optimize.d.ts","sourceRoot":"","sources":["../../src/tools/optimize.ts"],"names":[],"mappings":"AAWA,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,aAAa,CAAC,EAAE,UAAU,GAAG,MAAM,GAAG,KAAK,GAAG,MAAM,CAAC;IACrD,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,kBAAkB,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC;IACpC,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,mBAAmB;IAClC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,YAAY,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;IAC9B,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7B;AAED,wBAAsB,aAAa,CACjC,MAAM,EAAE,mBAAmB,GAC1B,OAAO,CAAC,mBAAmB,CAAC,CA8F9B"}

package/dist/tools/optimize.js

@@ -0,0 +1,93 @@
+import * as fs from "node:fs";
+import * as path from "node:path";
+import { uploadFile } from "../api/upload.js";
+import { triggerProcessing } from "../api/process.js";
+import { waitForCompletion } from "../api/status.js";
+import { downloadFile } from "../api/download.js";
+import { resolveInput } from "../utils/input.js";
+import { resolveOutputPath } from "../utils/output.js";
+import { SessionManager } from "../session/manager.js";
+import { DEFAULT_BASE_URL } from "../api/client.js";
+export async function optimizeImage(params) {
+    const baseUrl = params.baseUrl ?? DEFAULT_BASE_URL;
+    const sessionManager = new SessionManager();
+    // 1. Resolve input (read file or fetch URL)
+    const input = await resolveInput(params.input);
+    // 2. Upload to backend
+    const sessionToken = sessionManager.getToken();
+    const uploadResult = await uploadFile({
+        baseUrl,
+        fileBuffer: input.buffer,
+        filename: input.filename,
+        sessionToken,
+    });
+    // Persist new session token if returned
+    if (uploadResult.session_token) {
+        sessionManager.saveToken(uploadResult.session_token);
+    }
+    const currentToken = uploadResult.session_token ?? sessionToken;
+    // 3. Build settings (smart defaults: compress always, SEO tags on)
+    const settings = {
+        output_format: params.output_format ?? "original",
+        output_seo_tag_gen: params.output_seo_tag_gen ?? true,
+        output_seo_rename: false,
+    };
+    if (params.output_width_px !== undefined) {
+        settings.output_width = params.output_width_px;
+    }
+    if (params.output_height_px !== undefined) {
+        settings.output_height = params.output_height_px;
+    }
+    if (params.output_upscale_factor !== undefined) {
+        settings.output_upscale_factor = params.output_upscale_factor;
+    }
+    if (params.output_resize_mode !== undefined) {
+        settings.output_resize_mode = params.output_resize_mode;
+    }
+    if (params.output_aspect_lock !== undefined) {
+        settings.output_aspect_lock = params.output_aspect_lock;
+    }
+    // 4. Trigger processing
+    const processResult = await triggerProcessing({
+        baseUrl,
+        tempFileIds: [uploadResult.temp_file_id],
+        settings,
+        sessionToken: currentToken,
+    });
+    const job = processResult.jobs[0];
+    if (!job?.id) {
+        throw new Error("No job created by the server.");
+    }
+    // 5. Wait for completion via SSE
+    const completedJob = await waitForCompletion({
+        baseUrl,
+        jobId: job.id,
+        timeoutMs: params.timeoutMs ?? 60000,
+    });
+    // 6. Download processed file
+    const downloadResult = await downloadFile({ baseUrl, jobId: job.id });
+    // 7. Resolve output path and save
+    const outputPath = resolveOutputPath({
+        inputPath: params.input,
+        isUrl: input.isUrl,
+        filename: input.filename,
+        outputPath: params.output_path,
+        outputFormat: params.output_format && params.output_format !== "original"
+            ? params.output_format
+            : completedJob.processed_format ?? undefined,
+    });
+    fs.mkdirSync(path.dirname(outputPath), { recursive: true });
+    fs.writeFileSync(outputPath, downloadResult.buffer);
+    return {
+        output_path: outputPath,
+        output_size_bytes: completedJob.processed_size ?? downloadResult.buffer.length,
+        output_width_px: completedJob.processed_width ?? null,
+        output_height_px: completedJob.processed_height ?? null,
+        output_format: completedJob.processed_format ?? null,
+        compression_ratio: completedJob.processed_compression_ratio ?? null,
+        seo_alt_text: completedJob.seo_alt_text ?? null,
+        seo_keywords: completedJob.seo_keywords ?? null,
+        seo_filename: completedJob.seo_filename ?? null,
+    };
+}
+//# sourceMappingURL=optimize.js.map

package/dist/tools/optimize.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"optimize.js","sourceRoot":"","sources":["../../src/tools/optimize.ts"],"names":[],"mappings":"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"}

package/dist/utils/input.d.ts

@@ -0,0 +1,8 @@
+export interface ResolvedInput {
+    buffer: Buffer;
+    filename: string;
+    isUrl: boolean;
+}
+export declare function isUrl(input: string): boolean;
+export declare function resolveInput(input: string): Promise<ResolvedInput>;
+//# sourceMappingURL=input.d.ts.map

package/dist/utils/input.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"input.d.ts","sourceRoot":"","sources":["../../src/utils/input.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,OAAO,CAAC;CAChB;AAED,wBAAgB,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAE5C;AAeD,wBAAsB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CAwBxE"}

package/dist/utils/input.js

@@ -0,0 +1,42 @@
+import * as fs from "node:fs";
+import * as path from "node:path";
+export function isUrl(input) {
+    return input.startsWith("http://") || input.startsWith("https://");
+}
+function extractFilenameFromUrl(url) {
+    try {
+        const pathname = new URL(url).pathname;
+        const basename = path.basename(pathname);
+        if (basename && path.extname(basename)) {
+            return basename;
+        }
+        return "image";
+    }
+    catch {
+        return "image";
+    }
+}
+export async function resolveInput(input) {
+    if (isUrl(input)) {
+        const response = await fetch(input);
+        if (!response.ok) {
+            throw new Error(`Failed to fetch URL: ${input} (HTTP ${response.status})`);
+        }
+        const arrayBuffer = await response.arrayBuffer();
+        return {
+            buffer: Buffer.from(arrayBuffer),
+            filename: extractFilenameFromUrl(input),
+            isUrl: true,
+        };
+    }
+    const absolutePath = path.resolve(input);
+    if (!fs.existsSync(absolutePath)) {
+        throw new Error(`File not found: ${absolutePath}`);
+    }
+    return {
+        buffer: fs.readFileSync(absolutePath),
+        filename: path.basename(absolutePath),
+        isUrl: false,
+    };
+}
+//# sourceMappingURL=input.js.map

package/dist/utils/input.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"input.js","sourceRoot":"","sources":["../../src/utils/input.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAQlC,MAAM,UAAU,KAAK,CAAC,KAAa;IACjC,OAAO,KAAK,CAAC,UAAU,CAAC,SAAS,CAAC,IAAI,KAAK,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC;AACrE,CAAC;AAED,SAAS,sBAAsB,CAAC,GAAW;IACzC,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC;QACvC,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;QACzC,IAAI,QAAQ,IAAI,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;YACvC,OAAO,QAAQ,CAAC;QAClB,CAAC;QACD,OAAO,OAAO,CAAC;IACjB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,OAAO,CAAC;IACjB,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,KAAa;IAC9C,IAAI,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC;QACjB,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,KAAK,CAAC,CAAC;QACpC,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjB,MAAM,IAAI,KAAK,CAAC,wBAAwB,KAAK,UAAU,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC;QAC7E,CAAC;QACD,MAAM,WAAW,GAAG,MAAM,QAAQ,CAAC,WAAW,EAAE,CAAC;QACjD,OAAO;YACL,MAAM,EAAE,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC;YAChC,QAAQ,EAAE,sBAAsB,CAAC,KAAK,CAAC;YACvC,KAAK,EAAE,IAAI;SACZ,CAAC;IACJ,CAAC;IAED,MAAM,YAAY,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IACzC,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC;QACjC,MAAM,IAAI,KAAK,CAAC,mBAAmB,YAAY,EAAE,CAAC,CAAC;IACrD,CAAC;IAED,OAAO;QACL,MAAM,EAAE,EAAE,CAAC,YAAY,CAAC,YAAY,CAAC;QACrC,QAAQ,EAAE,IAAI,CAAC,QAAQ,CAAC,YAAY,CAAC;QACrC,KAAK,EAAE,KAAK;KACb,CAAC;AACJ,CAAC"}

package/dist/utils/output.d.ts

@@ -0,0 +1,11 @@
+interface OutputPathParams {
+    inputPath: string;
+    isUrl: boolean;
+    filename: string;
+    outputPath: string | undefined;
+    outputFormat: string | undefined;
+    cwd?: string;
+}
+export declare function resolveOutputPath(params: OutputPathParams): string;
+export {};
+//# sourceMappingURL=output.d.ts.map

package/dist/utils/output.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"output.d.ts","sourceRoot":"","sources":["../../src/utils/output.ts"],"names":[],"mappings":"AAEA,UAAU,gBAAgB;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,OAAO,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/B,YAAY,EAAE,MAAM,GAAG,SAAS,CAAC;IACjC,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAuBD,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,gBAAgB,GAAG,MAAM,CAoBlE"}

package/dist/utils/output.js

@@ -0,0 +1,33 @@
+import * as path from "node:path";
+function getTinifiedFilename(filename, outputFormat) {
+    const ext = path.extname(filename);
+    const name = path.basename(filename, ext);
+    let newExt;
+    if (!outputFormat || outputFormat === "original") {
+        newExt = ext || ".png";
+    }
+    else {
+        newExt = `.${outputFormat}`;
+    }
+    return `${name}.tinified${newExt}`;
+}
+function isDirectoryPath(p) {
+    return p.endsWith("/") || p.endsWith(path.sep);
+}
+export function resolveOutputPath(params) {
+    const { inputPath, isUrl, filename, outputPath, outputFormat, cwd } = params;
+    if (outputPath && !isDirectoryPath(outputPath)) {
+        return path.resolve(outputPath);
+    }
+    const tinifiedName = getTinifiedFilename(filename, outputFormat);
+    if (outputPath && isDirectoryPath(outputPath)) {
+        return path.join(path.resolve(outputPath), tinifiedName);
+    }
+    if (isUrl) {
+        const baseDir = cwd ?? process.cwd();
+        return path.join(baseDir, tinifiedName);
+    }
+    const inputDir = path.dirname(path.resolve(inputPath));
+    return path.join(inputDir, tinifiedName);
+}
+//# sourceMappingURL=output.js.map

package/dist/utils/output.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"output.js","sourceRoot":"","sources":["../../src/utils/output.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAWlC,SAAS,mBAAmB,CAC1B,QAAgB,EAChB,YAAgC;IAEhC,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IACnC,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;IAE1C,IAAI,MAAc,CAAC;IACnB,IAAI,CAAC,YAAY,IAAI,YAAY,KAAK,UAAU,EAAE,CAAC;QACjD,MAAM,GAAG,GAAG,IAAI,MAAM,CAAC;IACzB,CAAC;SAAM,CAAC;QACN,MAAM,GAAG,IAAI,YAAY,EAAE,CAAC;IAC9B,CAAC;IAED,OAAO,GAAG,IAAI,YAAY,MAAM,EAAE,CAAC;AACrC,CAAC;AAED,SAAS,eAAe,CAAC,CAAS;IAChC,OAAO,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACjD,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,MAAwB;IACxD,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,QAAQ,EAAE,UAAU,EAAE,YAAY,EAAE,GAAG,EAAE,GAAG,MAAM,CAAC;IAE7E,IAAI,UAAU,IAAI,CAAC,eAAe,CAAC,UAAU,CAAC,EAAE,CAAC;QAC/C,OAAO,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;IAClC,CAAC;IAED,MAAM,YAAY,GAAG,mBAAmB,CAAC,QAAQ,EAAE,YAAY,CAAC,CAAC;IAEjE,IAAI,UAAU,IAAI,eAAe,CAAC,UAAU,CAAC,EAAE,CAAC;QAC9C,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,YAAY,CAAC,CAAC;IAC3D,CAAC;IAED,IAAI,KAAK,EAAE,CAAC;QACV,MAAM,OAAO,GAAG,GAAG,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;QACrC,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC;IAC1C,CAAC;IAED,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC;IACvD,OAAO,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,YAAY,CAAC,CAAC;AAC3C,CAAC"}

package/package.json

@@ -0,0 +1,54 @@
+{
+  "name": "@tinify-ai/mcp-server",
+  "version": "1.0.0",
+  "description": "MCP server for Tinify image optimization — one tool, max optimization",
+  "type": "module",
+  "bin": {
+    "tinify-ai-mcp-server": "dist/index.js"
+  },
+  "main": "dist/index.js",
+  "files": [
+    "dist",
+    "LICENSE"
+  ],
+  "scripts": {
+    "dev": "tsx src/index.ts",
+    "build": "tsc",
+    "start": "node dist/index.js",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "typecheck": "tsc --noEmit",
+    "prepublishOnly": "npm run test && npm run build"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "tinify-ai",
+    "image-optimization",
+    "compression",
+    "seo",
+    "tinypng"
+  ],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/onepunchtechnology/tinify-ai-mcp-server"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.12.1",
+    "eventsource": "^3.0.6",
+    "zod": "^3.25.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "tsx": "^4.19.0",
+    "typescript": "^5.9.3",
+    "vitest": "^3.1.0"
+  },
+  "engines": {
+    "node": ">=18"
+  }
+}