About io.github.spronta/mcp
io.github.spronta/mcp is an MCP server in the Files category: upload, transform, and deliver images on a global CDN via AI agents.
Install
claude mcp add io-github-spronta-mcp -- npx -y @spronta/mcpnpx -y @spronta/mcpThis server has no ConduID identity, so agent calls to it are not receipted. Pin the version you install and review the source before granting it credentials.
Tools (5)
create_projectCreate a new project
Parameters not published.
delete_projectPermanently delete a project
Parameters not published.
get_projectGet project details with usage stats
Parameters not published.
list_projectsList all image projects
Parameters not published.
update_projectUpdate name or custom domain
Parameters not published.
Ask AI
Ask AI about io.github.spronta/mcp
Powered by Claude · Grounded in docs
Security checks
- ✓README presentThe repository ships documentation.
5 checks have not been run yet.
README
@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
- 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:
> 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
Links
License
README copy captured when this server was indexed; it may lag the repository. The original is authoritative.