@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

Terminal

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

Claude Code

Terminal

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:

config.json

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

Get your API key

Sign up at app.spronta.com (free tier: 100 images)
Create a project in the dashboard
Copy your API key from project settings

Environment variables

Variable	Required	Description
`SPRONTA_API_KEY`	Yes	Your project API key
`SPRONTA_PROJECT_ID`	No	Default project ID (can also be passed per-tool)
`SPRONTA_API_URL`	No	API base URL (default: `https://app.spronta.com/api`)

18 tools available

Projects

Tool	Description
`list_projects`	List all image projects
`create_project`	Create a new project
`get_project`	Get project details with usage stats
`update_project`	Update name or custom domain
`delete_project`	Permanently delete a project

Upload & Images

Tool	Description
`upload_image`	Upload from URL or base64 — handles presigned upload, blurhash generation, and CDN URL creation in one call
`list_images`	List images with pagination
`update_image`	Update alt text and tags
`delete_image`	Delete an image from CDN and storage

Transform Presets

Tool	Description
`list_presets`	List named transform presets
`create_preset`	Create a preset (use in CDN URLs with `?t=name`)
`update_preset`	Update a preset's name or transforms
`delete_preset`	Delete a preset

URL Signing

Tool	Description
`get_signing_config`	Get URL signing configuration
`update_signing`	Enable/disable HMAC-SHA256 signing
`generate_signed_url`	Generate a signed CDN URL with optional expiration

Analytics & Utility

Tool	Description
`get_usage`	Get daily metrics (requests, bandwidth, transforms)
`build_cdn_url`	Build a CDN URL with transform parameters (no API call)

Example prompts

Once connected, just ask your AI:

Code

> 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:

Parameter	Type	Description
`width`	integer	Output width (1–8192)
`height`	integer	Output height (1–8192)
`fit`	string	`cover`, `contain`, `fill`, `scale-down`, `crop`, `pad`
`format`	string	`auto`, `webp`, `avif`, `jpeg`, `png`, `jxl`
`quality`	integer	1–100
`qualityMode`	string	`high`, `medium`, `low` (perceptual targeting)
`gravity`	string	`auto`, `face`, `center`, position keywords
`blur`	integer	Gaussian blur (1–250)
`sharpen`	number	Unsharp mask (0–10)
`radius`	integer	Corner radius (1–9999, or "max" for circle)
`grayscale`	boolean	Convert to grayscale
`brightness`	integer	-100 to 100
`contrast`	number	-100 to 100
`saturation`	integer	-100 to 100
`sepia`	boolean	Sepia tone filter
`rotate`	integer	90, 180, 270
`flip`	string	`h` (horizontal), `v` (vertical)

How upload works

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

You provide an image URL (or base64 data) and a filename
The server fetches the image
Requests a presigned upload URL from Spronta
Uploads the file directly to storage
Confirms the upload — Spronta computes the blurhash and detects dimensions
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

License

MIT

Spronta MCP README