@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_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

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

putput-mcp

Quick Install