---
title: environment_preview_create
url: "/docs/ai-agents/mcp-tools/environments/environment_preview_create/"
canonical_url: https://docs.blossom88.com/docs/ai-agents/mcp-tools/environments/environment_preview_create/
markdown_url: https://docs.blossom88.com/docs/ai-agents/mcp-tools/environments/environment_preview_create.md
summary: Open a Preview of an Environment for a branch, such as a pull request's,
  and start its first deploy.
categories:
- mcp
- reference
---

# environment_preview_create

Open a Preview of an Environment for a branch, such as a pull request's, and start its first deploy. It uses the Environment's settings and preview size, within the capacity limit. Returns the Preview and the deploy's Activity; follow it with activity_wait.

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

## Arguments

| Argument | Type | Description |
|---|---|---|
| `id` | string | Environment the Preview copies. Required. |
| `branch` | string | Git branch to deploy. Required. |
| `name` | string | Preview name; derived from the branch by default. |
| `no_deploy` | boolean | Create without starting the first deploy. |

## Example

```json
{"id":"environment-100","branch":"branch-100"}
```