MCP 服务器

SmartconversionAPI

conversion image to webp/avif with 402 payement required, 0.001 and 0.0005 after 1000 requete.

README

<div align="center"> <img src="./public/logo.png" alt="SmartConvert Logo" width="120" style="border-radius: 20px; margin-bottom: 20px;"> <h1>SmartConvert x402</h1> The 1st Image Optimization Engine for the Agentic Web

<a href="https://api.smartrayon.eu/site">🌍 Landing Page</a> • <a href="https://api.smartrayon.eu/public/dashboard/index.html">📊 Live Dashboard</a> • <a href="https://api.smartrayon.eu/public/playground/index.html">🎮 Playground</a> • <a href="https://api.smartrayon.eu/public/blog/index.html">✍️ Blog</a> • <a href="https://api.smartrayon.eu/api-docs">📖 Swagger API Docs</a>

Empower your AI agents with professional image conversion & programmatic M2M payments via x402.

English • <a href="README.fr.md">Français</a> </div>

🚀 Overview

SmartConvert x402 is a high-performance Model Context Protocol (MCP) server designed for the autonomous agent economy. It provides a plug-and-play solution for AI assistants (like Claude, Cursor, or AutoGPT) to optimize images while handling payments natively using USDC on Base.

Why it's a Game Changer:

For AI Agents: Zero-friction image processing. No API keys to manage per user—the agent pays its own way using the x402 protocol.
For Developers: Build apps that monetize themselves instantly. Every byte processed generates revenue directly to your wallet.
Privacy First: High-speed processing using Sharp (Node.js) with support for WebP, AVIF, PNG, JPEG, and SVG.

🛠 MCP Capabilities

Once connected to your AI assistant, SmartConvert exposes the following tools and intelligence:

🧰 Tools

convert_image_to_webp: High-speed conversion to WebP or AVIF. Supports Base64, public URL, or local server path. Triggers the x402 payment lifecycle automatically.
convert_batch: 🗂️ NEW — Process up to 5 images in a single parallel call with a discounted group rate.
resize_image: 📏 NEW — Smart resizing with width/height controls and fit/crop strategies.
crop_image: ✂️ NEW — Extract precise rectangular regions from any image.
compress_image: 🗜️ NEW — Heavy quality optimization without changing the source format.
get_image_metadata: 🆓 FREE — Extracts detailed metadata (dimensions, format, DPI, EXIF) via Base64, URL, or local path.

🧠 Prompts (Agentic Intelligence)

smart_optimizer: Fully autonomous workflow: analyze, choose best format, and convert.
image_performance_audit: SEO expert that analyzes weight/dimensions and suggests optimizations.
format_advisor: Expert advice on choosing between WebP (speed) or AVIF (quality).
html_picture_generator: Generates optimized HTML <picture> tags after conversion.
technical_troubleshooter: Checks for image corruption and sensitive EXIF data (privacy).
image_optimization_agent: Standard autonomous workflow for conversion.
x402_payment_help: Interactive guide for the x402 payment flow.

📊 Resources

image-api://capabilities: Overview of all supported tools and formats.
image-api://quickstart: Ready-to-use examples for tools and prompts.
image-api://pricing: Structured pricing information (USDC on Base).
image-api://faq: Frequently asked questions about usage and formats.
image-api://usage_statistics: Real-time transparency on platform-wide usage and bytes saved.
image-api://instructions: Embedded documentation for the x402 standard.
image-api://spec: Full OpenAPI definition for deep integration.

💸 The x402 Payment Flow

SmartConvert implements the HTTP 402 Payment Required standard, specifically designed for Machine-to-Machine (M2M) communications.

sequenceDiagram
    participant Agent as AI Agent (Cursor/Claude)
    participant API as SmartConvert API
    participant SDK as x402 EVM SDK (Base)

    Agent->>API: POST /convert (No signature)
    API-->>Agent: 402 Payment Required + Payment Details
    Note over Agent: Agent detects x402 protocol
    Agent->>SDK: Sign USDC TransferWithAuthorization
    SDK-->>Agent: Cryptographic Payload (Base64)
    Agent->>API: POST /convert + payment-signature
    API-->>Agent: 200 OK + Optimized Image

⚡ Quick Start

For Users (Claude Desktop / Cursor)

Simply add the following to your configuration:

{
  "mcpServers": {
    "smartconvert": {
      "url": "https://api.smartrayon.eu/mcp"
    }
  }
}

Pro Tip: Use localPath or imageUrl instead of Base64 for 10x faster processing.

For Developers (Self-Hosting & Monetization)

Clone & Config: cp .env.example .env
Setup Wallet: Enter your WALLET_RECEIVER_ADDRESS and Coinbase CDP credentials.
Deploy with Docker:

docker compose up -d --build

🔧 Environment Variables

Variable	Description	Default
`PORT`	API Port	`6722`
`WALLET_RECEIVER_ADDRESS`	Where USDC payments are sent	-
`CDP_API_KEY_ID`	Coinbase CDP Key ID	-
`X402_USE_TESTNET`	Toggle Base Sepolia vs Mainnet	`true`