Documentation

MCP Server

The Get Pronto MCP server lets AI agents upload, manage, and transform images natively using the Model Context Protocol. It works with any MCP-compatible client including Claude Code, Claude Desktop, Cursor, and Windsurf.

Quick Start

Add the MCP server to your client's configuration. No signup is required — agents can generate an ephemeral test key on demand.

Claude Code

Run this command in your terminal to add the server:

bash

claude mcp add getpronto -- npx -y getpronto-mcp

Or if you have an API key, pass it as an environment variable:

bash

claude mcp add getpronto -e GETPRONTO_API_KEY=pronto_sk_... -- npx -y getpronto-mcp

Claude Desktop / Cursor / Windsurf

Add the following to your MCP configuration file:

json

{
  "mcpServers": {
    "getpronto": {
      "command": "npx",
      "args": ["-y", "getpronto-mcp"]
    }
  }
}

To use an existing API key instead of ephemeral keys, add an env block:

json

{
  "mcpServers": {
    "getpronto": {
      "command": "npx",
      "args": ["-y", "getpronto-mcp"],
      "env": {
        "GETPRONTO_API_KEY": "pronto_sk_..."
      }
    }
  }
}

Available Tools

Once connected, your AI agent has access to the following tools:

Tool	Description
`generate_test_key`	Generate an ephemeral API key with limited quotas (no signup required)
`upload_image`	Upload from a file path, URL, or data URL
`list_files`	List files with pagination and folder filtering
`get_file`	Get file details including URL, dimensions, and metadata
`delete_file`	Delete a file
`transform_image`	Generate a transformed image URL (resize, format, blur, crop, etc.)

Ephemeral Test Keys

If no API key is configured, the agent can call generate_test_key to get a temporary key instantly — no signup or account needed. This is ideal for trying out Get Pronto or building quick prototypes.

Limit	Value
Storage	100 MB
Monthly bandwidth	500 MB
Monthly transforms	100
Max file size	10 MB (images only)
TTL	7 days

After 7 days, the ephemeral account and all its files are automatically deleted. To keep your files and get higher quotas, create a free account.

Example Usage

Once the MCP server is configured, you can ask your AI agent to interact with Get Pronto directly. Here are some example prompts:

Upload an image

"Upload the screenshot at ./screenshot.png to Get Pronto"

Transform an image

"Resize my latest upload to 800x600 and convert it to WebP"

Manage files

"List all my uploaded files and delete anything older than a week"

Quick prototype

"Generate a test key and upload this image so I can use it in my project"

Environment Variables

Variable	Description	Default
`GETPRONTO_API_KEY`	Your Get Pronto secret API key	None (use `generate_test_key`)
`GETPRONTO_BASE_URL`	API base URL	`https://api.getpronto.io/v1`

Transform Options

The transform_image tool supports the full range of Get Pronto image transformations:

Resize: width, height, fit (cover, contain, fill, inside, outside)
Quality: 1-100
Blur: Gaussian blur (0.3-1000)
Sharpen: Boolean
Grayscale: Boolean
Rotate: -360 to 360 degrees
Format: jpeg, png, webp, avif
Border: width + hex color (e.g., FF0000)
Crop: x, y, width, height

Next Steps

Continue exploring our documentation with these related topics: