---
title: service_create
url: "/docs/ai-agents/mcp-tools/services/service_create/"
canonical_url: https://docs.blossom88.com/docs/ai-agents/mcp-tools/services/service_create/
markdown_url: https://docs.blossom88.com/docs/ai-agents/mcp-tools/services/service_create.md
summary: Add a Service to an Environment, such as a worker.
categories:
- mcp
- reference
---

# service_create

Add a Service to an Environment, such as a worker. It starts with the Environment's next deploy.

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

## Arguments

| Argument | Type | Description |
|---|---|---|
| `data` | object | The Service, as in service.yml from service:init. Required. |
| `data.environment_id` | string | Environment id. |
| `data.name` | string | Service name, such as web or worker. |
| `data.command` | string | Command the Container runs. |
| `data.entrypoint` | string | Optional entrypoint override. |
| `data.port` | integer | Port the process listens on. |
| `data.publicly_exposed` | boolean | Give the Service a public URL. |
| `data.desired_size` | integer | Number of Containers. |
| `data.enabled` | boolean | — |
| `data.health_check` | object | Health check; runtime readiness gates routing. |
| `data.storage` | object | Persistent storage. |
| `data.resources` | object | Container size: a preset, or custom with cpu_vcpus and memory_gb. |

## Example

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