# Micro-store and orders

> MCP tools to build micro-stores with a cart from the catalog and manage the orders they generate.

- kind: mcp-tool
- status: stable
- access: destructive
- last_verified: 2026-10-07
- url: https://tilopay.com/en/developers/agentes/mcp/microtienda

## What it covers [#que-cubre]

From the products in the [catalog](/en/developers/agentes/mcp/catalogo) the agent builds a
**micro-store with a cart**: a public page with several products where the customer picks
quantities and pays for everything at once. Each micro-store has its own link.

The second half of the group is **order management**: it is set up once (store name, optional logo
and the time of the daily reminder), and from then on you can see the summary, list orders
by status, see the ones paid but not delivered and mark them as delivered.

Order statuses are `pending` (awaiting payment), `paid` (paid, not delivered) and `delivered`.
Deactivating a micro-store or turning off order management does not delete catalog products or
orders already recorded.

These tools do not call the Tilopay API: they work on the MCP server's own data, except the
payment itself, which goes through each product's payment link.

## Tools [#herramientas]

### Create a micro-store with cart [#tilopay-store-create]

- `tilopay_store_create`
- Access: Write

Creates a micro-store link to share with a customer: it shows the catalog products, the customer builds a cart and pays at the end from the same page with a link that includes the cart detail. By default it includes the whole catalog; it can be limited to certain product IDs.

**Parameters**

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `title` | string | — | Visible store title |
| `item_ids` | array<string> | — | Catalog product IDs to show; if omitted, the whole catalog is shown |

**Returns**

`{ slug, url, items }`

slug = the micro-store identifier; url = public store link with cart; items = how many catalog products were included.

### List active micro-stores [#tilopay-store-list]

- `tilopay_store_list`
- Access: Read only

Lists the merchant's active micro-stores with their sharing link.

**Parameters**

No parameters.

**Returns**

`{ stores[] }`

stores = active micro-stores with slug, title, public link and the product ids each one includes.

### Disable a micro-store [#tilopay-store-delete]

- `tilopay_store_delete`
- Access: Sensitive
- Requires confirmation: https://tilopay.com/en/developers/agentes/mcp/permisos#confirmaciones

Deactivates a micro-store by its slug: the link stops opening. Confirm with the merchant before using it.

**Parameters**

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `slug` | string | yes | Store slug (the end of its link) |

**Returns**

`{ slug, active }`

Disables the micro-store: the link stops showing products. active is set to false; the catalog products are not deleted.

### Connect a custom domain to the store [#tilopay-store-domain-connect]

- `tilopay_store_domain_connect`
- Access: Write

Connects a merchant's own domain (e.g. tienda.minegocio.com) to their micro-store. It registers it immediately and returns the CNAME instruction. Use it only when the merchant gives the domain.

**Parameters**

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `hostname` | string | yes | Domain, e.g. tienda.minegocio.com |
| `slug` | string | — | Store slug; if omitted, the most recent |

**Returns**



### Status of custom domains [#tilopay-store-domain-status]

- `tilopay_store_domain_status`
- Access: Read only

Checks the status of the custom domains of the merchant's stores (via Cloudflare).

**Parameters**

No parameters.

**Returns**

`{ domains }`

domains = custom domains connected to the merchant and their status.

### Remove a custom domain [#tilopay-store-domain-remove]

- `tilopay_store_domain_remove`
- Access: Sensitive
- Requires confirmation: https://tilopay.com/en/developers/agentes/mcp/permisos#confirmaciones

Disconnects a custom domain from the store; the store stays at its tilopay.shop address. Confirm with the merchant before using it.

**Parameters**

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `hostname` | string | yes | Custom domain to disconnect (4–253 characters), connected by that merchant |

**Returns**

`{ hostname, removed }`

hostname = disconnected domain; removed = true if it was removed.

### Turn on or configure order management [#tilopay-orders-setup]

- `tilopay_orders_setup`
- Access: Write

Turns on order tracking for the micro-store and saves the store name, the logo and the time of the daily reminder for paid, undelivered orders. It is also used to change any of that data later. The logo can be an https link to an image or the image the merchant just sent over WhatsApp (pass the reference shown in the message).

**Parameters**

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `store_name` | string | — | Visible store name |
| `logo` | string | — | https link of the logo image, or the reference of the image sent over WhatsApp |
| `reminder_time` | string | — | Local time of the daily reminder in HH:mm format (e.g. "18:00"); empty disables it |

**Returns**

`{ orders_enabled, store_name, has_logo, reminder_time }`

Leaves order management on and returns the resulting configuration: the store name customers see, whether a logo is loaded and the time of the daily pending-orders reminder.

### View store and order settings [#tilopay-orders-settings]

- `tilopay_orders_settings`
- Access: Read only

Shows whether order management is on, the store name, whether there is a logo and the time of the daily reminder.

**Parameters**

No parameters.

**Returns**

`{ orders_enabled, store_name, has_logo, reminder_time }`

Current store and order configuration, without changing anything.

### Order summary [#tilopay-orders-status]

- `tilopay_orders_status`
- Access: Read only

Summary of the micro-stores' orders: how many are pending payment, how many are paid and undelivered (with their amount) and how many were delivered today.

**Parameters**

No parameters.

**Returns**

`{ pending, paid, delivered, ... }`

Order summary: how many are pending payment, paid and undelivered, and delivered, with the period's amounts.

### List orders [#tilopay-orders-list]

- `tilopay_orders_list`
- Access: Read only

Lists the micro-stores' orders with their code, customer, total and detail. It can be filtered by status (pending = pending payment, paid = paid and undelivered, delivered = delivered) and by the last days.

**Parameters**

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `status` | string (pending | paid | delivered | all) | — | Order status; all by default |
| `days` | integer | — | Only orders from the last N days |
| `limit` | integer | — | 1–100 (25 by default) |

**Returns**

`{ orders[] }`

orders = orders with code, customer, total, currency, status and date. It can be filtered by status (pending, paid, delivered, all) and by the last days.

### Paid, undelivered orders [#tilopay-orders-pending]

- `tilopay_orders_pending`
- Access: Read only

Lists the orders already paid that have not been delivered yet. This is the tool used by the daily reminder.

**Parameters**

No parameters.

**Returns**

`{ pending, orders[] }`

pending = how many orders are paid and undelivered; orders = those orders with code, customer, total and currency.

### Mark an order as delivered [#tilopay-order-mark-delivered]

- `tilopay_order_mark_delivered`
- Access: Write

Marks one or several orders as delivered. It accepts the order code (e.g. "#A3F2", even several in the same message) or the customer name.

**Parameters**

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `code` | string | — | Order code, e.g. "#A3F2"; several can be given |
| `client` | string | — | Customer name of the order |

**Returns**

`{ delivered, missing }`

delivered = how many orders were marked as delivered; missing = the codes that were not found.

### Turn off order management [#tilopay-orders-disable]

- `tilopay_orders_disable`
- Access: Sensitive
- Requires confirmation: https://tilopay.com/en/developers/agentes/mcp/permisos#confirmaciones

Turns off order tracking and cancels the daily reminder. Already registered orders are kept. Ask for an explicit yes before using it.

**Parameters**

No parameters.

**Returns**

`{ orders_enabled: false }`

Turns off order management. Already registered orders are kept.