# PutPut

Manage cloud-hosted files and storage through the PutPut platform. Streamlines data transfers by uploading files directly from external URLs and organizing them with ease. Enables quick listing, insp…

## Quick Start

```bash
# Connect this server (installs CLI if needed)
npx -y smithery mcp add putput-io/putput-mcp

# Browse available tools
npx -y smithery tool list putput-io/putput-mcp

# Get full schema for a tool
npx -y smithery tool get putput-io/putput-mcp upload_file

# Call a tool
npx -y smithery tool call putput-io/putput-mcp upload_file '{}'
```

## Direct MCP Connection

Endpoint: `https://putput-mcp--putput-io.run.tools`

**Required config:**
- `PUTPUT_TOKEN` (header) — Get one free without signup: curl -X POST https://putput.io/api/v1/auth/guest | jq .token

## Tools (4)

- `upload_file` — Upload a file from a URL to PutPut storage
- `list_files` — List uploaded files with optional filtering
- `delete_file` — Delete an uploaded file by ID
- `get_file_info` — Get details about a specific file

```bash
# Get full input/output schema for a tool
npx -y smithery tool get putput-io/putput-mcp <tool-name>
```
