# uploads.sh

> uploads.sh is a freemium MCP server for developer tools. Upload screenshots and files from coding agents and attach them to GitHub PRs. It can run locally on your machine or as a hosted remote server.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Starting price:** $10 a month
- **Platforms:** CLI, API, Web, self-hosted
- **Website:** https://uploads.sh
- **Repository:** https://github.com/buildinternet/uploads
- **MCP Registry name:** sh.uploads/mcp
- **Categories:** developer tools, files and documents
- **Listing updated:** 2026-11-14

## About

Coding agents can capture a screenshot but often cannot get it into a pull request, especially when they run with a GitHub App token or in a cloud session with no shell. uploads.sh gives them a stable public URL for each file the moment it exists, then gathers the staged files into a single attachments comment when the PR opens.

The hosted MCP server at agents.uploads.sh accepts files as raw bytes or as a URL, so an agent with no filesystem or `gh` can still attach evidence. A local stdio package, `@buildinternet/uploads`, is also published and needs a workspace token in `UPLOADS_TOKEN`. Re-uploading the same filename overwrites in place, so every embed of that URL updates at once.

Files tagged `--state before` and `--state after` are paired into a side-by-side table, and non-image files such as test reports, logs, JSON, CSV, PDFs and zips are listed in a file table. The service is open source under Apache-2.0 and can be self-hosted, or you can point a workspace at your own R2 or S3-compatible bucket.

## Features

- **Stable public URLs:** Each upload gets a URL that does not change when the same filename is uploaded again.
- **One managed PR comment:** Staged files are posted into a single comment that updates on every revision.
- **Before and after pairing:** Files tagged with a before or after state are shown side by side.
- **Remote MCP upload:** The hosted server takes bytes or a URL, so agents without a shell can attach files.
- **Annotated captures:** Boxes, arrows, labels and redactions can be drawn into a screenshot.
- **Bring your own bucket:** Connect Cloudflare R2 or an S3-compatible bucket for unmetered storage and custom domains.

## Good for

- Show before and after UI screenshots in a pull request opened by an agent
- Attach test reports and logs to a PR from a CI job
- Let a cloud coding session post proof of a change without a local shell
- Find an earlier screenshot of a page by its tagged path
- Require screenshots on UI pull requests through the GitHub App

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http mcp https://agents.uploads.sh/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://agents.uploads.sh/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "mcp": {
      "url": "https://agents.uploads.sh/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "mcp": {
      "type": "http",
      "url": "https://agents.uploads.sh/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "mcp": {
      "serverUrl": "https://agents.uploads.sh/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "mcp": {
      "type": "http",
      "url": "https://agents.uploads.sh/mcp"
    }
  }
}
```

## FAQ

### Is there a free plan?

Yes. Free is $0 with 250 MB of hosted storage and a 25 MB file limit; Pro is $10 per workspace per month (introductory) with 10 GB and 100 MB files.

### What does Pro unlock?

Only larger caps. Both plans include the CLI, hosted MCP server, REST API and GitHub App.

### Can I host it myself?

Yes, the service is Apache-2.0 and the README describes running the workers, storage and database yourself.

### What credential does the local package need?

A workspace bearer token in UPLOADS_TOKEN, created with the `uploads login` command.

### Is uploads.sh free?

uploads.sh has a free plan, with paid plans for more usage or features. Paid plans start at $10 a month.

### How do I add uploads.sh to Claude Code?

Run this command in your terminal: claude mcp add --transport http mcp https://agents.uploads.sh/mcp

### What are the best alternatives to uploads.sh?

The closest alternatives to uploads.sh are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/uploads-sh
