# rbx-cloud-cli

A CLI and an MCP server for the [Roblox Open Cloud API](https://create.roblox.com/docs/cloud).

- **CLI** — commands for data stores, place publishing, assets, universes, bans,
  notifications, users, groups, inventories and Luau execution, plus `rbx-cloud-cli api`,
  a raw escape hatch that reaches *any* endpoint.
- **MCP server** — `rbx-cloud-cli mcp` exposes five small tools so an AI agent can
  discover and call all 825 endpoints without loading an API reference into its
  context.

📖 **Full documentation: <https://lucasx150.github.io/rbx-cloud-cli/>**

## Quickstart

```bash
rokit add lucasx150/rbx-cloud-cli                 # or grab a binary from Releases

rbx-cloud-cli auth set --key <api-key>            # create one at create.roblox.com/dashboard/credentials
rbx-cloud-cli auth set --user-id <your-user-id>   # default owner for asset uploads

rbx-cloud-cli datastore --universe 123 get PlayerData user_1
```

Add the MCP server to Claude Code:

```bash
claude mcp add roblox-cloud-api -- rbx-cloud-cli mcp
```

or to any other agent's MCP config:

```json
{
  "mcpServers": {
    "roblox-cloud-api": { "command": "rbx-cloud-cli", "args": ["mcp"] }
  }
}
```

## Development

```bash
npm install
npm run build        # bundle dist/index.js (the rbx-cloud-cli bin)
npm test             # offline vitest suite
npm run build:spec   # regenerate spec/ from the Roblox API spec
npm run build:bin    # standalone binary for this platform
```

The docs site lives in [`website/`](website/) (`npm run start` there for live
preview). Releases are built by CI on a `v*` tag.

## License

MIT