Image Resize X402

by Br0ski777

225 downloads
Not rated
GitHub

About

Resize images from URL -- custom width/height, format conversion (PNG/JPEG/WebP), aspect ratio preserved. -- x402 micropayment API + MCP server for AI agents

Details

Author
Br0ski777
Downloads
225
Categories
Media

- Resize images from any URL
- Custom width/height with aspect ratio preserved
- Format conversion to PNG, JPEG, or WebP
- Pay-per-call via x402 (USDC on Base L2)
- No API key, signup, or rate-limit walls
- Returns base64 image with metadata in JSON

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name Image Resize X402
    Command (node, npx, python, etc.)

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

Add the MCP server to your client config (Claude Desktop, Cursor, ElizaOS, etc.) with the URL https://image-resize.api.klymax402.com/mcp. For HTTP, send a POST request to /api/resize; any x402-aware client (e.g., @x402/fetch) handles the 402 → sign → retry cycle automatically. The tool is media_resize_image.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "image resize x402": {
            "image-resize": {
                "url": "https://image-resize-x402-production.up.railway.app/mcp",
                "transport": "sse"
            }
        }
    }
}

McpServers

{
    "image-resize": {
        "url": "https://image-resize-x402-production.up.railway.app/mcp",
        "transport": "sse"
    }
}

Image Resize API

MCP Server
x402
License: MIT

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.003 | 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

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.