Agentic Image Optimization in Claude Code

Optimize images directly from Claude Code — compress, resize, upscale, and generate alt text without leaving your terminal. Uses the Open Plugin surface over stdio.

Requirements

• Node.js ≥ 18
• Claude Code CLI (claude command available)

Install

claude mcp add tinify-ai -- npx -y @tinify-ai/mcp-server

Verify

claude mcp list

Expected output:

tinify-ai   npx -y @tinify-ai/mcp-server   stdio

Usage example

Ask Claude:

Compress hero.png and convert it to WebP format

Claude calls optimize_image and responds:

✓ hero.png → hero.webp  (1.2 MB → 187 KB, 84% smaller)

Auth

Guest mode works immediately — 20 credits/day, no signup. To use credits from your account:

Ask Claude: "Log in to tinify.ai"

Claude calls the login tool, your browser opens to https://tinify.ai/mcp/authorize, you approve, and credits come from your tinify.ai account. Pricing →

Troubleshooting

tinify-ai not appearing in claude mcp list

Re-run the install command. If it still doesn't appear, check that Node.js ≥ 18 is installed:

node --version

npx: command not found

Install Node.js from nodejs.org (LTS version recommended).

Credits exhausted — Insufficient credits error

You've used all 20 free credits for today. They reset at midnight UTC. Upgrade for more →

← Open Plugin overview