# 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): plain-language guide — install, attach media to PRs/issues, agent setup
- [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 and bearer tokens
- [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
```

## Endpoints

- Web: https://uploads.sh
- API: https://api.uploads.sh
- Agents / MCP: https://agents.uploads.sh/mcp
- Public storage: https://storage.uploads.sh

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