About Image Resize X402
Image Resize X402 is an MCP server and pay-per-call API for resizing images provided by URL. It allows target dimensions and PNG, JPEG, or WebP output, preserving the aspect ratio when only one dimension is set.
Key features
- 01Resize images from a URL
- 02Set target width or height
- 03Convert to PNG, JPEG, or WebP
- 04Preserve aspect ratio when applicable
Use cases
- 01Creating image thumbnails
- 02Optimizing images for websites
- 03Preparing images for social media
- 04Resizing images for email templates
MCP support
Exposes the media_resize_image tool to MCP clients, returning the resized image as base64 with metadata in JSON. Calls use x402 micropayments in USDC on Base.
Configuration
Remote servers need no local install. Pick your client, then copy the config or install in one click.
https://image-resize.api.klymax402.com/mcpclaude mcp add --transport sse br0ski777-image-resize https://image-resize.api.klymax402.com/mcp{"mcpServers":{"br0ski777-image-resize":{"type":"sse","url":"https://image-resize.api.klymax402.com/mcp"}}}Open in Cursor{"servers":{"br0ski777-image-resize":{"type":"sse","url":"https://image-resize.api.klymax402.com/mcp"}}}Open in VS Code{"mcpServers":{"br0ski777-image-resize":{"type":"sse","url":"https://image-resize.api.klymax402.com/mcp"}}}{"mcpServers":{"br0ski777-image-resize":{"serverUrl":"https://image-resize.api.klymax402.com/mcp"}}}Run commands in a terminal; paste JSON into the client’s MCP config and restart. Servers that need sign-in will prompt on first connect.
Tools
Details
From the project READMEImage Resize API
Resize images from URL -- custom width/height, format conversion (PNG/JPEG/WebP), aspect ratio preserved. Pay-per-call via x402 (USDC on Base L2) -- no API key, no signup, no rate-limit wall.
Part of the klymax402 marketplace -- 100 x402 micropayment APIs for AI agents, one wallet, USDC on Base.
Quickstart -- MCP
Add to your MCP client config (Claude Desktop, Cursor, ElizaOS, etc.):
{
"mcpServers": {
"image-resize": {
"url": "https://image-resize.api.klymax402.com/mcp"
}
}
}
Quickstart -- HTTP (x402)
curl -X POST "https://image-resize.api.klymax402.com/api/resize" \
-H "Content-Type: application/json" \
-d '{"url":"https://example.com"}'
# -> 402 Payment Required, with an x402 payment challenge in the response body
Any x402-aware client (@x402/fetch, x402-agent-tools, ATXP) handles the 402 -> sign -> retry cycle automatically.
Tools
| Tool | Method | Path | Price | Description |
|---|---|---|---|---|
media_resize_image | POST | /api/resize | $0.008 | Resize an image from URL |
media_resize_image
Use this when you need to resize an image from a URL or convert its format. Returns the resized image as base64 with metadata in JSON.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
url | string | yes | URL of the image to resize |
width | number | no | Target width in pixels (maintains aspect ratio if height is omitted) |
height | number | no | Target height in pixels (maintains aspect ratio if width is omitted) |
format | string | no | Output format: 'png', 'jpeg', or 'webp' (default: png) |
Example response:
{"image":"iVBORw0KGgo...","originalWidth":1920,"originalHeight":1080,"newWidth":800,"newHeight":450,"format":"webp","fileSizeBytes":24500}
When to use: creating thumbnails, optimizing images for web, preparing social media images, resizing for email templates, and batch image processing.
Not for: OCR text extraction (use media_extract_text_from_image), QR code generation (use utility_generate_qr_code), screenshots (use capture_screenshot).
Example agent prompts
- "Resize an image from a URL or convert its format"
Payment
- Protocol: x402 -- HTTP-native pay-per-call, no signup, no API key
- Network: Base L2 (
eip155:8453) - Asset: USDC
- Facilitator: Coinbase CDP (primary), PayAI (fallback)
- Also reachable via ATXP (OAuth-wrapped x402, RFC 9728 protected-resource metadata)
Part of klymax402
100 x402 micropayment APIs for AI agents -- one wallet, USDC on Base, zero signup.
- Catalog: https://klymax402.com/llms.txt
- Full API reference: https://klymax402.com/llms-full.txt
- Live stats: https://klymax402.com/stats
License
MIT
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.