---
title: Blossom MCP Tools
url: "/docs/ai-agents/mcp-tools/"
canonical_url: https://docs.blossom88.com/docs/ai-agents/mcp-tools/
markdown_url: https://docs.blossom88.com/docs/ai-agents/mcp-tools.md
summary: Every tool the Blossom MCP server offers, by area
categories:
- mcp
- reference
---

# Blossom MCP Tools

Blossom MCP gives your AI app the same operations as the Blossom CLI. Each
tool is a CLI command with `:` written as `_`, with the same permissions,
capacity limit and Activity. Describe what you want; your app picks the tools.

Connect first: [Connect AI Apps](/docs/ai-agents/connect-ai-apps/). A Read only
connection can use the read tools; changes need Full access.

## [Account](/docs/ai-agents/mcp-tools/account/)

| Tool | What it does | Access |
|---|---|---|
| [`account_create`](/docs/ai-agents/mcp-tools/account/account_create/) | Create an Account in the Organization, optionally with its first Location. | Changes Blossom |
| [`account_delete`](/docs/ai-agents/mcp-tools/account/account_delete/) | Delete an empty Account. | Deletes; asks for `yes: true` |
| [`account_member_list`](/docs/ai-agents/mcp-tools/account/account_member_list/) | List the people with access to this Account and their roles. | Read only |
| [`account_member_remove`](/docs/ai-agents/mcp-tools/account/account_member_remove/) | Remove a person's access to this Account. | Deletes; asks for `yes: true` |
| [`account_member_show`](/docs/ai-agents/mcp-tools/account/account_member_show/) | Show one Account member: role, access and permissions. | Read only |
| [`account_member_update`](/docs/ai-agents/mcp-tools/account/account_member_update/) | Change an Account member's role, access mode or permissions. | Changes Blossom |
| [`account_show`](/docs/ai-agents/mcp-tools/account/account_show/) | Show one Blossom Account: its Organization, default Location and maintenance window. | Read only |
| [`account_update`](/docs/ai-agents/mcp-tools/account/account_update/) | Change this Account's default Location or maintenance window. | Changes Blossom |
| [`whoami`](/docs/ai-agents/mcp-tools/account/whoami/) | Show the Blossom user, Organization, Account and access this connection uses. | Read only |

## [Apps](/docs/ai-agents/mcp-tools/apps/)

| Tool | What it does | Access |
|---|---|---|
| [`app_create`](/docs/ai-agents/mcp-tools/apps/app_create/) | Create a Blossom App, the home for its Environments. | Changes Blossom |
| [`app_delete`](/docs/ai-agents/mcp-tools/apps/app_delete/) | Delete a Blossom App. | Deletes; asks for `yes: true` |
| [`app_list`](/docs/ai-agents/mcp-tools/apps/app_list/) | List the Blossom Apps in one Location. | Read only |
| [`app_show`](/docs/ai-agents/mcp-tools/apps/app_show/) | Show one Blossom App: its Location and Environments. | Read only |
| [`app_update`](/docs/ai-agents/mcp-tools/apps/app_update/) | Rename a Blossom App. | Changes Blossom |

## [Environments](/docs/ai-agents/mcp-tools/environments/)

