Putput Mcp

putput-io/mcp

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.

tools: 4
auth: Secret needed
transport: STDIO, HTTP
env var: 1
last updated: Feb 27, 2026

View on GitHub

Install

From registry metadata

$ npx add-mcp https://putput.io/api/v1/mcp --name putput-mcp

Run in your terminal. add-mcp asks which agents to add it to (Claude Code, Codex, Cursor and more). Add -g to install it for every project.

Review the command, arguments and environment values before installing. MCP servers run with your local permissions.

Other ways

Claude Code

$ claude mcp add --transport http putput-mcp https://putput.io/api/v1/mcp

Run in your terminal. Add --scope user to make it available in every project.

Tools

Verified live · 4 tools

Verified live against the running server on Nov 6, 2026.

upload_fileUpload a file from a URL to PutPut storage5 params

Upload a file from a URL to PutPut storage

Parameters* required

filenamestring

Optional filename override

metadataobject

Optional key-value metadata

prefixstring

Optional path prefix for organization

url*string

URL of the file to upload

visibilitystring

File visibility (default: public)one of public · private

list_filesList uploaded files with optional filtering3 params

List uploaded files with optional filtering

Parameters* required

cursorstring

Pagination cursor

limitnumber

Max results (default: 50, max: 200)

prefixstring

Filter by prefix

delete_fileDelete an uploaded file by ID1 params

Delete an uploaded file by ID

Parameters* required

id*string

File ID to delete

get_file_infoGet details about a specific file1 params

Get details about a specific file

Parameters* required

id*string

File ID to look up

Configuration

PUTPUT_TOKEN*secret

PutPut API token. Get one free without signup: curl -X POST https://putput.io/api/v1/auth/guest | jq .token

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

View the full README on GitHub

Details

Repository: github.com/putput-io/mcp
Package: @putput/mcp
Transport: STDIO, HTTP
Auth: Required
Registry: MCP registry, active
Tools verified: Nov 6, 2026