# Tool reference

Source: /docs/mcp/tools

This is the full set of tools a connected agent can call, split by scope. Your agent already receives each tool's detailed description and arguments live over MCP — this page is the human overview: what exists, and which scope it needs.

## Read tools [#read-tools]

A **read** token can call the tools below. Every one of them only reads — none change anything on your account, so read is the safe default. Reading through a connected agent counts against the read rate limit. See [Scopes & safety](/docs/mcp/scopes-and-safety) for the limits.

- `check_deploy_readiness` — Run an app through its readiness checks and return a fix prompt for anything blocking a deploy.
- `check_subdomain` — Check whether a subdomain is available.
- `generate_feature_prompt` — Generate a wiring prompt for a feature such as payments, auth or analytics.
- `get_app_info` — Get an app details and configuration.
- `get_app_logs` — Get the recent logs for an app.
- `get_app_status` — Get the deploy and runtime status of an app.
- `get_github_connection` — Check your GitHub connection status.
- `list_app_customers` — List the customers of an app.
- `list_connect_accounts` — List your Stripe Connect accounts.
- `list_docs` — List the pages of this documentation, grouped by section, each with a slug and description.
- `list_env_vars` — List the environment variable names on an app. Values are never returned.
- `list_github_branches` — List the branches of a GitHub repository.
- `list_github_repos` — List your connected GitHub repositories.
- `list_products` — List the products and prices of an app.
- `list_user_apps` — List your apps.
- `read_doc` — Read one documentation page as Markdown, with the canonical link to cite.

## Write tools [#write-tools]

A **write** token is additive: it can call every read tool plus the tools below, each of which makes a real change to your account. The same guards apply to all of them:

* **Your host asks first.** Before a tool runs, your editor shows its name and description and waits for your approval.
* **Rate limit.** Write calls have a lower per-minute budget than reads.
* **Retry-safe.** A duplicate write inside a short window is collapsed, so a retried call does not act twice.

See [Scopes & safety](/docs/mcp/scopes-and-safety#what-stops-a-runaway-agent) for the exact numbers.

- `acknowledge_migration_risk` — Record your acknowledgement of a database migration risk before it runs.
- `create_app_from_github` — Create an app from a connected GitHub repository, public or private.
- `create_app_from_repo` — Create an app from a public repository URL.
- `create_app_from_zip` — Create an app from an uploaded zip file.
- `create_price` — Create a price for a product.
- `create_product` — Create a product.
- `create_zip_upload` — Get an upload ticket for sending a zip file.
- `delete_env_var` — Delete an environment variable from an app.
- `deploy_app` — Deploy an app.
- `enable_stripe_feature` — Enable a Stripe feature for an app.
- `replace_app_source` — Replace the source code of an app.
- `restart_app` — Restart an app.
- `set_app_analytics` — Turn traffic analytics on or off for an app.
- `set_app_branch` — Set the branch a git-backed app deploys from.
- `set_env_var` — Create or update an environment variable on an app.
- `set_subdomain` — Set the subdomain for an app.
- `stop_app` — Stop a running app.
- `update_app_settings` — Update the settings of an app.
- `update_product` — Update a product.

## Reading these docs without an account [#reading-these-docs-without-an-account]

Any tool can read this documentation over plain HTTP, no token needed: [`/llms.txt`](/llms.txt) links every page, [`/llms-full.txt`](/llms-full.txt) is the whole set in one file, and adding `.mdx` to any page URL returns that page as Markdown.