# Kraken.io — how to use (mcp.ai)

Connect your Kraken.io account and use 3 tools for images and design straight from your AI agent. Connect with your own API key. Kraken.io is an image optimization and compression platform that helps reduce image file sizes without compromising quality.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_kraken_io?ms=1787291400000`
Add it as a custom/remote MCP connector in your client (Claude, Cursor, VS Code…), then authenticate when prompted. Once connected, ask the agent to use the server's tools (e.g. `kraken_io_check_user_status`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/kraken_io`
Auth: `Authorization: Bearer sk_live_…` — create a workspace API key at https://mcp.ai/settings/api-keys
Discover endpoints: `GET https://api.mcp.ai/api/kraken_io/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/kraken_io/check/user/status` — Tool to retrieve current Kraken.io account status and quota usage. Use when you need to verify plan limits and remaining quota before processing images.
  - body: { api_key: string, api_secret: string }
- `POST https://api.mcp.ai/api/kraken_io/optimize/image/url` — Tool to optimize an image from a public URL. Use when you need to compress, resize, or convert an externally hosted image. Returns result immediately if 'wait' is true.
  - body: { dev?: boolean, url: string, auth: object, avif?: boolean, wait?: boolean, webp?: boolean, lossy?: boolean, resize?: object, convert?: object, quality?: integer, lossless?: boolean, s3_store?: object, preserve_metadata?: boolean }
- `POST https://api.mcp.ai/api/kraken_io/preserve/metadata` — Tool to preserve EXIF and other metadata during Kraken.io image optimization. Use when you need to maintain metadata while compressing images.
  - body: { dev?: boolean, url?: string, auth: object, file?: string, wait?: boolean, lossy?: boolean, quality?: integer, s3_store?: object, file_name?: string, preserve_metadata?: boolean }

## Example prompts
- "What can I do in Kraken.io?"
- "Show me a summary of my Kraken.io account"

## More
- Page: https://mcp.ai/kraken_io
- Agent spec (llms.txt): https://mcp.ai/kraken_io/llms.txt
- Postman collection: https://mcp.ai/kraken_io/postman.json