| Tool | What it does | Access |
|---|---|---|
| [`environment_access_link_create`](/docs/ai-agents/mcp-tools/environments/environment_access_link_create/) | Get the link to create a shareable link that opens a private Environment in a browser. | Read only |
| [`environment_access_link_list`](/docs/ai-agents/mcp-tools/environments/environment_access_link_list/) | List a private Environment's access links: name, expiry and status. | Read only |
| [`environment_access_link_revoke`](/docs/ai-agents/mcp-tools/environments/environment_access_link_revoke/) | Revoke an access link; it stops working at once. | Deletes; asks for `yes: true` |
| [`environment_access_link_show`](/docs/ai-agents/mcp-tools/environments/environment_access_link_show/) | Show one access link: name, expiry and status. | Read only |
| [`environment_access_link_update`](/docs/ai-agents/mcp-tools/environments/environment_access_link_update/) | Rename an access link. | Changes Blossom |
| [`environment_access_token_create`](/docs/ai-agents/mcp-tools/environments/environment_access_token_create/) | Get the link to create a token that lets scripts and agents call a private Environment. | Read only |
| [`environment_access_token_list`](/docs/ai-agents/mcp-tools/environments/environment_access_token_list/) | List a private Environment's access tokens: name, expiry and status. | Read only |
| [`environment_access_token_revoke`](/docs/ai-agents/mcp-tools/environments/environment_access_token_revoke/) | Revoke an access token; it stops working at once. | Deletes; asks for `yes: true` |
| [`environment_access_token_show`](/docs/ai-agents/mcp-tools/environments/environment_access_token_show/) | Show one access token: name, expiry and status. | Read only |
| [`environment_access_token_update`](/docs/ai-agents/mcp-tools/environments/environment_access_token_update/) | Rename an access token. | Changes Blossom |
| [`environment_activity`](/docs/ai-agents/mcp-tools/environments/environment_activity/) | List one Blossom Environment's recent Activities (deploys, scaling, restarts), newest first. | Read only |
| [`environment_build_config_show`](/docs/ai-agents/mcp-tools/environments/environment_build_config_show/) | Show how an Environment builds: build type and Builder. | Read only |
| [`environment_build_config_update`](/docs/ai-agents/mcp-tools/environments/environment_build_config_update/) | Change how an Environment builds, such as dockerfile or a Builder. | Changes Blossom |
| [`environment_create`](/docs/ai-agents/mcp-tools/environments/environment_create/) | Add an Environment to an App, such as staging. | Changes Blossom |
| [`environment_delete`](/docs/ai-agents/mcp-tools/environments/environment_delete/) | Delete an Environment, its Containers and its data. | Deletes; asks for `yes: true` |
| [`environment_deploy`](/docs/ai-agents/mcp-tools/environments/environment_deploy/) | Deploy a Blossom Environment: build its source and release it within the Account's capacity limit. | Changes Blossom |
| [`environment_deploy_hooks_show`](/docs/ai-agents/mcp-tools/environments/environment_deploy_hooks_show/) | Show an Environment's deploy hooks: the release phase, such as migrations, and post-deploy command. | Read only |
| [`environment_deploy_hooks_update`](/docs/ai-agents/mcp-tools/environments/environment_deploy_hooks_update/) | Set an Environment's release phase (such as migrations) or post-deploy command. | Changes Blossom |
| [`environment_list`](/docs/ai-agents/mcp-tools/environments/environment_list/) | List Blossom Environments with each one's URL, deploy status and health (runtime), for one App or one Location. | Read only |
| [`environment_load_balancer_show`](/docs/ai-agents/mcp-tools/environments/environment_load_balancer_show/) | Show an Environment's routing settings: basic auth and extra Caddy configuration. | Read only |
| [`environment_load_balancer_update`](/docs/ai-agents/mcp-tools/environments/environment_load_balancer_update/) | Change an Environment's routing settings: basic auth on or off, extra Caddy configuration. | Changes Blossom |
| [`environment_maintenance_disable`](/docs/ai-agents/mcp-tools/environments/environment_maintenance_disable/) | Take an Environment out of maintenance mode and serve the App again. | Changes Blossom |
| [`environment_maintenance_enable`](/docs/ai-agents/mcp-tools/environments/environment_maintenance_enable/) | Put an Environment in maintenance mode: visitors get a maintenance page until it is disabled. | Changes Blossom |
| [`environment_maintenance_show`](/docs/ai-agents/mcp-tools/environments/environment_maintenance_show/) | Show whether an Environment is in maintenance mode, which serves a maintenance page instead of the App. | Read only |
| [`environment_pending_changes_show`](/docs/ai-agents/mcp-tools/environments/environment_pending_changes_show/) | Show the configuration changes an Environment's next deploy will apply. | Read only |
| [`environment_preview_create`](/docs/ai-agents/mcp-tools/environments/environment_preview_create/) | Open a Preview of an Environment for a branch, such as a pull request's, and start its first deploy. | Changes Blossom |
| [`environment_preview_data_delete`](/docs/ai-agents/mcp-tools/environments/environment_preview_data_delete/) | Delete the data new Previews start from; later Previews start empty. | Deletes; asks for `yes: true` |
| [`environment_preview_data_show`](/docs/ai-agents/mcp-tools/environments/environment_preview_data_show/) | Show the data new Previews of an Environment start from: its source, size and when it was uploaded. | Read only |
| [`environment_preview_delete_all`](/docs/ai-agents/mcp-tools/environments/environment_preview_delete_all/) | Delete every Preview of an Environment, with their Containers and data. | Deletes; asks for `yes: true` |
| [`environment_preview_list`](/docs/ai-agents/mcp-tools/environments/environment_preview_list/) | List an Environment's Previews: branch, who created them, status and URL. | Read only |
| [`environment_preview_settings`](/docs/ai-agents/mcp-tools/environments/environment_preview_settings/) | Show how an Environment's Previews work: expiry, limit, pull requests, branch pattern, setup command and size. | Read only |
| [`environment_preview_settings_update`](/docs/ai-agents/mcp-tools/environments/environment_preview_settings_update/) | Change how an Environment's Previews work: expiry, limit, a Preview per pull request, a branch pattern, the setup command, or their size. | Changes Blossom |
| [`environment_scale`](/docs/ai-agents/mcp-tools/environments/environment_scale/) | Scale one Service of an Environment by name, such as web to 3, within the Account's capacity limit. | Changes Blossom |
| [`environment_show`](/docs/ai-agents/mcp-tools/environments/environment_show/) | Show one Blossom Environment: URL, deploy status, health, each Service's running and ready Containers, and anything blocking a deploy. | Read only |
| [`environment_update`](/docs/ai-agents/mcp-tools/environments/environment_update/) | Change an Environment's settings: deletion protection, automatic deploys, access, Previews. | Changes Blossom |

## [App Plans](/docs/ai-agents/mcp-tools/app-plans/)

| Tool | What it does | Access |
|---|---|---|
| [`app_plan_create`](/docs/ai-agents/mcp-tools/app-plans/app_plan_create/) | Save a Blossom App Plan from a Git repository: what it creates and its Capacity effect. | Changes Blossom |
| [`app_plan_delete`](/docs/ai-agents/mcp-tools/app-plans/app_plan_delete/) | Discard a saved Blossom App Plan. | Deletes; asks for `yes: true` |
| [`app_plan_deploy`](/docs/ai-agents/mcp-tools/app-plans/app_plan_deploy/) | Deploy a Blossom App Plan into a new Environment: a saved plan by id, or a new plan from data in one step. | Changes Blossom |
| [`app_plan_list`](/docs/ai-agents/mcp-tools/app-plans/app_plan_list/) | List saved Blossom App Plans in one Location, newest first, with the Environments each deployed. | Read only |
| [`app_plan_preview`](/docs/ai-agents/mcp-tools/app-plans/app_plan_preview/) | Preview a Blossom App Plan without saving it: the App, Environment and Services it would create, and its Capacity effect. | Read only |
| [`app_plan_show`](/docs/ai-agents/mcp-tools/app-plans/app_plan_show/) | Show one Blossom App Plan: its intent, what it creates, its Capacity effect and its review link. | Read only |

## [Quickstarts](/docs/ai-agents/mcp-tools/quickstarts/)

| Tool | What it does | Access |
|---|---|---|
| [`quickstart_list`](/docs/ai-agents/mcp-tools/quickstarts/quickstart_list/) | List Blossom Quickstarts: example Apps an App Plan can start from with quickstart: KEY. | Read only |

## [Releases](/docs/ai-agents/mcp-tools/releases/)

| Tool | What it does | Access |
|---|---|---|
| [`release_cancel`](/docs/ai-agents/mcp-tools/releases/release_cancel/) | Cancel a Blossom Release that is still building or rolling out. | Changes Blossom |
| [`release_list`](/docs/ai-agents/mcp-tools/releases/release_list/) | List a Blossom Environment's Releases, newest first: version, status, Git SHA and when each ran. | Read only |
| [`release_rollback`](/docs/ai-agents/mcp-tools/releases/release_rollback/) | Roll a Blossom Environment back to an earlier succeeded Release. | Changes Blossom |
| [`release_show`](/docs/ai-agents/mcp-tools/releases/release_show/) | Show one Blossom Release: its version, image, Git SHA, status and Activity. | Read only |

## [Services](/docs/ai-agents/mcp-tools/services/)

