@putput/mcp (MCP) Server: File uploads for AI agents

The io.github.putput-io-dev/putput-mcp server provides file upload capabilities for AI agents, including uploading, listing, and managing files. The server description states it requires no signup and is intended for use with Claude Code, Cursor, Windsurf, and VS Code Copilot.

🛠️ Key Features

Upload files to an AI agent workflow
List and manage uploaded files
No signup required (per server description and readme excerpt)
Runs with an API token setup (guest token flow described)

🚀 Use Cases

Supplying files to Claude Code
Supplying files to Cursor
Supplying files to Windsurf
Supplying files to VS Code Copilot

⚡ Developer Benefits

Token-based guest access via curl to https://putput.io/api/v1/auth/guest
Example integrations for Claude Code and Cursor configuration are provided

⚠️ Limitations

The provided excerpt does not enumerate the specific MCP tools (toolCount is 4, but names are not included) or explain file permissions, formats, or retention behavior

@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):

bash

curl -X POST https://putput.io/api/v1/auth/guest | jq .token

Claude Code

bash

claude mcp add putput -- npx @putput/mcp -e PUTPUT_TOKEN=pp_your_token

Cursor

Add to .cursor/mcp.json:

json

{
  "mcpServers": {
    "putput": {
      "command": "npx",
      "args": ["@putput/mcp"],
      "env": {
        "PUTPUT_TOKEN": "pp_your_token"
      }
    }
  }
}

VS Code Copilot

Add to .vscode/mcp.json:

json

{
  "servers": {
    "putput": {
      "command": "npx",
      "args": ["@putput/mcp"],
      "env": {
        "PUTPUT_TOKEN": "pp_your_token"
      }
    }
  }
}

Windsurf

Add to ~/.codeium/windsurf/mcp_config.json:

json

{
  "mcpServers": {
    "putput": {
      "command": "npx",
      "args": ["@putput/mcp"],
      "env": {
        "PUTPUT_TOKEN": "pp_your_token"
      }
    }
  }
}

Remote (Streamable HTTP)

If your client supports remote MCP servers:

code

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_file with 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

url	string	required	URL of the file to upload
filename	string	optional	Optional filename override
visibility	string	optional	File visibility (default: public)
prefix	string	optional	Optional path prefix for organization
metadata	object	optional	Optional key-value metadata

io.github.putput-io-dev/putput-mcp

@putput/mcp (MCP) Server: File uploads for AI agents

🛠️ Key Features

🚀 Use Cases

⚡ Developer Benefits

⚠️ Limitations

upload_file

list_files

delete_file

get_file_info

@putput/mcp

Quick Start

Claude Code

Cursor

VS Code Copilot

Windsurf

Remote (Streamable HTTP)

Tools

How It Works

Pricing

Links

Install

Configuration

Related servers

prefix	string	optional	Filter by prefix
limit	number	optional	Max results (default: 50, max: 200)
cursor	string	optional	Pagination cursor