---
title: Environments
url: "/docs/ai-agents/mcp-tools/environments/"
canonical_url: https://docs.blossom88.com/docs/ai-agents/mcp-tools/environments/
markdown_url: https://docs.blossom88.com/docs/ai-agents/mcp-tools/environments.md
summary: Blossom MCP tools for environments
categories:
- mcp
- reference
---

# Environments

Blossom MCP tools for environments. See [all MCP tools](/docs/ai-agents/mcp-tools/).

| 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 |