Blossom Docs
Blossom

Mcp

Every page tagged mcp.

Account

Blossom MCP tools for account

Activity

Blossom MCP tools for activity

App Plans

Blossom MCP tools for app plans

Apps

Blossom MCP tools for apps

Backup Storage

Blossom MCP tools for backup storage

Backups

Blossom MCP tools for backups

Billing

Blossom MCP tools for billing

Blossom MCP Tools

Every tool the Blossom MCP server offers, by area

Builders

Blossom MCP tools for builders

Caches

Blossom MCP tools for caches

Capacity

Blossom MCP tools for capacity

Cloud Providers

Blossom MCP tools for cloud providers

Container Registries

Blossom MCP tools for container registries

Containers

Blossom MCP tools for containers

DNS Providers

Blossom MCP tools for dns providers

Database Instances

Blossom MCP tools for database instances

Databases

Blossom MCP tools for databases

Domains

Blossom MCP tools for domains

Environment Links

Blossom MCP tools for environment links

Environments

Blossom MCP tools for environments

Git Providers

Blossom MCP tools for git providers

Git Repos

Blossom MCP tools for git repos

Git SSH Keys

Blossom MCP tools for git ssh keys

Help

Blossom MCP tools for help

Jobs

Blossom MCP tools for jobs

Load Balancers

Blossom MCP tools for load balancers

Locations

Blossom MCP tools for locations

Logs

Blossom MCP tools for logs

Metrics

Blossom MCP tools for metrics

Organizations

Blossom MCP tools for organizations

Permission Sets

Blossom MCP tools for permission sets

Quickstarts

Blossom MCP tools for quickstarts

Registry Links

Blossom MCP tools for registry links

Releases

Blossom MCP tools for releases

Routes

Blossom MCP tools for routes

Runtime Issues

Blossom MCP tools for runtime issues

Services

Blossom MCP tools for services

Spending

Blossom MCP tools for spending

Storage Providers

Blossom MCP tools for storage providers

Users

Blossom MCP tools for users

Variables

Blossom MCP tools for variables

account_create

Create an Account in the Organization, optionally with its first Location.

account_delete

Delete an empty Account.

account_member_list

List the people with access to this Account and their roles.

account_member_remove

Remove a person's access to this Account.

account_member_show

Show one Account member: role, access and permissions.

account_member_update

Change an Account member's role, access mode or permissions.

account_show

Show one Blossom Account: its Organization, default Location and maintenance window.

account_update

Change this Account's default Location or maintenance window.

activity_list

List the Blossom Account's recent Activities (deploys, scaling, backups and other long-running work), newest first.

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.

activity_show

Show one Blossom Activity: what it did, who or what started it, its status and when it ran.

activity_wait

Wait for a Blossom Activity, such as a deploy, to finish: up to 50 seconds per call.

app_create

Create a Blossom App, the home for its Environments.

app_delete

Delete a Blossom App.

app_list

List the Blossom Apps in one Location.

app_plan_create

Save a Blossom App Plan from a Git repository: what it creates and its Capacity effect.

app_plan_delete

Discard a saved Blossom App Plan.

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.

app_plan_list

List saved Blossom App Plans in one Location, newest first, with the Environments each deployed.

app_plan_preview

Preview a Blossom App Plan without saving it: the App, Environment and Services it would create, and its Capacity effect.

app_plan_show

Show one Blossom App Plan: its intent, what it creates, its Capacity effect and its review link.

app_show

Show one Blossom App: its Location and Environments.

app_update

Rename a Blossom App.

backup_create

Back up a database, database instance or cache now.

backup_delete

Delete a backup.

backup_list

List backups of a database, database instance or cache, newest first.

backup_restore

Restore a backup into a new instance, optionally to a point in time.

backup_setting_show

Show the backup schedule and destination of a database, database instance or cache.

backup_setting_update

Change the backup schedule, retention or destination of a database, database instance or cache.

backup_show

Show one backup: target, size, status and when it ran.

backup_storage_create

Add backup storage in a connected storage account's bucket.

