# uploads.sh

> File hosting for agents and humans — hosted CLI, agent skill, and MCP server. Open source for self-hosting.

Access requires a workspace — create your own with a linked GitHub account, or be invited to an existing one. Hosted files are public (including media attached to private repositories). Do not upload secrets or sensitive UI. APIs may change without notice while the project is in active development.

Expanded one-file guide: [llms-full.txt](https://uploads.sh/llms-full.txt).
Landed on the GitHub monorepo instead? Start at [repo llms.txt](https://github.com/buildinternet/uploads/blob/main/llms.txt) (product use vs contribute).

## Start here

- [Home](https://uploads.sh/): product overview and copyable install commands
- [Full agent guide (llms-full.txt)](https://uploads.sh/llms-full.txt): install, auth, stage/attach loops, hosted MCP contracts, cautions
- [Docs](https://uploads.sh/docs): overview, one-time install, and links to the focused guides below
- [Docs: attach & share](https://uploads.sh/docs/attach-pull-request-images): attach media to PRs/issues, stage screenshots before a PR exists, pair a before/after with --state, get a URL for any file, capture a screenshot, annotate with callouts/redactions
- [Docs: annotate a screenshot](https://uploads.sh/docs/attach-pull-request-images#annotate): bake boxes, arrows, labels, freeform strokes, and solid redactions into a capture (`uploads screenshot --annotate` or `uploads annotate`)
- [Docs: GitHub App](https://uploads.sh/docs/github-app): recommended install for bot-posted attachment comments, private-repo PR/issue titles, and zero-CLI promotion of branch-staged screenshots when a PR opens
- [Docs: comment config](https://uploads.sh/docs/comment-config): commit `.uploads.yml` to a repo to control image width, inline-image caps, caption metadata, the file-page link, and an optional note on the attachments comment (bot, hosted MCP, REST, and CLI gh-fallback all honor it); repo config beats the workspace default, which beats automatic behavior
- [Docs: agents](https://uploads.sh/docs/agents): install the agent skills and MCP server, or the all-in-one Claude Code plugin
- [Docs: reference](https://uploads.sh/docs/reference): manage uploads (list/delete/usage) and what to know before relying on it
- [Docs: plans & limits](https://uploads.sh/docs/limits): storage/file-size/member caps per plan, behavior at each cap, and the GitHub attachment-cap comparison
- [Docs: bring your own bucket](https://uploads.sh/docs/byo-bucket): point a workspace at your own Cloudflare R2 bucket instead of the shared one — setup steps, the serving matrix, what's degraded, disconnecting (in preview)
- [Agent guide](https://uploads.sh/github-screenshots): how to get coding agents to upload screenshots & video to GitHub PRs and issues
- [Auth for agents](https://uploads.sh/auth.md): self-serve and invitation enrollment, bearer tokens, and the hosted-MCP OAuth authorization server
- [Source & docs](https://github.com/buildinternet/uploads): repository, roadmap, and operator docs
- [Repo agent entrypoint](https://github.com/buildinternet/uploads/blob/main/llms.txt): monorepo vs product audiences
- [Enrollment](https://github.com/buildinternet/uploads/blob/main/docs/enrollment.md): how `uploads login` works
- [API](https://github.com/buildinternet/uploads/blob/main/docs/api.md): REST surface for workspace-scoped files
- [OpenAPI (summary)](https://uploads.sh/.well-known/openapi.json): machine-readable API surface
- [CLI skill](https://github.com/buildinternet/uploads/tree/main/skills/uploads-cli): host a file and embed it in a PR/issue (artifact URL is in the skills index)
- [Annotate skill](https://github.com/buildinternet/uploads/tree/main/skills/annotate-screenshots): JSON annotation spec and workflow for callouts and redaction

## Install

```bash
npm install -g @buildinternet/uploads && uploads login
uploads install
npx skills add buildinternet/uploads --skill uploads-cli
```

Remote MCP (HTTP):

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

Claude Code plugin (bundles the skills, the hosted MCP server, and the /uploads:attach command):

```text
/plugin marketplace add buildinternet/uploads
/plugin install uploads@uploads
```

## Endpoints

- Web: https://uploads.sh
- API: https://api.uploads.sh
- Agents / MCP: https://agents.uploads.sh/mcp
- Public storage: https://storage.uploads.sh
- oEmbed (share pages `/f/…`, `/g/…`): https://uploads.sh/oembed?url=<page-url>&format=json

## Machine-readable discovery

- Full agent guide: https://uploads.sh/llms-full.txt
- Integration surfaces (API, MCP, CLI + how each authenticates): https://uploads.sh/.well-known/integrations.json
- API catalog: https://uploads.sh/.well-known/api-catalog
- OpenAPI (summary): https://uploads.sh/.well-known/openapi.json (also /openapi.json)
- MCP server card: https://uploads.sh/.well-known/mcp/server-card.json
- Agent skills index: https://uploads.sh/.well-known/agent-skills/index.json
- robots / sitemap: https://uploads.sh/robots.txt · https://uploads.sh/sitemap.xml

## Legal

- [Terms of Service](https://uploads.sh/terms): access, plans and payment, acceptable use, and takedowns
- [Privacy Policy](https://uploads.sh/privacy): what data the service collects and retains
- Operated by [Build Internet](https://buildinternet.com)

## Do not crawl

Enrollment invite pages (`/invite`) and the browser console (`/console`) are private operator surfaces. See https://uploads.sh/robots.txt.