uploads.sh
Upload screenshots and files from coding agents and attach them to GitHub PRs
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/mcpAdd to Settings → Connectors → Add custom connector
https://agents.uploads.sh/mcpAdd to ~/.cursor/mcp.json
{
"mcpServers": {
"mcp": {
"url": "https://agents.uploads.sh/mcp"
}
}
}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.RequiredUPLOADS_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

REA
MCP serverCLI and MCP server that lets coding agents reverse engineer apps and binaries
Runs locally- Open source
- 464K GitHub stars
- Developer tools

Codebase Memory
MCP serverLocal MCP server that builds a code knowledge graph for AI coding agents
Runs locally- Open source
- 48.7K GitHub stars
- Knowledge and memory

GitHub
MCP serverOfficial MCP server connecting AI assistants to GitHub repos, issues and workflows
Not checked yet- Remote
- Open source
- 34.5K GitHub stars
- Developer tools

Serena MCP: the IDE for your agent
MCP serverMCP toolkit giving coding agents symbol-level code retrieval and editing
Runs locally- Open source
- 31.5K GitHub stars
- Developer tools

XERJ
MCP serverLocal search engine for AI agents with cited answers over your code and docs
Runs locally- Open source
- 19.2K GitHub stars
- Knowledge and memory

Ouroboros
MCP serverSpec-first layer that pins requirements and verifies results of AI coding agent work
Runs locally- Open source
- 6.4K GitHub stars
- Developer tools