Log inSubmit server
Putput MCP logo

Putput MCP

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

InstallRepositoryWebsite
Full README Compare alternatives Embed widget Claim this listing

Install Putput MCP

Pick your client, then add it in one click or paste the config.

STDIONode.js
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "putput-mcp": {
      "command": "npx",
      "args": [
        "@putput/mcp"
      ]
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

We couldn’t confirm it starts correctly

The install command installed and started the server, which then stopped for configuration (such as an API key) that our sandbox does not have — expected for servers that connect to your account.

npx @putput/mcp

No response to initialize.

This is an experimental automated check and can have false negatives — missing environment variables, a slow cold install, etc. It doesn’t necessarily mean something’s wrong. Last checked 7d ago.

Overview

Tools4

What Putput MCP lets your agent do. Expand a tool for its parameters.

Self-reported~56 tokens of context

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked 3d ago

Recent health check succeeded.

8/8 checks healthy over the last 50d

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 17d ago via OSV.dev · @putput/mcp (npm)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars1Stargazers on the source repository.
npm downloads88Package downloads in the last 30 days.
Last commit8mo agoMost recent push to the default branch.
Install checkRunsOur sandbox started it; it then asked for an API key or config.
Tools exposed4Callable tools this server registers over MCP.
Directory activity1 viewsConfig copies, upvotes, and views on AllMCPs.

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

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

Claude Code

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

Cursor

Add to .cursor/mcp.json:

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

VS Code Copilot

Add to .vscode/mcp.json:

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

Windsurf

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

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:

Code
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

Read the full README View source on GitHub

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about Putput MCP

putput-mcp is an MCP server that lets AI agents upload, list, and manage files through PutPut. It can upload files from URLs, return CDN links, list files with optional prefix filtering and pagination, delete files by ID, and retrieve file details, statistics, and download URLs. No signup is required.

Configure putput-mcp by setting the PUTPUT_TOKEN environment variable to a PutPut API token and running the package with npx @putput/mcp. Each supported client uses its MCP configuration file or command, with client-specific examples provided in the README.

Get a free guest token without signing up by sending a POST request to https://putput.io/api/v1/auth/guest and using the returned token as PUTPUT_TOKEN.

Yes, putput-mcp is available remotely at https://putput.io/api/v1/mcp for clients that support Streamable HTTP. Authenticate by passing the PutPut token as a Bearer token in the Authorization header.

putput-mcp supports uploading a file from a URL, listing uploaded files with optional prefix filtering and pagination, deleting a file by ID, and retrieving file details, statistics, and a download URL.

Related MCP servers

All in File Systems All alternatives
Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewPutput MCP AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/putput-mcp?style=directory)](https://allmcps.com/mcp/putput-mcp)
HTML Embed
<a href="https://allmcps.com/mcp/putput-mcp"><img src="https://allmcps.com/api/badge/putput-mcp?style=directory" alt="Putput MCP on AllMCPs" /></a>