# Tools

The MCP server builds its tools from the [Open API](/developers/api/en): each endpoint group (business area) becomes a tool named `pos_<area>`. Areas with both read and write actions are split into two tools, the write tool ending in `_write`, so clients can allow each kind separately.

Each tool takes an `action` parameter that selects the operation, for example `pos_order` with `action: "list"` to list orders. The list below is generated from the current Open API, the same list your client receives.

## Looking up parameters

To keep the tool list small, clients only receive action names. Before calling an action, the AI calls `pos_describe` to get its full parameters and description:

```json
{ "tool": "pos_order", "action": "list" }
```

You never need to call `pos_describe` yourself; the AI does it when needed.

## Available tools

| Tool | Access | Area | Actions |
|---|---|---|---|
| `pos_address` | Read | Address | 3 |
| `pos_ads_manager` | Read | Ads Manager | 4 |
| `pos_auto_voice` | Write | Auto Voice | 1 |
| `pos_call_later` | Read | Call Later | 1 |
| `pos_call_later_write` | Write | Call Later | 1 |
| `pos_combo` | Read | Combo | 1 |
| `pos_combo_write` | Write | Combo | 1 |
| `pos_customer` | Read | Customer | 5 |
| `pos_customer_write` | Write | Customer | 4 |
| `pos_debt` | Read | Debt | 1 |
| `pos_e_commerce` | Read | eCommerce | 4 |
| `pos_e_invoice` | Read | E-Invoice | 1 |
| `pos_employee` | Read | Employee | 1 |
| `pos_export` | Read | Export | 2 |
| `pos_export_write` | Write | Export | 2 |
| `pos_livestream` | Read | Livestream | 1 |
| `pos_lot` | Read | Lot | 1 |
| `pos_order` | Read | Order | 9 |
| `pos_order_tag` | Read | Order tag | 2 |
| `pos_order_tag_write` | Write | Order tag | 2 |
| `pos_order_write` | Write | Order | 7 |
| `pos_product` | Read | Product | 7 |
| `pos_product_write` | Write | Product | 8 |
| `pos_promotion` | Read | Promotion | 1 |
| `pos_promotion_write` | Write | Promotion | 3 |
| `pos_purchase` | Read | Purchase | 2 |
| `pos_purchase_write` | Write | Purchase | 3 |
| `pos_reconciliation` | Read | Reconciliation | 1 |
| `pos_shop` | Read | Shop | 2 |
| `pos_statistics` | Read | Statistics | 4 |
| `pos_statistics_customer_analytics` | Read | Statistics customer analytics | 1 |
| `pos_statistics_inventory_analytics` | Read | Statistics inventory analytics | 2 |
| `pos_stocktaking` | Read | Stocktaking | 2 |
| `pos_stocktaking_write` | Write | Stocktaking | 2 |
| `pos_supplier` | Read | Supplier | 1 |
| `pos_transaction` | Read | Transaction | 2 |
| `pos_transaction_write` | Write | Transaction | 2 |
| `pos_voucher` | Read | Voucher | 2 |
| `pos_voucher_write` | Write | Voucher | 1 |
| `pos_warehouse` | Read | Warehouse | 2 |
| `pos_warehouse_transfer` | Read | Warehouse Transfer | 3 |
| `pos_warehouse_transfer_write` | Write | Warehouse Transfer | 2 |
| `pos_warehouse_write` | Write | Warehouse | 2 |
| `pos_webhook` | Write | Webhook | 1 |

Each tool maps to a group in the [Open API reference](/developers/api/en); parameters and returned data match the corresponding endpoints.
