# uploads.sh

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

Access is by invitation. 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.

## Start here

- [Home](https://uploads.sh/): product overview and copyable install commands
- [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, get a URL for any file, capture a screenshot
- [Docs: agents](https://uploads.sh/docs/agents): install the agent skill 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
- [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): invitation enrollment, bearer tokens, and the hosted-MCP OAuth authorization server
- [Source & docs](https://github.com/buildinternet/uploads): repository, roadmap, and operator docs
- [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)

## 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

- API catalog: https://uploads.sh/.well-known/api-catalog
- 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, 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.