API & Integrations — Agentic Image Optimization
Integrate tinify.ai programmatically via MCP Server (primary) or x402 pay-per-request. No REST API key required for MCP.
API & Integrations
tinify.ai exposes two programmatic surfaces today: the MCP Server for AI-native integrations, and x402 for pay-per-request crypto micropayments.
When to use which
| Surface | Protocol | Auth | Best for |
|---|---|---|---|
| MCP Server | JSON-RPC over stdio or HTTP | Device code (OAuth-like) or guest | AI editors, agents, automation |
| x402 | HTTP + payment header | Crypto wallet | Pay-per-request without accounts |
MCP Server (primary)
The MCP Server is the recommended integration surface. It exposes optimize_image, login, logout, and status tools to any MCP-compatible host.
Local stdio (install once, works offline):
npx -y @tinify-ai/mcp-serverRemote HTTP (no install, always up-to-date):
https://app.tinify.ai/mcpSee MCP Server → for full parameter reference and auth flow.
x402 (pay-per-request)
x402 is a cryptocurrency micropayment protocol. Send a valid payment header with your HTTP request and receive a processed image — no account, no credits.
x402 is currently in beta. Contact hello@tinify.ai for access.
Platforms using this surface
External links
- npm: npmjs.com/package/@tinify-ai/mcp-server
- Remote MCP: app.tinify.ai/mcp
Quickstart — Agentic Image Optimization
Install tinify.ai in your AI editor in 60 seconds. Choose your platform and run one command.
MCP Server — Agentic Image Optimization
Install the tinify.ai MCP Server locally via npm or connect to the remote HTTP endpoint. Compress, resize, upscale, and tag images from any MCP-compatible AI editor.