| Tool | What it does | Access |
|---|---|---|
| [`service_create`](/docs/ai-agents/mcp-tools/services/service_create/) | Add a Service to an Environment, such as a worker. | Changes Blossom |
| [`service_delete`](/docs/ai-agents/mcp-tools/services/service_delete/) | Delete a Service and stop its Containers. | Deletes; asks for `yes: true` |
| [`service_list`](/docs/ai-agents/mcp-tools/services/service_list/) | List the Services of one Environment or App, with each one's command, size and URL. | Read only |
| [`service_regenerate_url`](/docs/ai-agents/mcp-tools/services/service_regenerate_url/) | Give a Service a new generated URL. | Deletes; asks for `yes: true` |
| [`service_restart`](/docs/ai-agents/mcp-tools/services/service_restart/) | Restart a Service's Containers one at a time, keeping it available. | Changes Blossom |
| [`service_scale`](/docs/ai-agents/mcp-tools/services/service_scale/) | Set how many Containers a Service runs, within the Account's capacity limit. | Changes Blossom |
| [`service_show`](/docs/ai-agents/mcp-tools/services/service_show/) | Show one Service: its command, port, size, health check, desired and running Containers, and URL. | Read only |
| [`service_update`](/docs/ai-agents/mcp-tools/services/service_update/) | Change a Service's command, port, size, health check or storage. | Changes Blossom |

## [Containers](/docs/ai-agents/mcp-tools/containers/)

| Tool | What it does | Access |
|---|---|---|
| [`container_list`](/docs/ai-agents/mcp-tools/containers/container_list/) | List the Containers of an Environment or Service, with state, health, Server and Release. | Read only |
| [`container_show`](/docs/ai-agents/mcp-tools/containers/container_show/) | Show one Container: state, health, restarts, Server and Release. | Read only |

## [Jobs](/docs/ai-agents/mcp-tools/jobs/)

| Tool | What it does | Access |
|---|---|---|
| [`job_create`](/docs/ai-agents/mcp-tools/jobs/job_create/) | Save a Job definition for an Environment. | Changes Blossom |
| [`job_delete`](/docs/ai-agents/mcp-tools/jobs/job_delete/) | Delete a saved Job and its schedule. | Deletes; asks for `yes: true` |
| [`job_list`](/docs/ai-agents/mcp-tools/jobs/job_list/) | List saved Jobs, for one Environment or the whole Account, with their schedules. | Read only |
| [`job_run_cancel`](/docs/ai-agents/mcp-tools/jobs/job_run_cancel/) | Cancel a queued or running Job Run. | Changes Blossom |
| [`job_run_create`](/docs/ai-agents/mcp-tools/jobs/job_run_create/) | Run a saved Job now (job), or a one-off command in an Environment (environment with command or data), such as a migration. | Changes Blossom |
| [`job_run_list`](/docs/ai-agents/mcp-tools/jobs/job_run_list/) | List Job Runs for an Environment or Job, newest first, with status and exit code. | Read only |
| [`job_run_logs`](/docs/ai-agents/mcp-tools/jobs/job_run_logs/) | Read a Job Run's output. | Read only |
| [`job_run_show`](/docs/ai-agents/mcp-tools/jobs/job_run_show/) | Show one Job Run: its command, status, exit code and timing. | Read only |
| [`job_show`](/docs/ai-agents/mcp-tools/jobs/job_show/) | Show one saved Job: its command, size, schedule and latest Runs. | Read only |
| [`job_update`](/docs/ai-agents/mcp-tools/jobs/job_update/) | Change a saved Job's command, size, timeout or schedule. | Changes Blossom |

## [Logs](/docs/ai-agents/mcp-tools/logs/)

| Tool | What it does | Access |
|---|---|---|
| [`logs`](/docs/ai-agents/mcp-tools/logs/logs/) | Read recent log lines from an Environment's or Service's Containers, newest last. | Read only |

## [Metrics](/docs/ai-agents/mcp-tools/metrics/)

| Tool | What it does | Access |
|---|---|---|
| [`metric_source_list`](/docs/ai-agents/mcp-tools/metrics/metric_source_list/) | List the metrics an Environment offers: source types and scopes to pass to metric_stream_create. | Read only |
| [`metric_stream_create`](/docs/ai-agents/mcp-tools/metrics/metric_stream_create/) | Start a metric stream for an Environment's Containers, then read it with metric_stream_show. | Changes Blossom |
| [`metric_stream_list`](/docs/ai-agents/mcp-tools/metrics/metric_stream_list/) | List the metric streams of an Environment. | Read only |
| [`metric_stream_show`](/docs/ai-agents/mcp-tools/metrics/metric_stream_show/) | Show a metric stream and its latest values, such as CPU and memory per Container. | Read only |

## [Domains](/docs/ai-agents/mcp-tools/domains/)

| Tool | What it does | Access |
|---|---|---|
| [`domain_create`](/docs/ai-agents/mcp-tools/domains/domain_create/) | Add a custom domain to an Environment, such as www.example.com. | Changes Blossom |
| [`domain_delete`](/docs/ai-agents/mcp-tools/domains/domain_delete/) | Remove a custom domain; it stops routing to the Environment. | Deletes; asks for `yes: true` |
| [`domain_list`](/docs/ai-agents/mcp-tools/domains/domain_list/) | List an Environment's custom domains, with DNS and HTTPS status. | Read only |
| [`domain_show`](/docs/ai-agents/mcp-tools/domains/domain_show/) | Show one domain: the DNS records to add and its HTTPS status. | Read only |
| [`domain_update`](/docs/ai-agents/mcp-tools/domains/domain_update/) | Change a domain's Service, mode or main flag. | Changes Blossom |

## [Routes](/docs/ai-agents/mcp-tools/routes/)

| Tool | What it does | Access |
|---|---|---|
| [`route_create`](/docs/ai-agents/mcp-tools/routes/route_create/) | Route a path prefix, such as /api, to a Service of the Environment. | Changes Blossom |
| [`route_delete`](/docs/ai-agents/mcp-tools/routes/route_delete/) | Remove a path route. | Deletes; asks for `yes: true` |
| [`route_list`](/docs/ai-agents/mcp-tools/routes/route_list/) | List an Environment's path routes to Services. | Read only |
| [`route_show`](/docs/ai-agents/mcp-tools/routes/route_show/) | Show one route. | Read only |

## [Variables](/docs/ai-agents/mcp-tools/variables/)

| Tool | What it does | Access |
|---|---|---|
| [`env_var_create`](/docs/ai-agents/mcp-tools/variables/env_var_create/) | Set an Environment variable. | Changes Blossom |
| [`env_var_delete`](/docs/ai-agents/mcp-tools/variables/env_var_delete/) | Delete an Environment variable. | Deletes; asks for `yes: true` |
| [`env_var_list`](/docs/ai-agents/mcp-tools/variables/env_var_list/) | List an Environment's variables. | Read only |
| [`env_var_show`](/docs/ai-agents/mcp-tools/variables/env_var_show/) | Show one Environment variable. | Read only |
| [`env_var_update`](/docs/ai-agents/mcp-tools/variables/env_var_update/) | Change an Environment variable's value or build flag. | Changes Blossom |

