# uploads.sh [Health: Active]

**Category:** 🔄 Version Control  
**Repository:** https://github.com/buildinternet/uploads  
**GitHub Stars:** 20  
**npm Downloads (last month):** 4369  
**Views:** 3  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/uploads-sh

## Description
Host files from coding agents; stage on a branch and attach to GitHub PRs.

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

```json
"mcpServers": {
  "uploads-sh": {
    "command": "npx",
    "args": ["-y","@buildinternet/uploads"]
  }
}
```

## Documentation

## What uploads.sh MCP server does

The uploads.sh MCP server connects coding agents to the uploads.sh artifact service. It handles screenshots, screen recordings, test reports, logs, JSON, CSV, Markdown, PDFs, and zip archives. Uploaded files receive stable public URLs that can be used in pull requests and issues.

The service is designed around work in progress on a branch. Files can be staged before a pull request exists, then promoted into one managed GitHub comment when the pull request opens. Files attached to an existing pull request or issue are also collected into that comment, which is updated on later revisions rather than replaced with separate comments.

Uploads can include metadata such as a page path and a before or after state. Matching before-and-after files can be rendered side by side. Other media appears below the comparison, while non-media artifacts are listed with their type and size.

## How it works

The hosted MCP endpoint is available at `https://agents.uploads.sh/mcp` and is registered as `sh.uploads/mcp`. Agents can send an artifact as file bytes or provide a URL. The local alternative is the `uploads mcp` command from the published npm package.

The command-line workflow uses `uploads put` to stage files, `uploads attach` to add files directly to an open pull request or issue, and `uploads staged` to inspect what will be attached. The GitHub App can promote staged files when a pull request opens. Without that app, `uploads attach --promote` performs the promotion after the pull request has been created.

Reusing a filename overwrites the existing upload without changing its URL. Workspaces separate tenants, budgets, and key policies. Uploaded files are public URLs; links for private-repository attachments are difficult to guess, but anyone with a link can view the file.

## Setup and configuration

For the hosted connection, add `https://agents.uploads.sh/mcp` to an MCP-compatible client. The README provides commands for Claude Code and Codex, and also documents an OpenCode command, although OpenCode is not part of the supported-client list used here.

For local use, install the CLI with `npm install --global @buildinternet/uploads`, then run `uploads login`. Authentication supports GitHub or a magic link. After signing in, create a workspace or accept an invitation. The commands can also be run through `npx @buildinternet/uploads` without a global installation.

A GitHub App connection is used to promote staged files automatically.

## Tools and capabilities

- Upload files through the hosted MCP service as bytes or a URL.
- Stage artifacts on the current branch before a pull request exists.
- Attach files to an existing GitHub pull request or issue.
- Create or update one managed attachments comment per pull request.
- Pair before-and-after captures using metadata or filename conventions.
- Capture and annotate a page with the CLI's screenshot command.
- Browse workspace uploads and retrieve raw URLs or copy-ready embeds.

## Limitations and notes

The uploads.sh MCP server is under active development, so its APIs may change. Do not upload secrets or sensitive interface content: hosted files are public, and anyone who obtains a URL can view the file.

The README names Claude Code, Codex, and OpenCode connection commands. It does not document MCP tool names or a detailed request schema, so implementations should rely on the current service documentation rather than assuming a fixed tool interface.

_Full upstream README: https://allmcps.com/mcp/uploads-sh/readme_