AI agents
Let coding agents deploy, read logs, and change the database.
MCP server
The CLI runs as an MCP server over stdio. It uses the CLI's login and the projects linked in its working directory.
npm i -g clouzark && clouzark login
claude mcp add clouzark -- clouzark mcp # Claude Code
claude mcp add clouzark -- clouzark mcp --read-only # reading tools onlyFor other clients (Cursor, Windsurf, VS Code), add a server with command clouzark and args ["mcp"]:
{
"mcpServers": {
"clouzark": { "command": "npx", "args": ["-y", "clouzark", "mcp"] }
}
}--project <ref> and --db <ref> set the default projects. With --read-only, only reading tools are exposed and SQL runs in a read-only transaction.
| Tools | |
|---|---|
| Reading | whoami, list_projects, list_deployments, get_deployment, get_runtime_logs, list_env, list_domains, list_environments, list_databases, get_api_keys, execute_sql, list_migrations, generate_types, list_backups, list_cron_jobs, list_cron_runs, list_app_crons, list_app_cron_runs |
| Changing | create_project, deploy, redeploy, promote_deployment, rollback, sync_repo, set_env, link_database, remove_env, add_domain, route_domain, remove_domain, create_environment, update_environment, delete_environment, create_database, apply_migration, create_cron_job, update_cron_job, run_cron_job, delete_cron_job, create_app_cron, update_app_cron, run_app_cron, delete_app_cron |
apply_migration also writes the migration file into clouzark/migrations/, so the change stays in the repo.
To debug a running app, get_runtime_logs returns what it printed to stdout and stderr. get_deployment returns the build log. Pass the cursor from one call as after_id in the next to get only new lines.
Repo instructions
clouzark initWrites a Clouzark section into AGENTS.md, describing the linked projects and how to deploy and migrate. If the repo has a CLAUDE.md, it imports AGENTS.md. Running init again refreshes only that section.
llms.txt
These docs are available as plain text for agents:
- docs.clouzark.com/llms.txt — an index of every page
- docs.clouzark.com/llms-full.txt — every page in one file
- Any page as Markdown: add
.mdto its URL, for exampledocs.clouzark.com/quickstart.md - clouzark.com/llms.txt — a one-page summary of the CLI, MCP tools, and APIs