MCP tool reference

Call tools/list after connecting the local product server. Read the returned schema before supplying arguments; the catalogue below is generated with the public client release.

Tool	Required arguments	Action
`source_inspect`	None	Read
`source_initialize`	`project_id`, `expected_source_generation`, `idempotency_key`	Change or prepare a change
`source_files`	`project_id`	Read
`source_file`	`project_id`, `path`	Read
`source_versions`	`project_id`	Read
`source_diff`	`project_id`, `from_commit_sha`, `to_commit_sha`	Read
`source_changes`	`project_id`, `expected_source_generation`, `expected_commit_sha`, `message`, `idempotency_key`, `changes`	Change or prepare a change
`source_restore`	`project_id`, `expected_source_generation`, `expected_commit_sha`, `message`, `idempotency_key`, `restore_commit_sha`	Change or prepare a change
`source_publish`	`project_id`, `expected_source_generation`, `message`, `idempotency_key`, `mode`, `expected_source_connection_id`	Change or prepare a change
`source_publish_complete`	`project_id`	Change or prepare a change
`source_upload`	`project_id`, `operation_id`	Read
`database_compute_get`	`project_id`	Read
`database_compute_set`	`project_id`, `environment`, `confirm`, `idempotency_key`	Change or prepare a change
`project_context_get`	`project_id`	Read
`project_notes_set`	`project_id`, `markdown`, `expected_version`, `idempotency_key`	Change or prepare a change
`domain_cloudflare_authorize`	`project_id`, `zone`, `idempotency_key`	Change or prepare a change
`domain_cloudflare_status`	`project_id`	Read
`domain_paid_plan`	`project_id`, `hostname`	Read
`domain_paid_apply`	`project_id`, `hostname`, `idempotency_key`, `confirm`	Change or prepare a change
`domain_paid_status`	`project_id`	Read
`domain_paid_delete`	`project_id`, `hostname`, `idempotency_key`, `confirm`	Change or prepare a change
`billing_checkout_create`	`organization_id`, `offer`, `idempotency_key`	Change or prepare a change
`billing_checkout_get`	`organization_id`, `checkout_id`	Read
`billing_recharge_get`	`organization_id`	Read
`billing_recharge_configure`	`organization_id`, `enabled`, `monthly_limit_minor`, `consent`, `revision`, `idempotency_key`	Change or prepare a change
`billing_portal_create`	`organization_id`	Change or prepare a change
`project_export_create`	`project_id`, `password_file`, `idempotency_key`	Change or prepare a change
`project_export_get`	`project_id`, `export_id`	Read
`organization_usage_get`	`organization_id`, `month`	Read
`organization_account_get`	`organization_id`	Read
`referral_link_get`	`organization_id`	Read
`organization_credits_get`	`organization_id`	Read
`project_budget_get`	`project_id`	Read
`project_budget_set`	`project_id`, `amount_micros`, `idempotency_key`	Change or prepare a change
`organization_create`	`name`, `idempotency_key`	Change or prepare a change
`organization_list`	None	Read
`organization_use`	`organization_id`	Change or prepare a change
`profile_list`	None	Read
`database_query`	`project_id`, `environment`, `statement`	Read
`database_write`	`project_id`, `environment`, `statement`, `idempotency_key`, `confirmed`	Change or prepare a change
`database_access_create`	`project_id`, `environment`	Change or prepare a change
`database_access_list`	`project_id`	Read
`database_access_revoke`	`project_id`, `access_id`	Change or prepare a change
`promotion_plan`	`project_id`, `source_deployment_id`	Change or prepare a change
`promotion_execute`	`project_id`, `source_deployment_id`, `if_match`, `confirmation_token`, `idempotency_key`, `confirmed`	Change or prepare a change
`token_create`	`organization_id`, `name`, `idempotency_key`, `out_file`, `confirmed`	Change or prepare a change
`tokens_list`	`organization_id`	Read
`token_revoke`	`organization_id`, `key_id`, `confirmed`	Change or prepare a change
`identity_get`	None	Read
`project_handle_check`	`handle`	Read
`project_handle_set`	`project_id`, `handle`, `if_match`, `idempotency_key`	Change or prepare a change
`project_data_plan`	`project_id`, `change`	Change or prepare a change
`project_data_change`	`project_id`, `change`, `if_match`, `confirmation_token`, `idempotency_key`, `confirmed`	Change or prepare a change
`projects_list`	None	Read
`feedback_submit`	`organization_id`, `kind`, `title`, `description`, `idempotency_key`	Change or prepare a change
`feedback_status`	`feedback_id`	Read
`project_create`	`organization_id`, `name`, `idempotency_key`	Change or prepare a change
`project_get`	`project_id`	Read
`project_status`	`project_id`	Read
`project_dev_share_link_get`	`project_id`	Change or prepare a change
`project_dev_access_mode_set`	`project_id`, `mode`, `idempotency_key`	Change or prepare a change
`powered_by_flag_get`	`project_id`	Read
`powered_by_flag_set`	`project_id`, `enabled`, `idempotency_key`	Change or prepare a change
`project_dev_share_link_rotate`	`project_id`, `idempotency_key`	Change or prepare a change
`project_dev_share_link_revoke`	`project_id`, `idempotency_key`	Change or prepare a change
`project_dev_access_create`	`project_id`	Change or prepare a change
`github_connect`	`organization_id`, `idempotency_key`	Change or prepare a change
`github_status`	`organization_id`	Read
`source_link`	`project_id`, `repository_owner`, `repository_name`, `idempotency_key`	Change or prepare a change
`source_get`	`project_id`	Read
`deployment_plan`	`project_id`, `commit_sha`	Read
`deployment_create`	`project_id`, `plan_id`, `idempotency_key`	Change or prepare a change
`deployments_list`	`project_id`	Read
`deployment_get`	`project_id`, `deployment_id`	Read
`deployment_logs`	`project_id`, `deployment_id`	Read
`operation_get`	`operation_id`	Read
`operation_logs`	`operation_id`	Read
`function_runs_list`	`project_id`, `environment_id`	Read
`operation_reconcile`	`operation_id`, `idempotency_key`, `confirmed`	Change or prepare a change
`workspace_mail_domain_dns_revoke`	`organization_id`, `mail_domain_id`, `expected_revision`, `idempotency_key`, `confirmed`	Change or prepare a change
`application_domain_identity_authorization_revoke`	`project_id`, `expected_revision`, `idempotency_key`, `confirmed`	Change or prepare a change
`workspace_mail_domains_list`	`organization_id`	Read
`workspace_mail_domain_create`	`organization_id`, `domain`, `sending`, `idempotency_key`	Change or prepare a change
`workspace_mail_domain_get`	`organization_id`, `mail_domain_id`	Read
`workspace_mail_domain_retire`	`organization_id`, `mail_domain_id`, `expected_revision`, `idempotency_key`, `confirmed`	Change or prepare a change
`workspace_mail_domain_dns_authorize`	`organization_id`, `mail_domain_id`, `expected_revision`, `zone`, `idempotency_key`	Change or prepare a change
`workspace_mail_domain_dns_status`	`organization_id`, `mail_domain_id`	Read
`mail_binding_get`	`project_id`, `environment_id`	Read
`mail_binding_set`	`project_id`, `environment_id`, `mail_domain_id`, `sending`, `sender_addresses`, `default_from`, `default_reply_to`, `expected_revision`, `idempotency_key`	Change or prepare a change
`mail_binding_detach`	`project_id`, `environment_id`, `expected_revision`, `idempotency_key`, `confirmed`	Change or prepare a change
`application_domain_identity_get`	`project_id`	Read
`application_domain_identity_declare`	`project_id`, `hostname`, `idempotency_key`	Change or prepare a change
`application_domain_identity_verify`	`project_id`, `expected_revision`, `idempotency_key`	Change or prepare a change
`application_domain_identity_revoke`	`project_id`, `expected_revision`, `idempotency_key`, `confirmed`	Change or prepare a change
`application_domain_identity_authorize`	`project_id`, `expected_revision`, `zone`, `idempotency_key`	Change or prepare a change
`application_domain_identity_authorization_status`	`project_id`	Read
`mail_setup`	`project_id`, `environment_id`, `domain`, `sending`, `receiving`, `idempotency_key`	Change or prepare a change
`mail_status`	`project_id`, `environment_id`	Read
`mail_webhook_set`	`project_id`, `environment_id`, `url`, `idempotency_key`	Change or prepare a change
`mail_webhook_verify`	`project_id`, `environment_id`, `idempotency_key`	Change or prepare a change
`mail_webhook_disable`	`project_id`, `environment_id`, `idempotency_key`	Change or prepare a change
`mail_messages_list`	`project_id`, `environment_id`	Read
`mail_message_get`	`project_id`, `environment_id`, `message_id`	Read
`mail_message_retry`	`project_id`, `environment_id`, `message_id`, `idempotency_key`	Change or prepare a change
`mail_domain_set`	`project_id`, `environment_id`, `domain`, `sending`, `receiving`, `idempotency_key`	Change or prepare a change
`mail_domain_status`	`project_id`, `environment_id`	Read
`mail_domain_delete`	`project_id`, `environment_id`, `idempotency_key`, `confirm`	Change or prepare a change
`secrets_list`	`project_id`, `environment_id`	Read
`secret_delete`	`project_id`, `environment_id`, `name`, `idempotency_key`	Change or prepare a change
`secret_set_command`	`project_id`, `environment_id`, `name`, `idempotency_key`	Read
`rollback_plan`	`project_id`, `deployment_id`	Read
`rollback_execute`	`project_id`, `deployment_id`, `if_match`, `confirmation_token`, `idempotency_key`	Change or prepare a change
`delete_plan`	`project_id`	Read
`delete_execute`	`project_id`, `if_match`, `confirmation_token`, `idempotency_key`	Change or prepare a change