## [Environment Links](/docs/ai-agents/mcp-tools/environment-links/)

| Tool | What it does | Access |
|---|---|---|
| [`environment_link_create`](/docs/ai-agents/mcp-tools/environment-links/environment_link_create/) | Link an Environment to a Database or Cache; Blossom sets the connection URL variable, such as DATABASE_URL. | Changes Blossom |
| [`environment_link_delete`](/docs/ai-agents/mcp-tools/environment-links/environment_link_delete/) | Remove a link; the connection URL variable goes away on the next deploy. | Deletes; asks for `yes: true` |
| [`environment_link_list`](/docs/ai-agents/mcp-tools/environment-links/environment_link_list/) | List an Environment's links to Databases and Caches. | Read only |
| [`environment_link_show`](/docs/ai-agents/mcp-tools/environment-links/environment_link_show/) | Show one link: its target and the variable that holds the connection URL. | Read only |
| [`environment_link_update`](/docs/ai-agents/mcp-tools/environment-links/environment_link_update/) | Rename the variable a link sets. | Changes Blossom |

## [Git Repos](/docs/ai-agents/mcp-tools/git-repos/)

| Tool | What it does | Access |
|---|---|---|
| [`git_repo_create`](/docs/ai-agents/mcp-tools/git-repos/git_repo_create/) | Set the Git repository an Environment deploys from. | Changes Blossom |
| [`git_repo_delete`](/docs/ai-agents/mcp-tools/git-repos/git_repo_delete/) | Remove an Environment's Git source. | Deletes; asks for `yes: true` |
| [`git_repo_list`](/docs/ai-agents/mcp-tools/git-repos/git_repo_list/) | List the Git sources Environments deploy from. | Read only |
| [`git_repo_show`](/docs/ai-agents/mcp-tools/git-repos/git_repo_show/) | Show one Git source: repository, branch and folder. | Read only |
| [`git_repo_update`](/docs/ai-agents/mcp-tools/git-repos/git_repo_update/) | Change an Environment's repository, branch or folder. | Changes Blossom |

## [Registry Links](/docs/ai-agents/mcp-tools/registry-links/)

| Tool | What it does | Access |
|---|---|---|
| [`registry_link_create`](/docs/ai-agents/mcp-tools/registry-links/registry_link_create/) | Let an Environment pull from a connected container registry. | Changes Blossom |
| [`registry_link_delete`](/docs/ai-agents/mcp-tools/registry-links/registry_link_delete/) | Remove a registry link. | Deletes; asks for `yes: true` |
| [`registry_link_list`](/docs/ai-agents/mcp-tools/registry-links/registry_link_list/) | List the container registries Environments pull from. | Read only |
| [`registry_link_show`](/docs/ai-agents/mcp-tools/registry-links/registry_link_show/) | Show one registry link. | Read only |
| [`registry_link_update`](/docs/ai-agents/mcp-tools/registry-links/registry_link_update/) | Point a registry link at another registry. | Changes Blossom |

## [Builders](/docs/ai-agents/mcp-tools/builders/)

| Tool | What it does | Access |
|---|---|---|
| [`builder_create`](/docs/ai-agents/mcp-tools/builders/builder_create/) | Create a dedicated Builder in a region, within the capacity limit. | Changes Blossom |
| [`builder_delete`](/docs/ai-agents/mcp-tools/builders/builder_delete/) | Delete a dedicated Builder; builds use the region's default or App capacity. | Deletes; asks for `yes: true` |
| [`builder_list`](/docs/ai-agents/mcp-tools/builders/builder_list/) | List the Account's dedicated Builders, with region, size and state. | Read only |
| [`builder_show`](/docs/ai-agents/mcp-tools/builders/builder_show/) | Show one Builder: region, size, idle retention and recent builds. | Read only |
| [`builder_update`](/docs/ai-agents/mcp-tools/builders/builder_update/) | Change a Builder's name, size, timeout or idle retention, or make it the region's default. | Changes Blossom |

## [Load Balancers](/docs/ai-agents/mcp-tools/load-balancers/)

| Tool | What it does | Access |
|---|---|---|
| [`load_balancer_list`](/docs/ai-agents/mcp-tools/load-balancers/load_balancer_list/) | List the Account's Load Balancers, one per Location, with their outcome. | Read only |
| [`load_balancer_show`](/docs/ai-agents/mcp-tools/load-balancers/load_balancer_show/) | Show one Load Balancer: outcome, instances and IP. | Read only |
| [`load_balancer_update`](/docs/ai-agents/mcp-tools/load-balancers/load_balancer_update/) | Choose a Location's Load Balancer outcome (integrated, dedicated, highly_available) and static IP. | Changes Blossom |

## [Database Instances](/docs/ai-agents/mcp-tools/database-instances/)

| Tool | What it does | Access |
|---|---|---|
| [`database_instance_create`](/docs/ai-agents/mcp-tools/database-instances/database_instance_create/) | Create a managed database instance (PostgreSQL, MySQL, MariaDB or MongoDB) within the capacity limit. | Changes Blossom |
| [`database_instance_credentials_rotate`](/docs/ai-agents/mcp-tools/database-instances/database_instance_credentials_rotate/) | Rotate a database instance's password; Blossom generates the new one. | Deletes; asks for `yes: true` |
| [`database_instance_delete`](/docs/ai-agents/mcp-tools/database-instances/database_instance_delete/) | Delete a database instance and its data. | Deletes; asks for `yes: true` |
| [`database_instance_list`](/docs/ai-agents/mcp-tools/database-instances/database_instance_list/) | List database instances in a Location, with engine, size, availability and status. | Read only |
| [`database_instance_replica_create`](/docs/ai-agents/mcp-tools/database-instances/database_instance_replica_create/) | Add a read replica to a database instance within the capacity limit. | Changes Blossom |
| [`database_instance_replica_delete`](/docs/ai-agents/mcp-tools/database-instances/database_instance_replica_delete/) | Remove a database read replica. | Deletes; asks for `yes: true` |
| [`database_instance_replica_list`](/docs/ai-agents/mcp-tools/database-instances/database_instance_replica_list/) | List the read replicas of a database instance. | Read only |
| [`database_instance_replica_show`](/docs/ai-agents/mcp-tools/database-instances/database_instance_replica_show/) | Show one database read replica: placement, lag and endpoint. | Read only |
| [`database_instance_retry`](/docs/ai-agents/mcp-tools/database-instances/database_instance_retry/) | Retry a database instance's failed provisioning. | Changes Blossom |
| [`database_instance_show`](/docs/ai-agents/mcp-tools/database-instances/database_instance_show/) | Show one database instance: engine, size, storage, nodes, backups and endpoints. | Read only |
| [`database_instance_standby_list`](/docs/ai-agents/mcp-tools/database-instances/database_instance_standby_list/) | List the standby of a database instance. | Read only |
| [`database_instance_standby_show`](/docs/ai-agents/mcp-tools/database-instances/database_instance_standby_show/) | Show a database standby: placement, lag and readiness. | Read only |
| [`database_instance_switchover`](/docs/ai-agents/mcp-tools/database-instances/database_instance_switchover/) | Promote the standby of a database instance to primary. | Deletes; asks for `yes: true` |
| [`database_instance_update`](/docs/ai-agents/mcp-tools/database-instances/database_instance_update/) | Change a database instance: grow storage, standby, public access, deletion protection, backup storage. | Changes Blossom |
| [`database_instance_upgrade`](/docs/ai-agents/mcp-tools/database-instances/database_instance_upgrade/) | Upgrade a database instance to the next major version. | Deletes; asks for `yes: true` |

