MCP tool reference

Every tool the Cloudrizz MCP server exposes to ChatGPT and Claude. Read-only tools are available to any member; tools that mutate an app require an admin role in the organization. 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

create_account: Create a new Cloudrizz account (email + password).
login: Authenticate an existing account and start a session.
whoami: Return the current user and organization context.

Apps & files

create_app_scaffold: Create a new app and lay down the starter project.
clone_app: Create a new app from an existing app as the starting point.
list_files: List the files in an app's working tree.
read_file: Read the contents of a single file.
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

create_branch: Explicitly fork a branch from a specific commit (usually auto-created on first write).
list_branches: List the app's branches.
describe_branch_intent: Record what a branch is for.
open_pull_request: Open a PR — the only way AI commits reach main.
list_pull_requests: List pull requests.
get_pull_request: Get the details of one pull request.
merge_pull_request: Merge a PR into its target branch (owner/admin gated).
close_pull_request: Close a PR without merging.
analyze_merge_risk: Assess the risk of merging a branch.
generate_merge_candidate: Have Cloudrizz produce a resolved merge candidate.
reset_playground: Wipe a branch's preview (playground) database.

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.

Domains

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

Environment variables

set_app_env: Set an environment variable or secret (encrypted, injected at deploy).
list_app_env: List an app's environment variables.
delete_app_env: Remove an environment variable or secret.

Resources & uploads

attach_resource: Attach a binding — database, storage, AI, etc.
list_resources: List the resources bound to an app.
detach_resource: Remove a bound resource.
request_upload_url: Get a URL to upload a large asset.

Scheduled jobs (cron)

set_cron_job: Create or update a scheduled job (handler lives in api/cron.js).
list_cron_jobs: List the app's scheduled jobs.
delete_cron_job: Delete a scheduled job by name.
run_cron_job: Trigger a scheduled job immediately.

SEO & discoverability

update_seo_config: Update the app's SEO config (meta tags, sitemap, robots, llms.txt).