Spronta
Get started

MCP Server

Image CDN for
AI Agents

Connect Claude, GPT, Cursor, or any MCP client to the Spronta Image CDN. Upload images, create presets, generate signed URLs — all through natural language.

Get your API keyView on npm

Connect in 30 seconds

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

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

What is the Spronta MCP Server?

The Spronta MCP Server is an open-source tool that connects AI assistants to the Spronta Image CDN using the Model Context Protocol. It exposes 18 tools that let LLMs manage image projects, upload and optimize images, create transform presets, generate signed URLs, and monitor usage — all through natural language prompts.

Projects

  • list_projectsList all image projects
  • create_projectCreate a new project
  • get_projectGet project details & stats
  • update_projectUpdate name or domain
  • delete_projectDelete a project

Upload

  • upload_imageUpload from URL or base64 — handles presigned flow automatically

Images

  • list_imagesList images with pagination
  • update_imageUpdate alt text and tags
  • delete_imageDelete an image

Presets

  • list_presetsList transform presets
  • create_presetCreate a named preset
  • update_presetUpdate a preset
  • delete_presetDelete a preset

Signing

  • get_signing_configGet signing configuration
  • update_signingEnable/disable URL signing
  • generate_signed_urlGenerate HMAC-SHA256 signed URL

Analytics

  • get_usageDaily requests, bandwidth, transforms

Utility

  • build_cdn_urlBuild a CDN URL with transforms (no API call)

What can you ask?

Once connected, just talk to your AI assistant naturally.

>Upload this image to my project: https://example.com/photo.jpg
>Create a thumbnail preset: 200x200, cover, face gravity, webp
>How many requests did my project get this week?
>Generate a signed URL for hero.jpg that expires in 1 hour
>List all images and update the alt text on the first one
>Build a CDN URL for photo.jpg at 800px wide in avif format

Frequently asked questions

What is MCP (Model Context Protocol)?

MCP is an open standard that lets AI assistants connect to external tools and data sources. It's supported by Claude, GPT, Cursor, Windsurf, and other AI clients. The Spronta MCP Server uses this protocol to give AI agents access to the Spronta Image CDN.

Which AI clients support the Spronta MCP Server?

Any MCP-compatible client works, including Claude Code, Claude Desktop, Cursor, Windsurf, and any client that supports the Model Context Protocol. The server uses the standard stdio transport.

How does image upload work through MCP?

The upload_image tool handles the entire flow automatically. Pass an image URL or base64 data, and the server fetches the image, gets a presigned upload URL from Spronta, uploads the file, confirms the upload, and returns the CDN URL with a computed blurhash — all in one tool call.

Is the MCP server open source?

Yes. The Spronta MCP Server is MIT-licensed and available on GitHub at github.com/spronta/mcp and on npm as @spronta/mcp.

Do I need a Spronta account?

Yes. You need a Spronta account and an API key to authenticate. Sign up at app.spronta.com to get started — the free tier includes 100 images.

Let your AI manage your images

Get started in 30 seconds. Free tier available.

Get your API keyView on GitHub