About putput-mcp
putput-mcp is an MCP server for AI agents that upload and manage files through PutPut. It accepts a URL for upload and returns a CDN link, with no signup required to get a guest token.
Key features
- 01Upload files from a URL
- 02List files with filters and pagination
- 03Delete files by ID
- 04Retrieve file details and download URLs
Use cases
- 01Upload an agent-generated file and share its CDN link
- 02Find or remove files previously uploaded to PutPut
MCP support
The MCP server exposes tools to upload, list, delete, and inspect files. It can run locally or connect through the remote Streamable HTTP endpoint with a Bearer token.
Configuration
Remote servers need no local install. Pick your client, then copy the config or install in one click.
https://putput.io/api/v1/mcpclaude mcp add --transport http putput-io-dev-putput https://putput.io/api/v1/mcp{"mcpServers":{"putput-io-dev-putput":{"type":"http","url":"https://putput.io/api/v1/mcp"}}}Open in Cursor{"servers":{"putput-io-dev-putput":{"type":"http","url":"https://putput.io/api/v1/mcp"}}}Open in VS Code{"mcpServers":{"putput-io-dev-putput":{"type":"http","url":"https://putput.io/api/v1/mcp"}}}{"mcpServers":{"putput-io-dev-putput":{"serverUrl":"https://putput.io/api/v1/mcp"}}}Run commands in a terminal; paste JSON into the client’s MCP config and restart. Servers that need sign-in will prompt on first connect.
Tools
4| Parameter | Type | Required | Description |
|---|---|---|---|
| url | string | Yes | URL of the file to upload |
| prefix | string | No | Optional path prefix for organization |
| filename | string | No | Optional filename override |
| metadata | object | No | Optional key-value metadata |
| visibility | enum | No | File visibility (default: public)public | private |
Details
From the project README@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
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.