@spronta/mcp

MCP server for uploading, transforming, and serving images on a global CDN — directly from AI assistants.

Connect Claude, GPT, Cursor, Windsurf, or any MCP-compatible client to the Spronta Image CDN. Upload images from URLs or base64, apply real-time transforms (resize, crop, format conversion, smart crop, blurhash), create reusable presets, generate signed URLs, and monitor usage — all through natural language.

Why use this?

• Upload images from AI — give your LLM an image URL and it uploads, optimizes, and returns a CDN link

• Real-time transforms — resize, crop, convert to WebP/AVIF/JXL, smart crop with face detection

• Global CDN delivery — images served from edge locations worldwide

• Blurhash generation — automatic blur placeholders computed on upload

• Signed URLs — HMAC-SHA256 signed URLs with expiration for private images

• Named presets — create reusable transform configurations (e.g. thumbnail, hero, og-image)

• No vendor lock-in — MIT licensed, open source

Quick start

Install

npm install -g @spronta/mcp
# or use directly
npx @spronta/mcp

Claude Code

claude mcp add spronta \
  -e SPRONTA_API_KEY=spronta_img_... \
  -e SPRONTA_PROJECT_ID=your-project-id \
  -- npx @spronta/mcp

Claude Desktop / Cursor / Windsurf

Add to your MCP configuration file:

{
  "mcpServers": {
    "spronta": {
      "command": "npx",
      "args": ["@spronta/mcp"],
      "env": {
        "SPRONTA_API_KEY": "spronta_img_...",
        "SPRONTA_PROJECT_ID": "your-project-id"
      }
    }
  }
}

Get your API key

1. Sign up at app.spronta.com (free tier: 100 images)

2. Create a project in the dashboard

3. Copy your API key from project settings

Environment variables

18 tools available

Projects

Upload & Images

Transform Presets

URL Signing

Analytics & Utility

Example prompts

Once connected, just ask your AI:

> Upload this image to my project: https://example.com/photo.jpg

> Create a thumbnail preset: 200x200, cover crop, face detection, webp format

> How many requests did my project handle this week?

> Generate a signed URL for hero.jpg that expires in 1 hour

> List all my images and update the alt text on the product shots

> Build a CDN URL for banner.png at 1200px wide in avif format

Transform options

When creating presets or building URLs, these transforms are available:

How upload works

The upload_image tool handles the full upload pipeline in a single call:

1. You provide an image URL (or base64 data) and a filename

2. The server fetches the image

3. Requests a presigned upload URL from Spronta

4. Uploads the file directly to storage

5. Confirms the upload — Spronta computes the blurhash and detects dimensions

6. Returns the confirmed image with CDN URL, blurhash, and metadata

Related packages

• @spronta/images — Core URL builder SDK (zero deps)

• @spronta/images-react — React components

• @spronta/images-next — Next.js integration

• WordPress plugin — Automatic CDN for WordPress

Links

• Website

• Documentation

• API Reference

• OpenAPI Spec

• GitHub

• npm

License

MIT