backup_storage_delete

Delete a backup storage.

backup_storage_list

List the Account's backup storage: where database and cache backups go.

backup_storage_show

Show one backup storage: provider, bucket and retention.

backup_storage_update

Change a backup storage's bucket, folder, region or retention.

billing_invoice_list

List the Organization's invoices, newest first, with amount and status.

billing_invoice_show

Show one invoice with its lines.

billing_profile

Show the Organization's billing: payment setup, plan, BYOC credit and this month's bill so far.

billing_usage

Show what the Organization is spending and where: usage by Account, Location and workload for a month or a range.

builder_create

Create a dedicated Builder in a region, within the capacity limit.

builder_delete

Delete a dedicated Builder; builds use the region's default or App capacity.

builder_list

List the Account's dedicated Builders, with region, size and state.

builder_show

Show one Builder: region, size, idle retention and recent builds.

builder_update

Change a Builder's name, size, timeout or idle retention, or make it the region's default.

cache_instance_create

Create a managed cache (Redis or Memcached) within the capacity limit.

cache_instance_credentials_rotate

Rotate a cache's password; Blossom generates the new one.

cache_instance_delete

Delete a cache and its data.

cache_instance_list

List caches in a Location, with size, availability and status.

cache_instance_replica_create

Add a read replica to a cache within the capacity limit.

cache_instance_replica_delete

Remove a cache read replica.

cache_instance_replica_list

List the read replicas of a cache.

cache_instance_replica_show

Show one cache read replica.

cache_instance_show

Show one cache: size, storage, nodes and endpoints.

cache_instance_standby_list

List the standby of a cache.

cache_instance_standby_show

Show a cache standby.

cache_instance_switchover

Promote the standby of a cache to primary.

cache_instance_update

Change a cache: grow storage, standby, public access, deletion protection, backup storage.

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

capacity_limit_request_list

List the Account's requests for a higher capacity limit and their status.

capacity_list

List the Account's Capacity: App, Data, Builder and Persistent, with allocation, state and monthly rate.

capacity_retire

Retire idle Capacity now instead of after its warm period, such as an idle Builder.

capacity_show

Show one Capacity allocation: reservation mode, reserved room, ceiling, Servers and rate.

capacity_update

Change how much Capacity an Account keeps: reservation mode (on_demand, automatic or custom), reserved room, ceiling or idle retention.

cloud_provider_check

Check that a connected cloud account's credentials and permissions still work.

cloud_provider_create

Get the link to connect a cloud account for Blossom BYOC.

cloud_provider_delete

Disconnect a cloud account.

cloud_provider_list

List the cloud accounts connected for Blossom BYOC, with provider and status.

cloud_provider_regions

List the regions a connected cloud account offers.

cloud_provider_server_sizes

List the Server sizes a connected cloud account offers in a region, with price.

cloud_provider_show

Show one connected cloud account: provider, regions in use and status.

cloud_provider_types

List the cloud providers Blossom BYOC supports.

cloud_provider_update

Rename a connected cloud account or change its contact email or provider settings.

cloud_storage_provider_create

Get the link to connect an object storage account.

cloud_storage_provider_delete

Disconnect a storage account.

cloud_storage_provider_list

List the connected object storage accounts used for backups.

cloud_storage_provider_show

Show one connected storage account.

cloud_storage_provider_types

List the object storage providers Blossom supports.

cloud_storage_provider_update

Rename a connected storage account or link it to a cloud account.

container_list

List the Containers of an Environment or Service, with state, health, Server and Release.

container_registry_create

Get the link to connect a private container registry.

container_registry_delete

Disconnect a container registry.

container_registry_list

List the private container registries connected to the Account.

container_registry_show

Show one connected container registry.

container_registry_types

List the container registries Blossom supports.

container_registry_update

Change a connected registry's name, URL, region or username.

container_show

Show one Container: state, health, restarts, Server and Release.

database_create

Create a database, with its own role, in a database instance.

database_delete

Delete a database and its data from its instance.