## [Databases](/docs/ai-agents/mcp-tools/databases/)

| Tool | What it does | Access |
|---|---|---|
| [`database_create`](/docs/ai-agents/mcp-tools/databases/database_create/) | Create a database, with its own role, in a database instance. | Changes Blossom |
| [`database_delete`](/docs/ai-agents/mcp-tools/databases/database_delete/) | Delete a database and its data from its instance. | Deletes; asks for `yes: true` |
| [`database_import`](/docs/ai-agents/mcp-tools/databases/database_import/) | Import a database dump into a new database of a database instance, from an upload or a backup. | Changes Blossom |
| [`database_list`](/docs/ai-agents/mcp-tools/databases/database_list/) | List the databases in a database instance, or in the Account. | Read only |
| [`database_maintenance_disable`](/docs/ai-agents/mcp-tools/databases/database_maintenance_disable/) | Take a database out of maintenance mode. | Changes Blossom |
| [`database_maintenance_enable`](/docs/ai-agents/mcp-tools/databases/database_maintenance_enable/) | Put a database in maintenance mode: connections are refused until it is disabled. | Deletes; asks for `yes: true` |
| [`database_maintenance_show`](/docs/ai-agents/mcp-tools/databases/database_maintenance_show/) | Show whether a database is in maintenance mode. | Read only |
| [`database_retry`](/docs/ai-agents/mcp-tools/databases/database_retry/) | Retry a database's failed creation. | Changes Blossom |
| [`database_show`](/docs/ai-agents/mcp-tools/databases/database_show/) | Show one database: instance, size, status and links. | Read only |
| [`database_upload_delete`](/docs/ai-agents/mcp-tools/databases/database_upload_delete/) | Delete a database dump upload. | Deletes; asks for `yes: true` |
| [`database_upload_list`](/docs/ai-agents/mcp-tools/databases/database_upload_list/) | List database dump uploads waiting to be imported. | Read only |
| [`database_upload_show`](/docs/ai-agents/mcp-tools/databases/database_upload_show/) | Show one database dump upload: size, status and expiry. | Read only |

## [Caches](/docs/ai-agents/mcp-tools/caches/)

| Tool | What it does | Access |
|---|---|---|
| [`cache_instance_create`](/docs/ai-agents/mcp-tools/caches/cache_instance_create/) | Create a managed cache (Redis or Memcached) within the capacity limit. | Changes Blossom |
| [`cache_instance_credentials_rotate`](/docs/ai-agents/mcp-tools/caches/cache_instance_credentials_rotate/) | Rotate a cache's password; Blossom generates the new one. | Deletes; asks for `yes: true` |
| [`cache_instance_delete`](/docs/ai-agents/mcp-tools/caches/cache_instance_delete/) | Delete a cache and its data. | Deletes; asks for `yes: true` |
| [`cache_instance_list`](/docs/ai-agents/mcp-tools/caches/cache_instance_list/) | List caches in a Location, with size, availability and status. | Read only |
| [`cache_instance_replica_create`](/docs/ai-agents/mcp-tools/caches/cache_instance_replica_create/) | Add a read replica to a cache within the capacity limit. | Changes Blossom |
| [`cache_instance_replica_delete`](/docs/ai-agents/mcp-tools/caches/cache_instance_replica_delete/) | Remove a cache read replica. | Deletes; asks for `yes: true` |
| [`cache_instance_replica_list`](/docs/ai-agents/mcp-tools/caches/cache_instance_replica_list/) | List the read replicas of a cache. | Read only |
| [`cache_instance_replica_show`](/docs/ai-agents/mcp-tools/caches/cache_instance_replica_show/) | Show one cache read replica. | Read only |
| [`cache_instance_show`](/docs/ai-agents/mcp-tools/caches/cache_instance_show/) | Show one cache: size, storage, nodes and endpoints. | Read only |
| [`cache_instance_standby_list`](/docs/ai-agents/mcp-tools/caches/cache_instance_standby_list/) | List the standby of a cache. | Read only |
| [`cache_instance_standby_show`](/docs/ai-agents/mcp-tools/caches/cache_instance_standby_show/) | Show a cache standby. | Read only |
| [`cache_instance_switchover`](/docs/ai-agents/mcp-tools/caches/cache_instance_switchover/) | Promote the standby of a cache to primary. | Deletes; asks for `yes: true` |
| [`cache_instance_update`](/docs/ai-agents/mcp-tools/caches/cache_instance_update/) | Change a cache: grow storage, standby, public access, deletion protection, backup storage. | Changes Blossom |

## [Backups](/docs/ai-agents/mcp-tools/backups/)

| Tool | What it does | Access |
|---|---|---|
| [`backup_create`](/docs/ai-agents/mcp-tools/backups/backup_create/) | Back up a database, database instance or cache now. | Changes Blossom |
| [`backup_delete`](/docs/ai-agents/mcp-tools/backups/backup_delete/) | Delete a backup. | Deletes; asks for `yes: true` |
| [`backup_list`](/docs/ai-agents/mcp-tools/backups/backup_list/) | List backups of a database, database instance or cache, newest first. | Read only |
| [`backup_restore`](/docs/ai-agents/mcp-tools/backups/backup_restore/) | Restore a backup into a new instance, optionally to a point in time. | Changes Blossom |
| [`backup_setting_show`](/docs/ai-agents/mcp-tools/backups/backup_setting_show/) | Show the backup schedule and destination of a database, database instance or cache. | Read only |
| [`backup_setting_update`](/docs/ai-agents/mcp-tools/backups/backup_setting_update/) | Change the backup schedule, retention or destination of a database, database instance or cache. | Changes Blossom |
| [`backup_show`](/docs/ai-agents/mcp-tools/backups/backup_show/) | Show one backup: target, size, status and when it ran. | Read only |

