# Connect your AI agent to MONA Cloud

MCP monacloud-mcp 0.3.2 and CLI monacloud 0.3.1 are LIVE. Sign in with MONA Pass, inspect app hosts and costs, try sandbox, then approve a real public-repository deployment. The first host takes ~150 seconds; the sample app deploys in 10–20 seconds with HTTPS.

## How do you install the MCP server?

For Claude Desktop or Cursor, merge this server into the client MCP configuration:


```json
{
  "mcpServers": {
    "monacloud": {
      "command": "npx",
      "args": ["-y", "monacloud-mcp"]
    }
  }
}
```

For command-line clients:


```bash
claude mcp add monacloud -- npx -y monacloud-mcp
codex mcp add monacloud -- npx -y monacloud-mcp
npx -y monacloud-mcp login
```

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

## What are the deployment safeguards?

Use `/api/sandbox/...` or `X-Vibecloud-Sandbox: 1` and confirm `sandbox: true`. Real 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.

## Can you use Python or Node SDKs?


```bash
pip install monacloud
npm install monacloud-cloud-sdk
```

Read the SDK documentation under [The MONA Group on GitHub](https://github.com/themonagroup) before choosing methods. The bundled [OpenAPI](/openapi.json) and [API reference](/docs/api) define the HTTP contract.

Use [llms.txt](/llms.txt) for the page index and [llms-full.txt](/llms-full.txt) for full text.

## Which app and billing tools are LIVE?

- `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`.
- `cloud_plan_list`, `cloud_subscription_list`, `cloud_subscription_update`, `cloud_invoice_list`, `cloud_invoice_pdf`, `cloud_credit_redeem`.
- CLI: `plans`, `invoices`, `vps create --plan`, `deploy [--repo --branch --build --sandbox]`.

Use `cloud_app_host_list` and `cloud_app_list` before creating anything. A new host is simulated with `cloud_app_create` and `sandbox=true`; confirm costs before real creation. Env updates replace the complete map and require a redeploy. Private repositories are being opened through GitHub App; only public HTTPS repos are supported in this release.

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](/docs/deploy-nodejs) for the measured example URL.

## Prompt for your AI


```text
Deploy my public repository with cloud_app_create. Inspect cloud_app_list, cloud_app_host_list, cloud_plan_list, cloud_prices and cloud_balance. Simulate a new host with sandbox=true, report the cost and wait for approval before a real deploy. Poll the job, inspect cloud_app_get/cloud_app_logs and test HTTPS. Keep secrets out of chat.
```

[Read this page](https://monacloud.vn/en/ai-agent)