# putput-mcp [Health: Active]

**Category:** 📂 File Systems  
**Repository:** https://github.com/putput-io/mcp  
**GitHub Stars:** 1  
**npm Downloads (last month):** 88  
**Views:** 1  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/putput-mcp

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

## Tools
Capabilities this server exposes over MCP:

- **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

## Claude Desktop Quick Installation
Install path detected from listing signals. Uses `npx` (confidence: high):

```json
"mcpServers": {
  "putput-mcp": {
    "command": "npx",
    "args": ["@putput/mcp"]
  }
}
```

## Documentation & 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

| 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

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

- **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