MCP tool reference
Every tool the Cloudrizz MCP server exposes to ChatGPT and Claude. Read-only tools and most edit tools are open to any member; a few sensitive operations — merging, deleting branches, database/storage/email changes, and cron writes — require an admin role, and creating or cloning apps requires app-create permission. Tool names and parameters are defined in the shared MCP schema.
Before you start
Connect the server first — see Connect ChatGPT & Claude. For the order to call these in, see Build & deploy an app.
Account & session
whoami- Return the current user and organization context — start here to resolve app/org ids.
Apps & files
create_app- Create a new app (from: scaffold = new from the starter template; from: clone = a copy of an existing app, admin-gated).
list_files- List the files in an app's working tree.
read_file- Read the contents of a single file.
search_files- Search across all of an app's text files at once (grep-like) — find a definition or every usage before a rename.
edit_file- Write or modify a file in the working tree.
Versions & migrations
save_version- Commit the current working tree as a new version.
list_versions- List the commit/version history.
list_migrations- List the database migrations the app defines.
Branches & pull requests
manage_branch- Create, list, or delete branches (action: create/list/delete). Delete is admin-gated; branches usually auto-create on first write.
manage_pull_request- Open, list, get, or close pull requests (action: open/list/get/close). Opening a PR is the only way AI commits reach main; get returns canFastForward so you can see if a merge is clean.
merge_pull_request- Merge a PR into its target branch (owner/admin gated). Disjoint changes auto-merge; same-file conflicts are handed back to you to resolve — never AI-resolved.
reset_playground- Wipe your personal preview sandbox (database and storage).
Deploy & logs
deploy_app- Build and publish the app to the edge (prod, branch, or preview).
get_deployment_logs- Retrieve recent build/runtime logs for an app and environment.
rollback_production- Emergency recovery — instantly re-publish the previous successful production build.
Verify & test
verify_page- Check a deployed route (mode: fetch = raw server-side HTTP; render = real headless browser reporting runtime errors + post-JS DOM). Verify your work instead of building blind.
run_tests- Run the app's unit + e2e tests (api/test.js) against a branch's preview deploy.
get_test_insights- Test-health analytics: pass-rate over time, the most-failing tests, and flaky-test detection.
Domains
add_domain- Attach a custom domain; returns the DNS records to add.
Environment variables
manage_app_env- List, set, or delete environment variables + secrets (action: list/set/delete). Set/delete are admin-gated; secrets are encrypted and injected at deploy.
Resources & uploads
manage_resource- Attach, list, or detach an optional binding — cache, AI, or email (action: attach/list/detach). Attach/detach are admin-gated.
request_upload_url- Get a URL to upload a large asset.
Data & storage
query_app_db- Run a SQL query against the app's database (admin gated).
query_app_search- Query, seed, or inspect the app's semantic search index (env.SEARCH; admin gated, paid plan).
manage_app_storage- List, read, or delete objects in the app's file storage (admin gated).
set_image_optimize- Turn automatic responsive-WebP optimization of env.STORAGE image uploads on or off (admin gated).
manage_email_sender- Verify a sending domain and set the app's default From address (admin gated).
Scheduled jobs (cron)
manage_cron- Create/update, list, delete, or run a scheduled job (action: set/list/delete/run). Handlers live in api/cron.js; all but list are admin-gated.
SEO & discoverability
update_seo_config- Update the app's SEO config (meta tags, sitemap, robots, llms.txt).
Feedback
report_experience- Send Cloudrizz feedback about tool friction — anything slow, confusing, or missing while building.