@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 t

... [View full README on GitHub](https://github.com/spronta/mcp#readme)