{
  "markdown": "# @putput/mcp\n\nFile uploads for AI agents. Upload, list, and manage files from Claude Code, Cursor, Windsurf, and VS Code Copilot — no signup required.\n\n## Quick Start\n\nGet a free API token (no signup):\n\n```bash\ncurl -X POST https://putput.io/api/v1/auth/guest | jq .token\n```\n\n### Claude Code\n\n```bash\nclaude mcp add putput -- npx @putput/mcp -e PUTPUT_TOKEN=pp_your_token\n```\n\n### Cursor\n\nAdd to `.cursor/mcp.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"putput\": {\n      \"command\": \"npx\",\n      \"args\": [\"@putput/mcp\"],\n      \"env\": {\n        \"PUTPUT_TOKEN\": \"pp_your_token\"\n      }\n    }\n  }\n}\n```\n\n### VS Code Copilot\n\nAdd to `.vscode/mcp.json`:\n\n```json\n{\n  \"servers\": {\n    \"putput\": {\n      \"command\": \"npx\",\n      \"args\": [\"@putput/mcp\"],\n      \"env\": {\n        \"PUTPUT_TOKEN\": \"pp_your_token\"\n      }\n    }\n  }\n}\n```\n\n### Windsurf\n\nAdd to `~/.codeium/windsurf/mcp_config.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"putput\": {\n      \"command\": \"npx\",\n      \"args\": [\"@putput/mcp\"],\n      \"env\": {\n        \"PUTPUT_TOKEN\": \"pp_your_token\"\n      }\n    }\n  }\n}\n```\n\n### Remote (Streamable HTTP)\n\nIf your client supports remote MCP servers:\n\n```\nhttps://putput.io/api/v1/mcp\n```\n\nPass your token as a Bearer token in the Authorization header.\n\n## Tools\n\n| Tool | Description |\n|------|-------------|\n| `upload_file` | Upload a file from a URL to PutPut and get a CDN link back |\n| `list_files` | List uploaded files with optional prefix filter and pagination |\n| `delete_file` | Delete a file by ID |\n| `get_file_info` | Get file details, stats, and download URL |\n\n## How It Works\n\n1. Your AI agent calls `upload_file` with a URL\n2. PutPut uploads the file to Cloudflare R2\n3. You get back a CDN URL — done\n\nNo AWS, no config, no deploy step. Files are served from 300+ edge locations with $0 egress.\n\n## Pricing\n\n- **Guest:** 1 GB free, no signup, 14-day expiry\n- **Free:** 10 GB free, requires account\n- **Pro:** From $9/mo for 50 GB, unlimited bandwidth, $0 egress\n\n## Links\n\n- **Website:** https://putput.io\n- **API Docs:** https://docs.putput.io\n- **SDK:** `npm install @putput/sdk`\n- **CLI:** `npx @putput/cli upload <file>`\n- **GitHub:** https://github.com/putput-io\n",
  "bytes": 2171,
  "sha": "e03cc2a1f3b23b2924509b8e9a86aa8d40082ddc9bda789a4842dcd7cda3e5e5",
  "repo_slug": "putput-io/mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_putput_io_dev_putput_mcp_56e22665/readme"
}