---
title: app_create
url: "/docs/ai-agents/mcp-tools/apps/app_create/"
canonical_url: https://docs.blossom88.com/docs/ai-agents/mcp-tools/apps/app_create/
markdown_url: https://docs.blossom88.com/docs/ai-agents/mcp-tools/apps/app_create.md
summary: Create a Blossom App, the home for its Environments.
categories:
- mcp
- reference
---

# app_create

Create a Blossom App, the home for its Environments. app_plan_create is the usual way to start from a repository.

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

## Arguments

| Argument | Type | Description |
|---|---|---|
| `data` | object | The App, as in app.yml from app:init. Required. |
| `data.name` | string | App name. |
| `data.location_id` | string | Location id; defaults to the Account's default Location. |
| `location` | string | Location id; sets data.location_id. |

## Example

```json
{"data":{"clone_url":"https://github.com/acme/shop","services":[{"name":"web","command":"web","port":3000,"publicly_exposed":true}]}}
```