Quick start with MONA Cloud

Sign in with MONA Pass, receive 20,000 VND signup credit and try a local or public Git deployment in sandbox. You agree to the host cost before any billable resource is created.

View Markdown

Can you deploy without GitHub?

Yes. Set MONACLOUD_TOKEN and run npx -y monacloud deploy in the current project directory with a Dockerfile or package.json. CLI monacloud 0.4.1 downloads MCP through npx. Add --sandbox for a free simulation, --git for the current remote or --repo <url> for an explicit public repository.

MCP monacloud-mcp 0.5.0 provides cloud_app_detect(local_dir) for offline stack, port and Dockerfile detection, then cloud_app_create({local_dir}) to zip and upload the project. The wallet balance is read through GET /api/me.

The API uses POST /api/apps with source: "upload" (no repo_url), then POST /api/apps/{id}/upload with multipart archive (zip or tar.gz, at most 80 MB / 83886080 bytes) and build_path (default /). Put project files at the archive root, with no wrapper directory. Poll GET /api/jobs/{id} after upload and verify HTTPS. The server removes node_modules/, .git/, .env* and *.pem, and blocks zip-slip.

Measured on September 5, 2026 (evening): API upload to HTTPS 200 took 112 seconds including the image build; MCP local deployment took 33 seconds with an existing host. The first app host takes ~150 seconds; the sample app deploys in 10–20 seconds with a public HTTPS URL. These are measurements, not a guarantee for every project.

See the local deployment guide.

What do you need for the first five minutes?

An email address, your application repository and an AI tool are enough to start learning the flow. Five minutes does not include payment processing or a complete production deployment.

Open the console, register with MONA Pass and follow account verification. Use the wallet for VietQR top-ups; check the recipient and amount before paying.

September 4 test snapshot: VietQR top-ups report a merchant configuration blocker, so do not pay without a valid QR. Call support at 1900 636 648.

How do you connect your agent?

Set up the project and sign in to MCP

npx monacloud init
npx -y monacloud-mcp login

Claude.ai · ChatGPT · Cursor (connect by URL): open Settings → Connectors → Add custom connector, paste the URL, then sign in with MONA Pass. In Cursor, set "url": "https://mcp.monacloud.vn/mcp" in mcp.json; in Codex, set [mcp_servers.monacloud] url = "https://mcp.monacloud.vn/mcp".

Claude.ai · ChatGPT · Cursor (connect by URL)

https://mcp.monacloud.vn/mcp

Use the MCP setup, read prices with cloud_prices and create a simulated resource with cloud_vps_create. CLI monacloud 0.4.1 also provides deploy for public Git repositories; see the app example below.

How do you test with curl?

Set your token locally, never in chat. The sandbox header keeps this request simulated.

Set environment

export MONACLOUD_API="https://api.monacloud.vn"
export MONACLOUD_TOKEN="<your-token>"

Create a sandbox VPS

curl -sS -X POST "$MONACLOUD_API/api/lxc" \
  -H "Authorization: Bearer $MONACLOUD_TOKEN" \
  -H "X-Vibecloud-Sandbox: 1" \
  -H "Content-Type: application/json" \
  -d '{"app_name":"app-demo","cpu":1,"ram_gb":1,"disk_gb":10}'

Poll the job

export JOB_ID="<returned-job-id>"
curl -sS "$MONACLOUD_API/api/jobs/$JOB_ID" \
  -H "Authorization: Bearer $MONACLOUD_TOKEN"

Replace the example job ID with the returned id. Sandbox finishes at done; billable provisioning finishes at succeeded. Read result.service_id and inspect the service before revealing credentials.

When can you create billable resources?

Read pricing and confirm the wallet balance. After you agree to the cost, remove X-Vibecloud-Sandbox: 1 from the create request; it now creates billable infrastructure.

For a self-managed VPS, use the separate credentials endpoint with X-Confirm: reveal, deploy over SSH and test the live URL. For public Git apps, use /api/apps as shown below. Never SSH to sandbox addresses in 10.99.x.x.

How do you deploy a public Git repository?

Use CLI monacloud 0.4.1 with MCP monacloud-mcp 0.5.0:

Sandbox run, then billable deployment

npx -y monacloud deploy --repo https://github.com/themonagroup/monacloud-example-node --branch main --build dockerfile --sandbox
npx -y monacloud deploy --repo https://github.com/themonagroup/monacloud-example-node --branch main --build dockerfile

The first command simulates deployment; the second asks you to agree to the cost. Alternatively use MCP cloud_app_create or POST /api/apps. The host is billed hourly or monthly; apps have no extra charge. The sample HTTPS URL uses Let’s Encrypt. Deleting and recreating the sample on an existing host took 31 seconds. Private repositories are being opened through GitHub App. See the full walkthrough.

What prompt can you give your AI?

Prompt to deploy this directory · no secrets

Deploy the project in this directory with MONA Cloud. MONACLOUD_TOKEN is in the environment. Use cloud_app_detect then cloud_app_create with local_dir. Read prices and the wallet, try sandbox and confirm costs before creating billable resources, poll the job and verify HTTPS, then give me the URL. Keep secrets out of chat.