Download complete tool schemas · Connect MCP · Task Skills. A listed tool does not grant account access. The API checks the current user, organization, project, environment and action. Use the existing project context before changes, and retain mutation idempotency keys across uncertain responses.

Source tools

Sources and versions explains the source choice, revision guards, save completion and restoration. Read source_get before choosing a source. Request include_binding: true for connection/generation guards; the default GitHub status view remains unchanged, while managed source is always complete. Preserve the selected project and source.

Task	Tool	Usage
Inspect this computer’s checkout	`source_inspect`	Local only; read `directory` without sign-in or uploading.
Save current local files	`source_publish`	Local only; `initialize`, `commit` or an explicitly requested GitHub-to-managed `switch`. Keep the connection/generation and original key. Omit `expected_commit_sha` only when this directory has its own confirmed base from successful local publication.
Finish an accepted local save	`source_publish_complete`	Local only; same `project_id`, `directory`, optional `operation_id` and login. Confirms the exact version and stores its local base; uploads no files.
Observe the upload receipt	`source_upload`	Local and remote; read `project_id` and `operation_id`. Require operation success and a committed receipt; sealed is not confirmation.
Create a managed template	`source_initialize`	Unbound source only; choose `empty` or `vite-react`, current `expected_source_generation` and a saved key. Do not duplicate pending project initialization.
Read saved files	`source_files`, `source_file`	Local `source_files` lists the manifest; `source_file` reads a path. Remote `source_files` also accepts `path`. Use the actual connected schema.
Save a file batch	`source_changes`	Current generation and parent commit; each change supplies one text/base64 content field and preserves the executable flag.
Inspect and restore history	`source_versions`, `source_diff`, `source_restore`	Restore creates a new version; it neither deploys nor reverts database data.

For a complete native-chat snapshot, use remote source_upload_prepare and source_blob_put, then source_upload_commit for initialize/commit or source_switch for an explicitly requested GitHub-to-managed switch. source_blob_put computes hashes and byte lengths from real file contents; keep its exact receipts for every file, including unchanged retained files. The final manifest must match all receipts from this upload. Observe the original operation with source_upload; these tools neither read a local directory nor start deployment. Complete-tree flow. MCP text reads default to content_text with encoding: "utf8", with a base64 fallback for binary files. source_changes accepts exactly one content_text or content_base64 per path; content_base64: null deletes the file. REST uses base64. The editing example includes the complete argument shape. The generated catalogue above is the local product server. Remote OAuth clients discover their own tools through tools/list; local directory tools cannot operate inside a native chat without a local filesystem. Connection and publishing permissions are described in MCP setup.

Start

Deploy

Operate

Agent reference

Legal

MCP tool reference

Source tools

​Source tools

Source tools