## [Capacity](/docs/ai-agents/mcp-tools/capacity/)

| Tool | What it does | Access |
|---|---|---|
| [`capacity_limit_request_create`](/docs/ai-agents/mcp-tools/capacity/capacity_limit_request_create/) | Ask Blossom for a higher capacity limit: more units in one Location (location and units), more Locations (locations), or more Builder units (builders and units). | Changes Blossom |
| [`capacity_limit_request_list`](/docs/ai-agents/mcp-tools/capacity/capacity_limit_request_list/) | List the Account's requests for a higher capacity limit and their status. | Read only |
| [`capacity_list`](/docs/ai-agents/mcp-tools/capacity/capacity_list/) | List the Account's Capacity: App, Data, Builder and Persistent, with allocation, state and monthly rate. | Read only |
| [`capacity_retire`](/docs/ai-agents/mcp-tools/capacity/capacity_retire/) | Retire idle Capacity now instead of after its warm period, such as an idle Builder. | Deletes; asks for `yes: true` |
| [`capacity_show`](/docs/ai-agents/mcp-tools/capacity/capacity_show/) | Show one Capacity allocation: reservation mode, reserved room, ceiling, Servers and rate. | Read only |
| [`capacity_update`](/docs/ai-agents/mcp-tools/capacity/capacity_update/) | Change how much Capacity an Account keeps: reservation mode (on_demand, automatic or custom), reserved room, ceiling or idle retention. | Changes Blossom |

## [Spending](/docs/ai-agents/mcp-tools/spending/)

| Tool | What it does | Access |
|---|---|---|
| [`spending_show`](/docs/ai-agents/mcp-tools/spending/spending_show/) | Show the Account's spending: this month's bill so far, the capacity limit and the email warning amount. | Read only |
| [`spending_update`](/docs/ai-agents/mcp-tools/spending/spending_update/) | Set the email warning amount, or turn the warning on or off. | Changes Blossom |

## [Billing](/docs/ai-agents/mcp-tools/billing/)

| Tool | What it does | Access |
|---|---|---|
| [`billing_invoice_list`](/docs/ai-agents/mcp-tools/billing/billing_invoice_list/) | List the Organization's invoices, newest first, with amount and status. | Read only |
| [`billing_invoice_show`](/docs/ai-agents/mcp-tools/billing/billing_invoice_show/) | Show one invoice with its lines. | Read only |
| [`billing_profile`](/docs/ai-agents/mcp-tools/billing/billing_profile/) | Show the Organization's billing: payment setup, plan, BYOC credit and this month's bill so far. | Read only |
| [`billing_usage`](/docs/ai-agents/mcp-tools/billing/billing_usage/) | Show what the Organization is spending and where: usage by Account, Location and workload for a month or a range. | Read only |

## [Organizations](/docs/ai-agents/mcp-tools/organizations/)

| Tool | What it does | Access |
|---|---|---|
| [`organization_close`](/docs/ai-agents/mcp-tools/organizations/organization_close/) | Close an Organization: its final invoice closes and it can no longer be used. | Deletes; asks for `yes: true` |
| [`organization_create`](/docs/ai-agents/mcp-tools/organizations/organization_create/) | Create an Organization, with its first Account, owned by the signed-in person. | Changes Blossom |
| [`organization_delete`](/docs/ai-agents/mcp-tools/organizations/organization_delete/) | Delete an Organization with no billing history. | Deletes; asks for `yes: true` |
| [`organization_invitation_create`](/docs/ai-agents/mcp-tools/organizations/organization_invitation_create/) | Invite someone to the Organization by email, such as sam@example.com as a member, with Account access. | Changes Blossom |
| [`organization_invitation_delete`](/docs/ai-agents/mcp-tools/organizations/organization_invitation_delete/) | Cancel a pending invitation. | Deletes; asks for `yes: true` |
| [`organization_invitation_list`](/docs/ai-agents/mcp-tools/organizations/organization_invitation_list/) | List pending invitations to the Organization. | Read only |
| [`organization_invitation_resend`](/docs/ai-agents/mcp-tools/organizations/organization_invitation_resend/) | Send an invitation's email again. | Changes Blossom |
| [`organization_invitation_show`](/docs/ai-agents/mcp-tools/organizations/organization_invitation_show/) | Show one invitation: who, role, Account access and status. | Read only |
| [`organization_invitation_update`](/docs/ai-agents/mcp-tools/organizations/organization_invitation_update/) | Change a pending invitation's role, Account access or permissions. | Changes Blossom |
| [`organization_list`](/docs/ai-agents/mcp-tools/organizations/organization_list/) | List the Organizations the signed-in person belongs to. | Read only |
| [`organization_member_list`](/docs/ai-agents/mcp-tools/organizations/organization_member_list/) | List the Organization's members, their roles and Account access. | Read only |
| [`organization_member_remove`](/docs/ai-agents/mcp-tools/organizations/organization_member_remove/) | Remove a person from the Organization and all its Accounts. | Deletes; asks for `yes: true` |
| [`organization_member_show`](/docs/ai-agents/mcp-tools/organizations/organization_member_show/) | Show one Organization member: role, Account access and permissions. | Read only |
| [`organization_member_update`](/docs/ai-agents/mcp-tools/organizations/organization_member_update/) | Change an Organization member's role, Account access or permissions. | Changes Blossom |
| [`organization_show`](/docs/ai-agents/mcp-tools/organizations/organization_show/) | Show the current Organization: name, owner, Accounts and billing. | Read only |
| [`organization_update`](/docs/ai-agents/mcp-tools/organizations/organization_update/) | Rename the current Organization or change its billing email. | Changes Blossom |

## [Permission Sets](/docs/ai-agents/mcp-tools/permission-sets/)

