MCP tool reference

Connect the server first, see Connect ChatGPT & Claude. For the order to call these in, see Build & deploy an app.

whoami

Return the current user and organization context, start here to resolve app/org ids.

create_app

Create a new app (from: scaffold = new from a starter template, type static, widget or game; 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.

find_replace

Apply literal find→replace pairs across many files in one commit, the multi-file rename tool (whole-word option, glob scope, dry-run preview).

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.

purge_file_history

Irreversibly scrub a file's contents out of past versions (for a secret/personal data that was committed then removed). Dry-run by default; preserves the current version. Admin only.

manage_branch

Create, list, delete, describe, or coordinate branches (action: create/list/delete/set_purpose/reserve_migration). 'list' is the parallel-work board: per branch it shows purpose, ahead/behind vs main (did main move?) and its migrations, plus the next free migration number across all branches. 'set_purpose' records what a branch is for (shown in list); 'reserve_migration' atomically claims the next free migration number so parallel branches never collide. 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.

merge_from_main

Pull the latest main INTO a feature branch (rebase-style sync). Fast-forwards or 3-way-merges main's changes onto your branch; same-file conflicts are handed back to resolve. Use it to catch a branch up before merging.

reset_playground

Wipe a preview sandbox (database and storage). Defaults to your main preview; pass a branch to reset that branch's own sandbox.

set_preview_data_mode

Choose how much production data seeds preview sandboxes: 'none' (default, schema-only, nothing copied, fast, and no production data duplicated into the sandbox), 'light' (login/account data only), or 'full' (app rows too). Owner/admin.

deploy_app

Build and publish the app to the edge (prod, branch, or preview). A non-main preview deploy also reports whether main has moved since the branch forked (so you can merge_from_main before diverging).

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_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. Pass resetData:true for a clean, empty-of-app-data sandbox when a run may be reading stale rows from a prior run.

get_test_insights

Test-health analytics: pass-rate over time, the most-failing tests, and flaky-test detection.

add_domain

Attach a custom domain; returns the DNS records to add.

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.

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.

query_app_db

Run a SQL query against the app's database (admin gated).

describe_app_db

Inspect the app database's schema, tables, columns, and row counts, without running SQL (read-only; admin gated). The safe way to see what exists before writing a query.

query_app_search

Query, seed, or inspect the app's semantic search index (env.SEARCH; admin gated, paid plan).

manage_app_storage

List, read, write, or delete objects in the app's file storage (action: list/read/write/delete; admin gated). Write can store or replace an object and optionally serve it publicly.

set_image_optimize

Turn automatic responsive-WebP optimization of env.STORAGE image uploads on or off (admin gated).

manage_oauth_clients

List, revoke, or delete the OAuth clients connected to the app's own MCP server (env.AUTH). Use it to audit connections and remove a stale or accidentally-registered client. Admin only.

manage_email_sender

Verify a sending domain and set the app's default From address (admin gated).

manage_app_access

Share an app with a teammate from the chat: list, grant, or revoke per-app access (read/edit/admin) by email. Team owner/admin only; the person must already be in the team.

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.

update_seo_config

Update the app's SEO config (meta tags, sitemap, robots, llms.txt) and its `app` block: installable-app name and icon, offline mode, and the Google Play / iOS store links.

report_experience

Send Cloudrizz feedback about tool friction, anything slow, confusing, or missing while building. Returns an id + status URL.

get_report_status

Check back on a report you filed, see the team's answer and whether it's been actioned.