SmartconversionAPI

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

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

<p><i>Empower your AI agents with professional image conversion & programmatic M2M payments via x402.</i></p>

<p> <b>English</b> • <a href="README.fr.md">Français</a> </p> </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.

<a href="https://glama.ai/mcp/servers/lemaitregabinpro-creator/smartconversion-api"> <img width="380" height="200" src="https://glama.ai/mcp/servers/lemaitregabinpro-creator/smartconversion-api/badge" alt="SmartconversionAPI MCP server" /> </a>

---

🛠 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)

1. Clone & Config: cp .env.example .env
2. Setup Wallet: Enter your WALLET_RECEIVER_ADDRESS and Coinbase CDP credentials.
3. 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

---

🤝 Contributing

We are building the economic primitives of the Agentic Web. Contributions are encouraged!

• Core: TypeScript / Node.js
• Image Engine: Sharp
• Transport: MCP Streamable HTTP (SSE)

---

<p align="center"> Developed with ❤️ by <b>SmartUnityIA</b><br> <i>Empowering the machine economy, one byte at a time.</i> </p>