| Tool | What it does | Access |
|---|---|---|
| [`permission_set_create`](/docs/ai-agents/mcp-tools/permission-sets/permission_set_create/) | Create a Permission Set from scopes. | Changes Blossom |
| [`permission_set_delete`](/docs/ai-agents/mcp-tools/permission-sets/permission_set_delete/) | Delete a Permission Set no one uses. | Deletes; asks for `yes: true` |
| [`permission_set_list`](/docs/ai-agents/mcp-tools/permission-sets/permission_set_list/) | List the Organization's Permission Sets: named sets of scopes for members and tokens. | Read only |
| [`permission_set_scopes`](/docs/ai-agents/mcp-tools/permission-sets/permission_set_scopes/) | List every permission scope, with what it allows. | Read only |
| [`permission_set_show`](/docs/ai-agents/mcp-tools/permission-sets/permission_set_show/) | Show one Permission Set and its scopes. | Read only |
| [`permission_set_update`](/docs/ai-agents/mcp-tools/permission-sets/permission_set_update/) | Change a Permission Set's name, description, access mode or scopes. | Changes Blossom |

## [Users](/docs/ai-agents/mcp-tools/users/)

| Tool | What it does | Access |
|---|---|---|
| [`user_delete`](/docs/ai-agents/mcp-tools/users/user_delete/) | Delete the signed-in person's Blossom login. | Deletes; asks for `yes: true` |
| [`user_show`](/docs/ai-agents/mcp-tools/users/user_show/) | Show the signed-in person's profile, or another member's by id. | Read only |
| [`user_update`](/docs/ai-agents/mcp-tools/users/user_update/) | Change the signed-in person's name, username, email, time zone or theme. | Changes Blossom |

## [Cloud Providers](/docs/ai-agents/mcp-tools/cloud-providers/)

| Tool | What it does | Access |
|---|---|---|
| [`cloud_provider_check`](/docs/ai-agents/mcp-tools/cloud-providers/cloud_provider_check/) | Check that a connected cloud account's credentials and permissions still work. | Read only |
| [`cloud_provider_create`](/docs/ai-agents/mcp-tools/cloud-providers/cloud_provider_create/) | Get the link to connect a cloud account for Blossom BYOC. | Read only |
| [`cloud_provider_delete`](/docs/ai-agents/mcp-tools/cloud-providers/cloud_provider_delete/) | Disconnect a cloud account. | Deletes; asks for `yes: true` |
| [`cloud_provider_list`](/docs/ai-agents/mcp-tools/cloud-providers/cloud_provider_list/) | List the cloud accounts connected for Blossom BYOC, with provider and status. | Read only |
| [`cloud_provider_regions`](/docs/ai-agents/mcp-tools/cloud-providers/cloud_provider_regions/) | List the regions a connected cloud account offers. | Read only |
| [`cloud_provider_server_sizes`](/docs/ai-agents/mcp-tools/cloud-providers/cloud_provider_server_sizes/) | List the Server sizes a connected cloud account offers in a region, with price. | Read only |
| [`cloud_provider_show`](/docs/ai-agents/mcp-tools/cloud-providers/cloud_provider_show/) | Show one connected cloud account: provider, regions in use and status. | Read only |
| [`cloud_provider_types`](/docs/ai-agents/mcp-tools/cloud-providers/cloud_provider_types/) | List the cloud providers Blossom BYOC supports. | Read only |
| [`cloud_provider_update`](/docs/ai-agents/mcp-tools/cloud-providers/cloud_provider_update/) | Rename a connected cloud account or change its contact email or provider settings. | Changes Blossom |

## [Storage Providers](/docs/ai-agents/mcp-tools/storage-providers/)

| Tool | What it does | Access |
|---|---|---|
| [`cloud_storage_provider_create`](/docs/ai-agents/mcp-tools/storage-providers/cloud_storage_provider_create/) | Get the link to connect an object storage account. | Read only |
| [`cloud_storage_provider_delete`](/docs/ai-agents/mcp-tools/storage-providers/cloud_storage_provider_delete/) | Disconnect a storage account. | Deletes; asks for `yes: true` |
| [`cloud_storage_provider_list`](/docs/ai-agents/mcp-tools/storage-providers/cloud_storage_provider_list/) | List the connected object storage accounts used for backups. | Read only |
| [`cloud_storage_provider_show`](/docs/ai-agents/mcp-tools/storage-providers/cloud_storage_provider_show/) | Show one connected storage account. | Read only |
| [`cloud_storage_provider_types`](/docs/ai-agents/mcp-tools/storage-providers/cloud_storage_provider_types/) | List the object storage providers Blossom supports. | Read only |
| [`cloud_storage_provider_update`](/docs/ai-agents/mcp-tools/storage-providers/cloud_storage_provider_update/) | Rename a connected storage account or link it to a cloud account. | Changes Blossom |

## [Backup Storage](/docs/ai-agents/mcp-tools/backup-storage/)

| Tool | What it does | Access |
|---|---|---|
| [`backup_storage_create`](/docs/ai-agents/mcp-tools/backup-storage/backup_storage_create/) | Add backup storage in a connected storage account's bucket. | Changes Blossom |
| [`backup_storage_delete`](/docs/ai-agents/mcp-tools/backup-storage/backup_storage_delete/) | Delete a backup storage. | Deletes; asks for `yes: true` |
| [`backup_storage_list`](/docs/ai-agents/mcp-tools/backup-storage/backup_storage_list/) | List the Account's backup storage: where database and cache backups go. | Read only |
| [`backup_storage_show`](/docs/ai-agents/mcp-tools/backup-storage/backup_storage_show/) | Show one backup storage: provider, bucket and retention. | Read only |
| [`backup_storage_update`](/docs/ai-agents/mcp-tools/backup-storage/backup_storage_update/) | Change a backup storage's bucket, folder, region or retention. | Changes Blossom |

## [Container Registries](/docs/ai-agents/mcp-tools/container-registries/)

| Tool | What it does | Access |
|---|---|---|
| [`container_registry_create`](/docs/ai-agents/mcp-tools/container-registries/container_registry_create/) | Get the link to connect a private container registry. | Read only |
| [`container_registry_delete`](/docs/ai-agents/mcp-tools/container-registries/container_registry_delete/) | Disconnect a container registry. | Deletes; asks for `yes: true` |
| [`container_registry_list`](/docs/ai-agents/mcp-tools/container-registries/container_registry_list/) | List the private container registries connected to the Account. | Read only |
| [`container_registry_show`](/docs/ai-agents/mcp-tools/container-registries/container_registry_show/) | Show one connected container registry. | Read only |
| [`container_registry_types`](/docs/ai-agents/mcp-tools/container-registries/container_registry_types/) | List the container registries Blossom supports. | Read only |
| [`container_registry_update`](/docs/ai-agents/mcp-tools/container-registries/container_registry_update/) | Change a connected registry's name, URL, region or username. | Changes Blossom |