database_import

Import a database dump into a new database of a database instance, from an upload or a backup.

database_instance_create

Create a managed database instance (PostgreSQL, MySQL, MariaDB or MongoDB) within the capacity limit.

database_instance_credentials_rotate

Rotate a database instance's password; Blossom generates the new one.

database_instance_delete

Delete a database instance and its data.

database_instance_list

List database instances in a Location, with engine, size, availability and status.

database_instance_replica_create

Add a read replica to a database instance within the capacity limit.

database_instance_replica_delete

Remove a database read replica.

database_instance_replica_list

List the read replicas of a database instance.

database_instance_replica_show

Show one database read replica: placement, lag and endpoint.

database_instance_retry

Retry a database instance's failed provisioning.

database_instance_show

Show one database instance: engine, size, storage, nodes, backups and endpoints.

database_instance_standby_list

List the standby of a database instance.

database_instance_standby_show

Show a database standby: placement, lag and readiness.

database_instance_switchover

Promote the standby of a database instance to primary.

database_instance_update

Change a database instance: grow storage, standby, public access, deletion protection, backup storage.

database_instance_upgrade

Upgrade a database instance to the next major version.

database_list

List the databases in a database instance, or in the Account.

database_maintenance_disable

Take a database out of maintenance mode.

database_maintenance_enable

Put a database in maintenance mode: connections are refused until it is disabled.

database_maintenance_show

Show whether a database is in maintenance mode.

database_retry

Retry a database's failed creation.

database_show

Show one database: instance, size, status and links.

database_upload_delete

Delete a database dump upload.

database_upload_list

List database dump uploads waiting to be imported.

database_upload_show

Show one database dump upload: size, status and expiry.

dns_provider_create

Get the link to connect a DNS provider for wildcard HTTPS.

dns_provider_delete

Disconnect a DNS provider.

dns_provider_list

List the DNS providers connected for wildcard HTTPS.

dns_provider_show

Show one connected DNS provider.

dns_provider_types

List the DNS providers Blossom supports.

dns_provider_update

Rename a connected DNS provider or link it to a cloud account.

domain_create

Add a custom domain to an Environment, such as www.example.com.

domain_delete

Remove a custom domain; it stops routing to the Environment.

domain_list

List an Environment's custom domains, with DNS and HTTPS status.

domain_show

Show one domain: the DNS records to add and its HTTPS status.

domain_update

Change a domain's Service, mode or main flag.

env_var_create

Set an Environment variable.

env_var_delete

Delete an Environment variable.

env_var_list

List an Environment's variables.

env_var_show

Show one Environment variable.

env_var_update

Change an Environment variable's value or build flag.

environment_access_link_create

Get the link to create a shareable link that opens a private Environment in a browser.

environment_access_link_list

List a private Environment's access links: name, expiry and status.

environment_access_link_revoke

Revoke an access link; it stops working at once.

environment_access_link_show

Show one access link: name, expiry and status.

environment_access_link_update

Rename an access link.

environment_access_token_create

Get the link to create a token that lets scripts and agents call a private Environment.

environment_access_token_list

List a private Environment's access tokens: name, expiry and status.

environment_access_token_revoke

Revoke an access token; it stops working at once.

environment_access_token_show

Show one access token: name, expiry and status.

environment_access_token_update

Rename an access token.

environment_activity

List one Blossom Environment's recent Activities (deploys, scaling, restarts), newest first.

environment_build_config_show

Show how an Environment builds: build type and Builder.

environment_build_config_update

Change how an Environment builds, such as dockerfile or a Builder.

environment_create

Add an Environment to an App, such as staging.

environment_delete

Delete an Environment, its Containers and its data.

environment_deploy

Deploy a Blossom Environment: build its source and release it within the Account's capacity limit.

environment_deploy_hooks_show

Show an Environment's deploy hooks: the release phase, such as migrations, and post-deploy command.

environment_deploy_hooks_update

Set an Environment's release phase (such as migrations) or post-deploy command.

environment_link_create

