Summary
Gives AI agents a simple way to upload files and get back CDN URLs without dealing with S3 buckets or deploy configs. Exposes four tools: upload_file takes a URL and returns a Cloudflare R2 link served from 300+ edge locations, list_files for browsing uploads with prefix filtering, delete_file, and get_file_info for metadata. Works across Claude Code, Cursor, Windsurf, and VS Code Copilot via stdio, plus supports remote connections over streamable HTTP. Guest tokens give you 1 GB free with no signup, which is enough for prototyping or one-off transfers when you need files accessible to an agent without standing up infrastructure.
Fastest browser for AI agents to run web automation tasks, always free.
Download Free life-time →
belt cli automatically finds the best tools and skills for your agent. image, video, music, tts...
one prompt install →
Free an open-source skills that make AI coding agents easier to understand, verify, and control.
Download for free →
Connect your Claude agent to live crypto prices and trading routes via 1inch
Get the MCP →
Notes, actions and memory. Without a meeting bot. First month 100% off.
Download for free →Tools
Public tool metadata for what this MCP can expose to an agent.
4 tools
upload_fileUpload a file from a URL to PutPut storage5 params
Upload a file from a URL to PutPut storage
Parameters* required
filenamestringOptional filename override
metadataobjectOptional key-value metadata
prefixstringOptional path prefix for organization
urlstringURL of the file to upload
visibilitystringFile visibility (default: public)one of
public · privatelist_filesList uploaded files with optional filtering3 params
List uploaded files with optional filtering
Parameters* required
cursorstringPagination cursor
limitnumberMax results (default: 50, max: 200)
prefixstringFilter by prefix
delete_fileDelete an uploaded file by ID1 params
Delete an uploaded file by ID
Parameters* required
idstringFile ID to delete
get_file_infoGet details about a specific file1 params
Get details about a specific file
Parameters* required
idstringFile ID to look up
@putput/mcp
File uploads for AI agents. Upload, list, and manage files from Claude Code, Cursor, Windsurf, and VS Code Copilot — no signup required.
Quick Start
Get a free API token (no signup):
curl -X POST https://putput.io/api/v1/auth/guest | jq .token
Claude Code
claude mcp add putput -- npx @putput/mcp -e PUTPUT_TOKEN=pp_your_token
Cursor
Add to .cursor/mcp.json:
{
"mcpServers": {
"putput": {
"command": "npx",
"args": ["@putput/mcp"],
"env": {
"PUTPUT_TOKEN": "pp_your_token"
}
}
}
}
VS Code Copilot
Add to .vscode/mcp.json:
{
"servers": {
"putput": {
"command": "npx",
"args": ["@putput/mcp"],
"env": {
"PUTPUT_TOKEN": "pp_your_token"
}
}
}
}
Windsurf
Add to ~/.codeium/windsurf/mcp_config.json:
{
"mcpServers": {
"putput": {
"command": "npx",
"args": ["@putput/mcp"],
"env": {
"PUTPUT_TOKEN": "pp_your_token"
}
}
}
}
Remote (Streamable HTTP)
If your client supports remote MCP servers:
https://putput.io/api/v1/mcp
Pass your token as a Bearer token in the Authorization header.
Tools
| Tool | Description |
|---|---|
upload_file | Upload a file from a URL to PutPut and get a CDN link back |
list_files | List uploaded files with optional prefix filter and pagination |
delete_file | Delete a file by ID |
get_file_info | Get file details, stats, and download URL |
How It Works
- Your AI agent calls
upload_filewith a URL - PutPut uploads the file to Cloudflare R2
- You get back a CDN URL — done
No AWS, no config, no deploy step. Files are served from 300+ edge locations with $0 egress.
Pricing
- Guest: 1 GB free, no signup, 14-day expiry
- Free: 10 GB free, requires account
- Pro: From $9/mo for 50 GB, unlimited bandwidth, $0 egress
Links
- Website: https://putput.io
- API Docs: https://docs.putput.io
- SDK:
npm install @putput/sdk - CLI:
npx @putput/cli upload <file> - GitHub: https://github.com/putput-io
Featured
Fastest browser for AI agents to run web automation tasks, always free.
Download Free life-time →belt cli automatically finds the best tools and skills for your agent. image, video, music, tts...
one prompt install →Free an open-source skills that make AI coding agents easier to understand, verify, and control.
Download for free →Connect your Claude agent to live crypto prices and trading routes via 1inch
Get the MCP →Notes, actions and memory. Without a meeting bot. First month 100% off.
Download for free →Configuration
PUTPUT_TOKEN*secretPutPut API token. Get one free without signup: curl -X POST https://putput.io/api/v1/auth/guest | jq .token