## [DNS Providers](/docs/ai-agents/mcp-tools/dns-providers/)

| Tool | What it does | Access |
|---|---|---|
| [`dns_provider_create`](/docs/ai-agents/mcp-tools/dns-providers/dns_provider_create/) | Get the link to connect a DNS provider for wildcard HTTPS. | Read only |
| [`dns_provider_delete`](/docs/ai-agents/mcp-tools/dns-providers/dns_provider_delete/) | Disconnect a DNS provider. | Deletes; asks for `yes: true` |
| [`dns_provider_list`](/docs/ai-agents/mcp-tools/dns-providers/dns_provider_list/) | List the DNS providers connected for wildcard HTTPS. | Read only |
| [`dns_provider_show`](/docs/ai-agents/mcp-tools/dns-providers/dns_provider_show/) | Show one connected DNS provider. | Read only |
| [`dns_provider_types`](/docs/ai-agents/mcp-tools/dns-providers/dns_provider_types/) | List the DNS providers Blossom supports. | Read only |
| [`dns_provider_update`](/docs/ai-agents/mcp-tools/dns-providers/dns_provider_update/) | Rename a connected DNS provider or link it to a cloud account. | Changes Blossom |

## [Git Providers](/docs/ai-agents/mcp-tools/git-providers/)

| Tool | What it does | Access |
|---|---|---|
| [`git_provider_check`](/docs/ai-agents/mcp-tools/git-providers/git_provider_check/) | Check that a connected Git provider still reaches its repositories. | Read only |
| [`git_provider_delete`](/docs/ai-agents/mcp-tools/git-providers/git_provider_delete/) | Disconnect a Git provider. | Deletes; asks for `yes: true` |
| [`git_provider_list`](/docs/ai-agents/mcp-tools/git-providers/git_provider_list/) | List the Git providers connected for private repositories, such as GitHub. | Read only |
| [`git_provider_show`](/docs/ai-agents/mcp-tools/git-providers/git_provider_show/) | Show one connected Git provider and the repositories it reaches. | Read only |
| [`git_provider_types`](/docs/ai-agents/mcp-tools/git-providers/git_provider_types/) | List the Git providers Blossom supports. | Read only |
| [`git_provider_update`](/docs/ai-agents/mcp-tools/git-providers/git_provider_update/) | Rename a connected Git provider. | Changes Blossom |

## [Git SSH Keys](/docs/ai-agents/mcp-tools/git-ssh-keys/)

| Tool | What it does | Access |
|---|---|---|
| [`git_ssh_key_create`](/docs/ai-agents/mcp-tools/git-ssh-keys/git_ssh_key_create/) | Create a Git SSH key. | Changes Blossom |
| [`git_ssh_key_delete`](/docs/ai-agents/mcp-tools/git-ssh-keys/git_ssh_key_delete/) | Delete a Git SSH key. | Deletes; asks for `yes: true` |
| [`git_ssh_key_list`](/docs/ai-agents/mcp-tools/git-ssh-keys/git_ssh_key_list/) | List the Account's Git SSH keys, with their public keys. | Read only |
| [`git_ssh_key_show`](/docs/ai-agents/mcp-tools/git-ssh-keys/git_ssh_key_show/) | Show one Git SSH key and its public key, to add to a Git host. | Read only |
| [`git_ssh_key_update`](/docs/ai-agents/mcp-tools/git-ssh-keys/git_ssh_key_update/) | Rename a Git SSH key. | Changes Blossom |

## [Help](/docs/ai-agents/mcp-tools/help/)

| Tool | What it does | Access |
|---|---|---|
| [`help`](/docs/ai-agents/mcp-tools/help/help/) | Start here. | Read only |
| [`help_all`](/docs/ai-agents/mcp-tools/help/help_all/) | Every Blossom tool in full: area, access, arguments, an example and its docs. | Read only |

## [Runtime Issues](/docs/ai-agents/mcp-tools/runtime-issues/)

| Tool | What it does | Access |
|---|---|---|
| [`runtime_issue_list`](/docs/ai-agents/mcp-tools/runtime-issues/runtime_issue_list/) | List why Blossom Apps aren't healthy: crashes, failed health checks and other runtime issues, newest first. | Read only |
| [`runtime_issue_show`](/docs/ai-agents/mcp-tools/runtime-issues/runtime_issue_show/) | Show one Blossom runtime issue: what failed, where, how often and when it was last seen. | Read only |

## [Activity](/docs/ai-agents/mcp-tools/activity/)

| Tool | What it does | Access |
|---|---|---|
| [`activity_list`](/docs/ai-agents/mcp-tools/activity/activity_list/) | List the Blossom Account's recent Activities (deploys, scaling, backups and other long-running work), newest first. | Read only |
| [`activity_logs`](/docs/ai-agents/mcp-tools/activity/activity_logs/) | Show the end of one Blossom Activity's log, to see how a deploy or other long-running work went and why it failed. | Read only |
| [`activity_show`](/docs/ai-agents/mcp-tools/activity/activity_show/) | Show one Blossom Activity: what it did, who or what started it, its status and when it ran. | Read only |
| [`activity_wait`](/docs/ai-agents/mcp-tools/activity/activity_wait/) | Wait for a Blossom Activity, such as a deploy, to finish: up to 50 seconds per call. | Read only |

## [Locations](/docs/ai-agents/mcp-tools/locations/)

| Tool | What it does | Access |
|---|---|---|
| [`location_add`](/docs/ai-agents/mcp-tools/locations/location_add/) | Save a Location: a region of Blossom Cloud or of a connected cloud account. | Changes Blossom |
| [`location_list`](/docs/ai-agents/mcp-tools/locations/location_list/) | List the Blossom Account's Locations (where Apps and Data run): provider, region, what runs there, and capacity in use against each Location's limit. | Read only |
| [`location_remove`](/docs/ai-agents/mcp-tools/locations/location_remove/) | Remove a saved Location. | Deletes; asks for `yes: true` |
| [`location_server_sizes`](/docs/ai-agents/mcp-tools/locations/location_server_sizes/) | List the Server sizes a Location offers, with price and whether Blossom may use each. | Read only |
| [`location_show`](/docs/ai-agents/mcp-tools/locations/location_show/) | Show one Location: provider, region, capacity limit and the Server sizes it may use. | Read only |
| [`location_update`](/docs/ai-agents/mcp-tools/locations/location_update/) | Rename a Location, or change its capacity maximum, architecture or allowed Server sizes. | Changes Blossom |

Your connection lists its current tools and arguments; this reference is
generated from the same definitions.