Link an Environment to a Database or Cache; Blossom sets the connection URL variable, such as DATABASE_URL.

environment_link_delete

Remove a link; the connection URL variable goes away on the next deploy.

environment_link_list

List an Environment's links to Databases and Caches.

environment_link_show

Show one link: its target and the variable that holds the connection URL.

environment_link_update

Rename the variable a link sets.

environment_list

List Blossom Environments with each one's URL, deploy status and health (runtime), for one App or one Location.

environment_load_balancer_show

Show an Environment's routing settings: basic auth and extra Caddy configuration.

environment_load_balancer_update

Change an Environment's routing settings: basic auth on or off, extra Caddy configuration.

environment_maintenance_disable

Take an Environment out of maintenance mode and serve the App again.

environment_maintenance_enable

Put an Environment in maintenance mode: visitors get a maintenance page until it is disabled.

environment_maintenance_show

Show whether an Environment is in maintenance mode, which serves a maintenance page instead of the App.

environment_pending_changes_show

Show the configuration changes an Environment's next deploy will apply.

environment_preview_create

Open a Preview of an Environment for a branch, such as a pull request's, and start its first deploy.

environment_preview_data_delete

Delete the data new Previews start from; later Previews start empty.

environment_preview_data_show

Show the data new Previews of an Environment start from: its source, size and when it was uploaded.

environment_preview_delete_all

Delete every Preview of an Environment, with their Containers and data.

environment_preview_list

List an Environment's Previews: branch, who created them, status and URL.

environment_preview_settings

Show how an Environment's Previews work: expiry, limit, pull requests, branch pattern, setup command and size.

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.

environment_scale

Scale one Service of an Environment by name, such as web to 3, within the Account's capacity limit.

environment_show

Show one Blossom Environment: URL, deploy status, health, each Service's running and ready Containers, and anything blocking a deploy.

environment_update

Change an Environment's settings: deletion protection, automatic deploys, access, Previews.

git_provider_check

Check that a connected Git provider still reaches its repositories.

git_provider_delete

Disconnect a Git provider.

git_provider_list

List the Git providers connected for private repositories, such as GitHub.

git_provider_show

Show one connected Git provider and the repositories it reaches.

git_provider_types

List the Git providers Blossom supports.

git_provider_update

Rename a connected Git provider.

git_repo_create

Set the Git repository an Environment deploys from.

git_repo_delete

Remove an Environment's Git source.

git_repo_list

List the Git sources Environments deploy from.

git_repo_show

Show one Git source: repository, branch and folder.

git_repo_update

Change an Environment's repository, branch or folder.

git_ssh_key_create

Create a Git SSH key.

git_ssh_key_delete

Delete a Git SSH key.

git_ssh_key_list

List the Account's Git SSH keys, with their public keys.

git_ssh_key_show

Show one Git SSH key and its public key, to add to a Git host.

git_ssh_key_update

Rename a Git SSH key.

help

Start here.

help_all

Every Blossom tool in full: area, access, arguments, an example and its docs.

job_create

Save a Job definition for an Environment.

job_delete

Delete a saved Job and its schedule.

job_list

List saved Jobs, for one Environment or the whole Account, with their schedules.

job_run_cancel

Cancel a queued or running Job Run.

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.

job_run_list

List Job Runs for an Environment or Job, newest first, with status and exit code.

job_run_logs

Read a Job Run's output.

job_run_show

Show one Job Run: its command, status, exit code and timing.

job_show

Show one saved Job: its command, size, schedule and latest Runs.

job_update

Change a saved Job's command, size, timeout or schedule.

load_balancer_list

List the Account's Load Balancers, one per Location, with their outcome.

load_balancer_show

Show one Load Balancer: outcome, instances and IP.

load_balancer_update

Choose a Location's Load Balancer outcome (integrated, dedicated, highly_available) and static IP.

location_add

Save a Location: a region of Blossom Cloud or of a connected cloud account.

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.

location_remove

Remove a saved Location.

location_server_sizes

List the Server sizes a Location offers, with price and whether Blossom may use each.

