Putput Mcp

io.github.putput-io-devPublished by GitHub account putput-io-devv0.0.3Updated Oct 24, 2026

File uploads for AI agents. Upload, list, and manage files. No signup required.

VerifiedStreamable HTTPWeb executableCloud & InfrastructureFiles & Storage

Overview

AI-generated overview

PutPut MCP lets an AI assistant upload files from URLs to PutPut storage and list, inspect or delete them, returning CDN links.

What you can do
Upload a file from a URL to PutPut storage and get a CDN link back, with files stored on Cloudflare R2 and served from edge locations. List uploaded files with optional prefix filtering and pagination. Get details, stats and a download URL for a specific file. Delete an uploaded file by ID.
When to use it
Useful when an assistant needs to publish a file it has a URL for and hand back a shareable CDN link, or when you want to browse and clean up previously uploaded files without setting up cloud storage yourself.
Requirements
A PutPut API token in the PUTPUT_TOKEN environment variable, or as a Bearer token in the Authorization header for the remote endpoint. The local package runs via npx, so Node.js is needed. A guest token can be obtained without signup; larger plans require an account. Network access to PutPut is required.
Before you install
The PUTPUT_TOKEN is a secret and should be kept out of shared configs and logs. Uploading sends the referenced file to PutPut and Cloudflare R2, a third party. Delete removes files permanently. Guest storage is limited to 1 GB with a 14-day expiry, and paid plans cost from $9/mo.

Installation

In SourceWeft

  1. Open Putput Mcp in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.github.putput-io-dev%2Fputput-mcp/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "putput": {
      "type": "http",
      "url": "https://putput.io/api/v1/mcp"
    }
  }
}

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

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:

https://putput.io/api/v1/mcp

Pass your token as a Bearer token in the Authorization header.

Tools

ToolDescription
upload_fileUpload a file from a URL to PutPut and get a CDN link back
list_filesList uploaded files with optional prefix filter and pagination
delete_fileDelete a file by ID
get_file_infoGet file details, stats, and download URL

How It Works

  1. Your AI agent calls upload_file with a URL
  2. PutPut uploads the file to Cloudflare R2
  3. 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

Source: README.md at commit 1cb032a

Tools

4

upload_file

Upload a file from a URL to PutPut storage

Parametersurlrequiredprefixfilenamemetadatavisibility

list_files

List uploaded files with optional filtering

Parameterslimitcursorprefix

delete_file

Delete an uploaded file by ID

Parametersidrequired

get_file_info

Get details about a specific file

Parametersidrequired

Version history

1
  1. v0.0.3LatestSep 16, 2026

Score

90% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts

    Declare a license in the repository or the registry entry.