Skip to content
MCP server

uploads.sh

Upload screenshots and files from coding agents and attach them to GitHub PRs

Responds, sign-in requiredStatus and history

The server answered 21 hours ago but needs an account or API key, so we could not list its tools.

Pricing
Freemium
Platforms
CLI, API, Web
Runs
Locally or Remotely
Access
Needs an account or API key
Version
0.63.2
Listing updated
3 days ago

About uploads.sh

uploads.sh is a freemium MCP server for developer tools. It can run locally on your machine or as a hosted remote server.

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.

Install

Run in a terminal

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

Add to Settings → Connectors → Add custom connector

https://agents.uploads.sh/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "mcp": {
      "url": "https://agents.uploads.sh/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

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

Add to ~/.codeium/windsurf/mcp_config.json

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

Add to your client's MCP settings (most use this shape)

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

Configuration

  • UPLOADS_TOKENWorkspace bearer token (up_<workspace>_…). Mint with uploads login.Required
  • UPLOADS_WORKSPACEWorkspace name. Inferred from the token when omitted.
  • UPLOADS_API_URLAPI origin. Defaults to https://api.uploads.sh.

What it does

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

Pricing

Freemium, from $10 a month

Free plan; Pro $10 per workspace per month (introductory); open source and self-hostable

Prices change. Check uploads.sh before you buy.

uploads.sh 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 to uploads.sh

  1. REA

    MCP server

    CLI and MCP server that lets coding agents reverse engineer apps and binaries

    Runs locally
    • Open source
    • 464K GitHub stars
    • Developer tools
  2. Codebase Memory

    MCP server

    Local MCP server that builds a code knowledge graph for AI coding agents

    Runs locally
    • Open source
    • 48.7K GitHub stars
    • Knowledge and memory
  3. GitHub

    MCP server

    Official MCP server connecting AI assistants to GitHub repos, issues and workflows

    Not checked yet
    • Remote
    • Open source
    • 34.5K GitHub stars
    • Developer tools
  4. MCP toolkit giving coding agents symbol-level code retrieval and editing

    Runs locally
    • Open source
    • 31.5K GitHub stars
    • Developer tools
  5. XERJ

    MCP server

    Local search engine for AI agents with cited answers over your code and docs

    Runs locally
    • Open source
    • 19.2K GitHub stars
    • Knowledge and memory
  6. Ouroboros

    MCP server

    Spec-first layer that pins requirements and verifies results of AI coding agent work

    Runs locally
    • Open source
    • 6.4K GitHub stars
    • Developer tools