spronta

@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

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:

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

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