@nerdcow/tio-mcp

MCP (Model Context Protocol) server for The Image Optimizer. Lets AI assistants like Claude compress and optimize your images.

What it does

This package bridges your local AI assistant (Claude Desktop, Claude Code, etc.) to The Image Optimizer API. It exposes three tools:

• compress_image — Compress an image from a local file path, URL, or base64 data. Supports JPEG, PNG, GIF, WebP, HEIC, and HEIF. Outputs optimized AVIF/WebP for maximum savings.
• check_balance — Check your remaining credit balance and usage stats.
• list_transactions — View your credit transaction history.

Get an API key

1. Go to theimageoptimizer.com and create an account
2. Subscribe to a paid plan or purchase credits
3. Copy your license key from the dashboard

Setup

Claude Desktop

Add this to your claude_desktop_config.json:

{
  "mcpServers": {
    "tio-image-optimizer": {
      "command": "npx",
      "args": ["-y", "@nerdcow/tio-mcp"],
      "env": {
        "TIO_API_KEY": "YOUR-LICENSE-KEY"
      }
    }
  }
}

Config file location:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json
• Linux: ~/.config/Claude/claude_desktop_config.json

Claude Code

claude mcp add tio-image-optimizer -- npx -y @nerdcow/tio-mcp

Then set the environment variable TIO_API_KEY with your license key.

Usage

Once configured, just ask your AI assistant:

• "Compress /path/to/image.jpg"
• "Optimize this image: https://example.com/photo.png"
• "Check my TIO credit balance"

The assistant handles the rest.

Environment variables

| Variable | Required | Description | |---|---|---| | TIO_API_KEY | Yes | Your TIO license key | | TIO_API_URL | No | API endpoint (defaults to https://api.theimageoptimizer.com) |

License

MIT