---
title: environment_scale
url: "/docs/ai-agents/mcp-tools/environments/environment_scale/"
canonical_url: https://docs.blossom88.com/docs/ai-agents/mcp-tools/environments/environment_scale/
markdown_url: https://docs.blossom88.com/docs/ai-agents/mcp-tools/environments/environment_scale.md
summary: Scale one Service of an Environment by name, such as web to 3, within the
  Account's capacity limit.
categories:
- mcp
- reference
---

# environment_scale

Scale one Service of an Environment by name, such as web to 3, within the Account's capacity limit. Returns the Activity; follow it with activity_wait.

| | |
|---|---|
| Access | Changes Blossom |
| Same as | [`blossom environment:scale`](/docs/reference/cli/environment/scale/) |

## Arguments

| Argument | Type | Description |
|---|---|---|
| `id` | string | Environment id. Required. |
| `service` | string | Service name or id; optional when the Environment has one Service. |
| `desired_size` | integer | Number of Containers. Required. |

## Example

```json
{"id":"environment-100","desired_size":1}
```