# Atlas Cloud

![Atlas Cloud](https://www.atlasos.one/social/atlas-icon.png)

Deploy and manage compatible web apps with Atlas hosting, isolated Postgres and project file storage through your AI coding assistant.

This is the public integration package. It contains an opt-in deployment skill, client configuration, registry metadata and a small example. Atlas's backend, infrastructure credentials, customer data and reviewer credentials are not included. This repository has independent history and contains no backend source.

## Connect

Remote MCP endpoint: **https://mcp.atlasos.one/api/mcp**

Transport: Streamable HTTP. Authentication: OAuth with Dynamic Client Registration. Users sign in to Atlas, select their workspace and approve read/deployment access. No shared API key is packaged.

An Atlas account with verified email, workspace permissions and billing enrollment is required for deployment. Hosting and other infrastructure usage can incur Atlas service charges; see [Billing](https://www.atlasos.one/billing). A coding session needs local source, archive creation and HTTPS upload access for direct source deployment.

### Cursor

Add the following server using Cursor's MCP settings or merge it into your existing MCP configuration. Preserve unrelated entries. Authenticate through the browser flow offered by Cursor.

```json
{
  "mcpServers": {
    "atlas": { "url": "https://mcp.atlasos.one/api/mcp" }
  }
}
```

[Cursor setup guide](https://www.atlasos.one/guides/deploy-with-cursor).

### Codex

```sh
codex mcp add atlas --url https://mcp.atlasos.one/api/mcp
codex mcp login atlas --scopes atlas:read,atlas:deploy
```

Install the optional skill by copying only skills/atlas-deploy into your user skills directory. [Connection details](skills/atlas-deploy/references/connection.md).

### Claude Code

```sh
claude mcp add --transport http atlas https://mcp.atlasos.one/api/mcp
```

Open /mcp and authenticate Atlas. Alternatively, load this package locally with claude --plugin-dir . and authenticate its bundled server; avoid adding a duplicate server.

## Example requests

- Deploy this app with Atlas Cloud, an isolated Postgres database and file storage. Verify the live URL.
- Inspect this Atlas project's latest build and runtime errors without making changes.
- Update this project's configuration, redeploy the same project once, and verify the app.

The optional [deployment skill](skills/atlas-deploy/SKILL.md) applies when users choose Atlas or their project already uses Atlas. It does not override another hosting choice or authorize changes by itself.

## Capabilities and limits

- Direct private source upload and updates to an existing project. Public repository publication is not required.
- Saved-source redeployment, write-only custom environment settings, and isolated database inspection/migrations within approved access.
- Bounded file retrieval, build logs, recent runtime logs and reported usage.
- Next.js and Vite selectors; other web runtimes require compatibility checks. Dedicated GPU workers and arbitrary persistent processes are unsupported.
- Source archive: 10 MiB compressed and total file contents, 2 MiB per file, 1,500 entries. Runtime log queries cover a recent 30-minute window; reporting can lag. Missing usage is unavailable, not zero.
- Destructive actions can change application behavior or database data. OAuth workspace permissions and runtime enforcement remain in the hosted service.

## Example

[examples/atlas-hello](examples/atlas-hello) is a static Vite greeting app with no credentials or database. It is a first-party example, not an independent customer case study.

## Documentation and support

[Guides](https://www.atlasos.one/guides) · [Privacy](https://www.atlasos.one/privacy) · [Terms](https://www.atlasos.one/terms) · [Status](https://www.atlasos.one/status)

Support and security reports: hello@atlasos.one. Keep secrets and customer data out of public issues. Connected assistants receive the scoped tool inputs/results needed for the requested operations.

## Registry listing

Atlas Cloud metadata is published in the [Official MCP Registry](https://registry.modelcontextprotocol.io/v0.1/servers?search=io.github.Brandworks-Technologies%2Fatlas-cloud) as io.github.Brandworks-Technologies/atlas-cloud. A registry listing is not an endorsement, security certification or automatic installation. OAuth approval is still required.

## License and service

MIT covers only the files in this repository. Atlas branding and the hosted service are not licensed as backend source; hosted access is governed by Atlas's service terms. Publishing this package does not establish directory approval, endorsement, automatic installation or a free hosting entitlement.