---
title: database_instance_replica_create
url: "/docs/ai-agents/mcp-tools/database-instances/database_instance_replica_create/"
canonical_url: https://docs.blossom88.com/docs/ai-agents/mcp-tools/database-instances/database_instance_replica_create/
markdown_url: https://docs.blossom88.com/docs/ai-agents/mcp-tools/database-instances/database_instance_replica_create.md
summary: Add a read replica to a database instance within the capacity limit.
categories:
- mcp
- reference
---

# database_instance_replica_create

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

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

## Arguments

| Argument | Type | Description |
|---|---|---|
| `data` | object | A read replica, as in database_replica.yml. Required. |
| `data.database_instance_id` | string | Primary instance id. |
| `data.placement_mode` | string | Where the node runs: automatic or a chosen Server. |
| `data.location_id` | string | Location id. |
| `data.server_id` | string | Server id for a chosen placement. |
| `data.server_spec` | object | BYOC only: the Server to create for this node. |

## Example

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