location_show

Show one Location: provider, region, capacity limit and the Server sizes it may use.

location_update

Rename a Location, or change its capacity maximum, architecture or allowed Server sizes.

logs

Read recent log lines from an Environment's or Service's Containers, newest last.

metric_source_list

List the metrics an Environment offers: source types and scopes to pass to metric_stream_create.

metric_stream_create

Start a metric stream for an Environment's Containers, then read it with metric_stream_show.

metric_stream_list

List the metric streams of an Environment.

metric_stream_show

Show a metric stream and its latest values, such as CPU and memory per Container.

organization_close

Close an Organization: its final invoice closes and it can no longer be used.

organization_create

Create an Organization, with its first Account, owned by the signed-in person.

organization_delete

Delete an Organization with no billing history.

organization_invitation_create

Invite someone to the Organization by email, such as sam@example.com as a member, with Account access.

organization_invitation_delete

Cancel a pending invitation.

organization_invitation_list

List pending invitations to the Organization.

organization_invitation_resend

Send an invitation's email again.

organization_invitation_show

Show one invitation: who, role, Account access and status.

organization_invitation_update

Change a pending invitation's role, Account access or permissions.

organization_list

List the Organizations the signed-in person belongs to.

organization_member_list

List the Organization's members, their roles and Account access.

organization_member_remove

Remove a person from the Organization and all its Accounts.

organization_member_show

Show one Organization member: role, Account access and permissions.

organization_member_update

Change an Organization member's role, Account access or permissions.

organization_show

Show the current Organization: name, owner, Accounts and billing.

organization_update

Rename the current Organization or change its billing email.

permission_set_create

Create a Permission Set from scopes.

permission_set_delete

Delete a Permission Set no one uses.

permission_set_list

List the Organization's Permission Sets: named sets of scopes for members and tokens.

permission_set_scopes

List every permission scope, with what it allows.

permission_set_show

Show one Permission Set and its scopes.

permission_set_update

Change a Permission Set's name, description, access mode or scopes.

quickstart_list

List Blossom Quickstarts: example Apps an App Plan can start from with quickstart: KEY.

registry_link_create

Let an Environment pull from a connected container registry.

registry_link_delete

Remove a registry link.

registry_link_list

List the container registries Environments pull from.

registry_link_show

Show one registry link.

registry_link_update

Point a registry link at another registry.

release_cancel

Cancel a Blossom Release that is still building or rolling out.

release_list

List a Blossom Environment's Releases, newest first: version, status, Git SHA and when each ran.

release_rollback

Roll a Blossom Environment back to an earlier succeeded Release.

release_show

Show one Blossom Release: its version, image, Git SHA, status and Activity.

route_create

Route a path prefix, such as /api, to a Service of the Environment.

route_delete

Remove a path route.

route_list

List an Environment's path routes to Services.

route_show

Show one route.

runtime_issue_list

List why Blossom Apps aren't healthy: crashes, failed health checks and other runtime issues, newest first.

runtime_issue_show

Show one Blossom runtime issue: what failed, where, how often and when it was last seen.

service_create

Add a Service to an Environment, such as a worker.

service_delete

Delete a Service and stop its Containers.

service_list

List the Services of one Environment or App, with each one's command, size and URL.

service_regenerate_url

Give a Service a new generated URL.

service_restart

Restart a Service's Containers one at a time, keeping it available.

service_scale

Set how many Containers a Service runs, within the Account's capacity limit.

service_show

Show one Service: its command, port, size, health check, desired and running Containers, and URL.

service_update

Change a Service's command, port, size, health check or storage.

spending_show

Show the Account's spending: this month's bill so far, the capacity limit and the email warning amount.

spending_update

Set the email warning amount, or turn the warning on or off.

user_delete

Delete the signed-in person's Blossom login.

user_show

Show the signed-in person's profile, or another member's by id.

user_update

Change the signed-in person's name, username, email, time zone or theme.

whoami

Show the Blossom user, Organization, Account and access this connection uses.