[{"_1":2,"_3":-5,"_4":-5},"loaderData",{"_5":6,"_7":8,"_9":10},"actionData","errors","root",{"_104":105},"routes/modules.$creator.$moduleId",{"_14":15,"_16":17,"_18":19,"_20":21},"routes/modules.$creator.$moduleId.endpoints",{"_11":12,"_13":-5},"error","Module '@onepunchtechnology/tinify-ai-mcp-server' is not configured","tools","module",{"_20":22,"_23":24,"_25":26,"_27":28,"_29":30,"_31":32,"_33":26,"_34":-5,"_35":36,"_37":-5,"_38":-5,"_39":40,"_41":42,"_43":44,"_45":46,"_47":48,"_49":50,"_51":52,"_53":54,"_55":48,"_56":57,"_58":59,"_60":-5,"_61":-5,"_62":-5,"_63":-5,"_64":65,"_66":67,"_68":69,"_70":71,"_72":73,"_74":-5,"_75":-5,"_76":-5,"_77":48,"_78":-5,"_79":80,"_81":82,"_83":84,"_85":86,"_87":88,"_89":90,"_91":92},"apiUrl","https://odel.app/api","creator","onepunchtechnology","moduleId","tinify-ai-mcp-server","@onepunchtechnology/tinify-ai-mcp-server","displayName","tinify ai mcp server","tagline","MCP server for Tinify image optimization — one tool, max optimization","iconKey","https://avatars.githubusercontent.com/u/104278195?v=4","category","dev-tools","status","published","metaDescription","metaKeywords","deploymentType","external","workerName","bindingName","mcpConfig","{\"url\":\"https://app.tinify.ai/mcp\",\"transport\":\"streamable-http\",\"authType\":\"none\"}","pricingModel","free","creatorUserId","system:external-import","createdAt",1781363513000,"updatedAt",1781499757000,"sourceRegistry","official-mcp-registry","sourceUrl","https://registry.modelcontextprotocol.io/v0/servers?search=io.github.onepunchtechnology%2Ftinify-ai","sourceVerified",true,"importedAt","upstreamStars",2,"upstreamUpdatedAt",1779979031000,"detectedTransport","detectedAuthType","probeStatus","lastProbedAt","githubRepoUrl","https://github.com/onepunchtechnology/tinify-ai-mcp-server","githubRepoFullName","onepunchtechnology/tinify-ai-mcp-server","releaseId","ext-onepunchtechnology-tinify-ai-mcp-server","version","1.4.3","descriptionMarkdown","# @tinify-ai/mcp-server\n\n[![npm version](https://img.shields.io/npm/v/@tinify-ai/mcp-server.svg)](https://www.npmjs.com/package/@tinify-ai/mcp-server)\n[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)\n[![MCP](https://img.shields.io/badge/MCP-Compatible-brightgreen.svg)](https://modelcontextprotocol.io)\n\nMCP server for [tinify.ai](https://tinify.ai) image optimization. AI-powered upscaling, resizing/cropping, compression, and SEO filename & alt text generation — all in one tool.\n\n## Quick Start\n\nAdd to your MCP client config:\n\n```json\n{\n \"mcpServers\": {\n \"tinify\": {\n \"command\": \"npx\",\n \"args\": [\"-y\", \"@tinify-ai/mcp-server@latest\"]\n }\n }\n}\n```\n\nNo signup required. Works out of the box with 20 free daily credits.\n\n### Client-Specific Setup\n\n

Claude Desktop

\n\nEdit `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS) or `%APPDATA%\\Claude\\claude_desktop_config.json` (Windows):\n\n```json\n{\n \"mcpServers\": {\n \"tinify\": {\n \"command\": \"npx\",\n \"args\": [\"-y\", \"@tinify-ai/mcp-server@latest\"]\n }\n }\n}\n```\n

\n\n

Claude Code

\n\n```bash\nclaude mcp add tinify -- npx -y @tinify-ai/mcp-server@latest\n```\n

\n\n

Cursor

\n\nAdd to `.cursor/mcp.json` in your project root:\n\n```json\n{\n \"mcpServers\": {\n \"tinify\": {\n \"command\": \"npx\",\n \"args\": [\"-y\", \"@tinify-ai/mcp-server@latest\"]\n }\n }\n}\n```\n

\n\n

Windsurf

\n\nEdit `~/.codeium/windsurf/mcp_config.json`:\n\n```json\n{\n \"mcpServers\": {\n \"tinify\": {\n \"command\": \"npx\",\n \"args\": [\"-y\", \"@tinify-ai/mcp-server@latest\"]\n }\n }\n}\n```\n

\n\n

Cline

\n\nOpen Cline settings → MCP Servers → Add, then paste:\n\n```json\n{\n \"mcpServers\": {\n \"tinify\": {\n \"command\": \"npx\",\n \"args\": [\"-y\", \"@tinify-ai/mcp-server@latest\"]\n }\n }\n}\n```\n

\n\n

Gemini CLI

\n\n```bash\ngemini mcp add --transport stdio tinify npx -y @tinify-ai/mcp-server@latest\n```\n\nOr edit `~/.gemini/settings.json` (global) or `.gemini/settings.json` in your project root:\n\n```json\n{\n \"mcpServers\": {\n \"tinify\": {\n \"command\": \"npx\",\n \"args\": [\"-y\", \"@tinify-ai/mcp-server@latest\"]\n }\n }\n}\n```\n\nVerify it's running inside Gemini CLI with `/mcp list`.\n

\n\n

OpenAI Codex CLI

\n\n```bash\ncodex mcp add tinify -- npx -y @tinify-ai/mcp-server@latest\n```\n\nOr edit `~/.codex/config.toml` manually:\n\n```toml\n[mcp_servers.tinify]\ncommand = \"npx\"\nargs = [\"-y\", \"@tinify-ai/mcp-server@latest\"]\n```\n

\n\n## Tool: `optimize_image`\n\nOptimizes an image with smart lossy compression (typically 60-80% size reduction), optional resize/upscale/format conversion, and AI-generated SEO metadata. Accepts absolute local file paths or remote URLs.\n\n### Parameters\n\n| Parameter | Type | Required | Default | Description |\n|-----------|------|----------|---------|-------------|\n| `input` | string | Yes | — | Absolute local file path or remote URL |\n| `output_path` | string | No | auto | File path or directory (ending in `/`). If omitted: saves next to original with SEO slug or `.tinified` suffix |\n| `output_format` | string | No | original | `jpg`, `png`, `webp`, `avif`, `gif`, or `original` |\n| `output_width_px` | int | No | — | Target width in pixels |\n| `output_height_px` | int | No | — | Target height in pixels |\n| `output_upscale_factor` | int | No | — | AI upscale factor: `2` (2×) or `4` (4×) |\n| `output_resize_behavior` | string | No | pad | `pad` (white padding) or `crop` (smart crop). Only used when both width and height are set |\n| `output_seo_tag_gen` | bool | No | true | Generate SEO metadata and rename file to SEO slug. Costs 1 extra credit |\n| `output_file_size_limit` | int | No | — | Target maximum output file size in bytes. Server attempts to meet this via additional compression. Not guaranteed |\n| `gif_frame_limit` | int | No | 100 | Max frames to process for animated GIFs (1–100). Reduces credit cost by sampling fewer frames |\n| `confirm_gif_cost` | bool | No | — | Set to `true` to proceed after reviewing the animated GIF cost warning. Required for animated GIFs |\n\n### Resize Behavior\n\n| Dimensions provided | Behavior | `output_resize_behavior` |\n|---|---|---|\n| Width only | Proportional scale | N/A |\n| Height only | Proportional scale | N/A |\n| Width + Height | Exact dimensions, white padding | `pad` (default) |\n| Width + Height | Exact dimensions, smart crop | `crop` |\n\n### Examples\n\n**Basic compression** — just compress, keep format and dimensions:\n\n```json\n{ \"input\": \"/Users/me/photos/hero.png\" }\n```\n\n**Convert to WebP:**\n\n```json\n{ \"input\": \"/Users/me/hero.png\", \"output_format\": \"webp\" }\n```\n\n**Resize proportionally** — set one dimension, the other scales:\n\n```json\n{ \"input\": \"/Users/me/hero.png\", \"output_width_px\": 1200 }\n```\n\n**Exact dimensions with padding** — white bars fill the gap:\n\n```json\n{ \"input\": \"/Users/me/hero.png\", \"output_width_px\": 1080, \"output_height_px\": 1080 }\n```\n\n**Exact dimensions with smart crop:**\n\n```json\n{ \"input\": \"/Users/me/hero.png\", \"output_width_px\": 1080, \"output_height_px\": 1080, \"output_resize_behavior\": \"crop\" }\n```\n\n**AI upscale 4x:**\n\n```json\n{ \"input\": \"/Users/me/icon.png\", \"output_upscale_factor\": 4 }\n```\n\n**From URL, save to directory:**\n\n```json\n{ \"input\": \"https://example.com/photo.jpg\", \"output_path\": \"/Users/me/assets/\" }\n```\n\n**Skip SEO to save 1 credit:**\n\n```json\n{ \"input\": \"/Users/me/hero.png\", \"output_seo_tag_gen\": false }\n```\n\n### Output\n\nReturns a text summary and structured metadata:\n\n```\nOptimized: /Users/me/photos/modern-office-workspace.webp\nSize: 142.3 KB\nCompression: 73%\nFormat: webp\nDimensions: 1920x1080\nAlt text: Modern office workspace with laptop and coffee cup on wooden desk\n```\n\n**Structured output fields:**\n\n```json\n{\n \"output_path\": \"/Users/me/photos/modern-office-workspace.webp\",\n \"output_size_bytes\": 145715,\n \"output_width_px\": 1920,\n \"output_height_px\": 1080,\n \"output_format\": \"webp\",\n \"compression_ratio\": 0.27,\n \"seo_alt_text\": \"Modern office workspace with laptop and coffee cup on wooden desk\",\n \"seo_keywords\": [\"office\", \"workspace\", \"laptop\", \"desk\", \"modern\"],\n \"seo_filename\": \"modern-office-workspace\"\n}\n```\n\n## Supported Formats\n\n| Format | Input | Output | Notes |\n|--------|-------|--------|-------|\n| JPG | Yes | Yes | |\n| PNG | Yes | Yes | |\n| WebP | Yes | Yes | |\n| AVIF | Yes | Yes | |\n| GIF | Yes | Yes | Animated GIFs preserved when output is GIF |\n| SVG | Yes | Yes | SVG→SVG optimized via SVGO; raster↔SVG conversion supported |\n| ICO | Yes | Yes | Smart rebuild: generates 16, 24, 32, 48, 256px favicon set |\n| HEIC/HEIF | Yes* | No | Auto-converted to JPG at upload |\n| TIFF | Yes* | No | Auto-converted to JPG at upload |\n| BMP | Yes* | No | Auto-converted to JPG at upload |\n\ntinify.ai supports high-quality conversion between any input and output format combination.\nConverting an animated GIF to a non-GIF format (JPG, PNG, WebP, AVIF) preserves only the first frame.\nConverting an animated GIF to a GIF format supports upscaling/resizing while preserving the animation and quality. You may also reduce animated GIF file size by decreasing the number of output frames.\n\nMax upload file size: 50 MB.\n\n### SVG & ICO Examples\n\n```\n# Optimize an SVG file (keeps as vector)\nOptimize logo.svg and keep it as SVG\n\n# Convert SVG to raster\nConvert icon.svg to a 512x512 PNG\n\n# Trace raster to vector SVG\nConvert my logo.png to a vector SVG\n\n# Generate favicon set from any image\nConvert logo.png to an ICO favicon\n\n# Generate single-size ICO\nConvert logo.png to a 32x32 ICO\n\n# Extract largest icon from ICO\nConvert favicon.ico to PNG\n```\n\n## How It Works\n\n```\nLocal file or URL\n → Upload to Tinify.ai API\n → Smart compression (lossy, typically 60-80% reduction)\n → AI SEO tag generation (alt text, keywords, filename)\n → Optional: resize, upscale, format conversion\n → Download optimized file\n → Save with SEO filename slug (or .tinified suffix if SEO disabled)\n```\n\nAll processing happens server-side via the [Tinify.ai API](https://api.tinify.ai). The MCP server is a thin client that orchestrates the pipeline.\n\n## Credits\n\n| | Guest | Free | Pro | Max |\n|---|---|---|---|---|\n| Credits/day or month | 20/day | 50/day | 3,000/month | 10,000/month |\n| Images/day (default settings) | ~5 | ~12 | ~750 | ~2,500 |\n| Cost per image | 3 credits + 1 SEO | same | same | same |\n| Signup required | No | Free signup | Paid | Paid |\n\nSession data is stored locally at `~/.tinify/session.json` and persists across invocations.\n\n## Account & Credits\n\nLog in to unlock more credits and share them across the web app and MCP server:\n\n```\nUse the login tool to sign in.\nUse the status tool to check your current credits.\nUse the upgrade tool to open the pricing page.\nUse the logout tool to sign out.\n```\n\n### login\n\nOpens a browser window to complete login (Google, Facebook, or email/magic link). After approval, your account is linked and credits are shared with the web app.\n\n```\nLogin complete: user@example.com (Pro tier, 2,850 of 3,000 credits remaining)\n```\n\n### status\n\nCheck your current account status and credits before batch processing:\n\n```\nLogged in as user@example.com (Pro tier)\nCredits: 2,850 of 3,000 remaining\nResets: 03/01/2026, 12:00 AM PST\n```\n\n### logout\n\nRevokes the session and reverts to guest mode (20 credits/day).\n\n### upgrade\n\nOpens [tinify.ai/pricing](https://tinify.ai/pricing) in your browser.\n\n## Tips for AI Agents\n\nPaste this into your `CLAUDE.md` or system prompt to help agents use the tool effectively:\n\n```\n## Tinify.ai MCP\n\nTools: optimize_image, login, logout, status, upgrade\n\n- Use status to check credits before batch processing\n- Each optimize_image call costs 3 credits + 1 if SEO enabled (default)\n- Guest: 20 credits/day. Free account: 50/day. Pro: 3,000/month.\n- Always use absolute file paths, not relative.\n- Set only width OR height for proportional resize. Set both for exact dimensions.\n- When both dimensions are set, use output_resize_behavior: \"crop\" for photos, \"pad\" for logos/icons.\n- output_seo_tag_gen (default true) renames the file to an SEO slug and generates alt text + keywords.\n- Set output_seo_tag_gen: false to save 1 credit when SEO metadata is not needed.\n- GIF is supported for both input and output; animated GIFs stay animated when output_format is \"gif\".\n- Converting an animated GIF to jpg/png/webp/avif preserves only the first frame.\n- HEIC, TIFF, BMP inputs are auto-converted to JPG.\n- For batch processing, call optimize_image once per file.\n- If credits run out, use login to sign in or upgrade to open pricing.\n```\n\n## Troubleshooting\n\n**Server not appearing in tool list:**\n- Restart your MCP client after editing the config\n- Ensure Node.js >= 18 is installed: `node --version`\n- Try running directly: `npx -y @tinify-ai/mcp-server@latest` (should start without errors)\n\n**\"Insufficient credits\" error:**\n- Use the `status` tool to check remaining credits\n- Use the `login` tool to sign in for more credits (free accounts get 50/day)\n- Use the `upgrade` tool to see paid plans (Pro: 3,000/month, Max: 10,000/month)\n- Disable SEO tags (`output_seo_tag_gen: false`) to reduce cost to 3 credits/image\n\n**Login browser window doesn't open:**\n- Open this URL manually: `https://tinify.ai/mcp/authorize` and enter the code shown in the terminal\n- Ensure a browser is installed and accessible\n\n**Session token issues:**\n- Session data is stored at `~/.tinify/session.json`\n- Delete this file to reset and start fresh\n- Use `logout` then `login` to re-authenticate\n\n**File not found:**\n- Use absolute paths for local files\n- For URLs, ensure the image is publicly accessible\n\n**Timeout errors:**\n- Large images or AI upscaling can take 30-60 seconds\n- The server has a 60-second timeout per job\n\n## Requirements\n\n- Node.js >= 18\n- An MCP-compatible client (Claude Desktop, Claude Code, Cursor, Windsurf, Cline, OpenAI Codex CLI, Gemini CLI, etc.)\n\n## License\n\nMIT - see [LICENSE](https://github.com/onepunchtechnology/tinify-ai-mcp-server/blob/main/LICENSE).\n","changelogMarkdown","videoKey","requiredSecretsJson","publishedAt","priceCents","trialDays",0,"categoryDisplayName","Developer Tools","upstream",{"_95":96,"_97":98,"_99":100,"_101":102,"_103":-5},"requiredSecrets",[],"tags",[],"assets",[],"stats",{"_93":80,"_94":80},"ratingAvg","reviewCount","topics",[],"license","MIT","language","TypeScript","registryName","io.github.onepunchtechnology/tinify-ai","homepage","ENV",{"_106":107,"_108":109,"_110":111},"ENVIRONMENT","production","TURNSTILE_SITE_KEY","0x4AAAAAAB8-rEI2gNDf_QhU","SENTRY_DSN","https://45fd1229f78089d5c3ee78be128030e1@o4510583261757440.ingest.de.sentry.io/4510584253448272"]