English Français العربية

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

Official registry AI and agents

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

Source code Documentation

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

Remote (streamable-http)
Claude Code 
claude mcp add --transport http putput-mcp 'https://putput.io/api/v1/mcp'
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "putput-mcp": {
            "type": "http",
            "url": "https://putput.io/api/v1/mcp"
        }
    }
}
NPM package @putput/mcp
Claude Code 
claude mcp add putput-mcp -e 'PUTPUT_TOKEN=<your putput_token>' -- npx -y @putput/mcp@0.0.3
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "putput-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "@putput/mcp@0.0.3"
            ],
            "env": {
                "PUTPUT_TOKEN": "<your putput_token>"
            }
        }
    }
}

Environment variables

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

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. @putput/mcp
  2. Quick Start
  3. Tools
  4. How It Works
  5. Pricing
  6. Links

@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

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

Frequently asked questions

What is io.github.putput-io-dev/putput-mcp?

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

How do I install io.github.putput-io-dev/putput-mcp?

It runs as a remote server. In Claude Code: claude mcp add --transport http putput-mcp 'https://putput.io/api/v1/mcp'. For other clients, paste the JSON configuration from this page into their MCP settings.

Does io.github.putput-io-dev/putput-mcp need an API key?

Yes. It expects PUTPUT_TOKEN, which you set in its configuration.

Is io.github.putput-io-dev/putput-mcp open source?

Its code is public on GitHub, but the repository does not declare a standard license.

Who maintains io.github.putput-io-dev/putput-mcp?

It is published by putput-io. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.