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

Official4 toolsLive

by putput-io · JavaScript

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

🛠️ Key Features

Upload and manage files for AI agent workflows
List stored files and access metadata
No signup required for basic usage
Supports integration with Claude Code, Cursor, Windsurf, and VS Code Copilot

🚀 Use Cases

Uploading assets used by AI agents during prompts
Quick file management for agent-driven workflows
Token-based access via guest API token

⚡ Developer Benefits

Lightweight, no-signup onboarding for rapid experiments
Clear readme excerpt guides quick setup and usage
Compatibility with popular AI tooling ecosystems

⚠️ Limitations

Source data mentions 4 tools and a guest token flow but does not detail all endpoints or security considerations
Documentation is a readme excerpt; full API reference not provided in the snippet

Captured live from the server via tools/list.

upload_file

Upload a file from a URL to PutPut storage

Parameters5

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

Raw schema

{
  "type": "object",
  "properties": {
    "url": {
      "type": "string",
      "description": "URL of the file to upload"
    },
    "filename": {
      "type": "string",
      "description": "Optional filename override"
    },
    "visibility": {
      "type": "string",
      "enum": [
        "public",
        "private"
      ],
      "description": "File visibility (default: public)"
    },
    "prefix": {
      "type": "string",
      "description": "Optional path prefix for organization"
    },
    "metadata": {
      "type": "object",
      "description": "Optional key-value metadata"
    }
  },
  "required": [
    "url"
  ]
}

list_files

List uploaded files with optional filtering

Parameters3

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

Raw schema

{
  "type": "object",
  "properties": {
    "prefix": {
      "type": "string",
      "description": "Filter by prefix"
    },
    "limit": {
      "type": "number",
      "description": "Max results (default: 50, max: 200)"
    },
    "cursor": {
      "type": "string",
      "description": "Pagination cursor"
    }
  }
}

delete_file

Delete an uploaded file by ID

Parameters1

string

required

File ID to delete

Raw schema

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "File ID to delete"
    }
  },
  "required": [
    "id"
  ]
}

get_file_info

Get details about a specific file

Parameters1

string

required

File ID to look up

Raw schema

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "File ID to look up"
    }
  },
  "required": [
    "id"
  ]
}

README.md2 KBView on GitHub

@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

Install

Tools (4)

upload_filelist_filesdelete_fileget_file_info

Configuration

Environment variables

PUTPUT_TOKENrequiredsecret

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

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "putput-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@putput/mcp@0.0.3"
      ],
      "env": {
        "PUTPUT_TOKEN": "<YOUR_PUTPUT_TOKEN>"
      }
    }
  }
}

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

🛠️ 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