MCP 0.5.0 and CLI 0.4.1 are LIVE

MCP and CLI tools that let your AI agent deploy on MONA Cloud

MCP monacloud-mcp 0.5.0 and CLI monacloud 0.4.1 sign in with MONA Pass, inspect app hosts and costs and try sandbox. You agree to the cost before a local or public repository deployment.

Measured on September 5, 2026

  • First app host~150 seconds
  • Sample app from Git to HTTPS10–20 seconds
  • MCP local deployment with an existing host33 seconds
  • Delete and recreate the sample on an existing host31 seconds

Measurements of the sample app, not a service guarantee.

Local deployment

Can you deploy without GitHub?

Yes. Set MONACLOUD_TOKEN and run npx -y monacloud deploy in a project directory with a Dockerfile or package.json.

Local deployment guide
Run in your project directory
npx -y monacloud deploy

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. A first app host still takes ~150 seconds.

MCP setup

How do you install the MCP server?

Use the matching setup below. Claude.ai signs in with MONA Pass after the connector is added.

Claude Code · run in a terminal
claude mcp add --transport http monacloud https://mcp.monacloud.vn/mcp
Claude.ai · Settings → Connectors → Add custom connector
Name: MONA Cloud
URL: https://mcp.monacloud.vn/mcp
Codex · add to ~/.codex/config.toml
[mcp_servers.monacloud]
url = "https://mcp.monacloud.vn/mcp"
Gemini (Antigravity) · run in a terminal; verify with agy mcp list
agy mcp add monacloud https://mcp.monacloud.vn/mcp
Cursor · add to .cursor/mcp.json
{ "mcpServers": { "monacloud": { "url": "https://mcp.monacloud.vn/mcp" } } }
Giao thẳng cho AI tự cài
Cài MCP MONA Cloud giúp tôi rồi kiểm tra chạy được chưa. Nếu bạn là Claude Code: chạy `claude mcp add --transport http monacloud https://mcp.monacloud.vn/mcp`. Nếu là Codex: thêm `[mcp_servers.monacloud]` với `url = "https://mcp.monacloud.vn/mcp"` vào `~/.codex/config.toml`. Nếu là Gemini/Antigravity: chạy `agy mcp add monacloud https://mcp.monacloud.vn/mcp`. Cài xong gọi thử `cloud_domain_search` với tên tôi muốn mua rồi báo giá cho tôi.

Tools

Which tools should the agent use?

cloud_link checks account linking. cloud_prices and cloud_packages inspect costs and configurations. cloud_vps_create and cloud_db_create provision resources; cloud_job_status follows progress; cloud_services_list inspects the result.

Use cloud_service_start, cloud_service_stop and cloud_service_rebuild for operations. For Git apps, use cloud_app_create; cloud_agent_deploy is a separate agent runtime.

Safeguards

What are the deployment safeguards?

Use /api/sandbox/... or X-Vibecloud-Sandbox: 1 and confirm sandbox: true. Billable jobs end at succeeded, sandbox at done. Credentials and IP addresses in sandbox are fake.

Read the service first, then reveal credentials with X-Confirm: reveal only when needed. This endpoint is audited and limited to five reveals per hour per token. Never expose tokens, private keys or database passwords in chat or commits.

Stop still bills retained disk and IP. Do not remove budgets, retry expired tokens forever or duplicate a create request without checking the existing job.

SDK

Can you use Python or Node SDKs?

Yes. Read the SDK documentation under The MONA Group on GitHub before choosing methods.

Install the Python or Node SDK
pip install monacloud
npm install monacloud-cloud-sdk

The bundled OpenAPI and API reference define the HTTP contract.

Use llms.txt for the page index and llms-full.txt for full text.

App and billing tools LIVE

Which app and billing tools are LIVE?

Use cloud_app_host_list and cloud_app_list before creating anything.

LIVE

Apps

cloud_app_create, cloud_app_list, cloud_app_get, cloud_app_deploy, cloud_app_env_set, cloud_app_domain_add, cloud_app_logs, cloud_app_delete, cloud_app_host_list.

LIVE

Billing

cloud_plan_list, cloud_subscription_list, cloud_subscription_update, cloud_invoice_list, cloud_invoice_pdf, cloud_credit_redeem.

LIVE

CLI

plans, invoices, vps create --plan, deploy [--repo --branch --build --sandbox].

A new host is simulated with cloud_app_create and sandbox=true; agree to the cost before creating billable resources. Env updates replace the complete map and require a redeploy. Private repositories are being opened through GitHub App; the Git source requires public HTTPS repos; local uploads do not need GitHub access.

The sample app took 31 seconds to delete and recreate on an existing host. App hosts are billed like VPS resources hourly or monthly, with no extra app fee. Deleting an app keeps the host. See Git deployment for the measured example URL.

Prompt

A deployment prompt for your AI

Paste it as one block. The AI tries sandbox and confirms costs with you before creating billable resources.

The prompt contains no secrets.

Prompt to deploy this directory
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.

Get started

Your AI agent deploys on MONA Cloud after you agree to the cost

Add the MCP server, sign in with MONA Pass and let the agent try sandbox first. It reads prices and waits for your approval before creating billable resources.

Add the MCP server to Claude Code
claude mcp add --transport http monacloud https://mcp.monacloud.vn/mcp
  • Freesandbox simulation
  • 33 slocal deploy with an existing host
  • ~150 sfirst app host