---
name: "inventory_locations"
area: "inventory"
title: "List locations"
price: "free"
method: "POST"
url: "https://api.conecto.chat/v1/tools/inventory_locations"
mcp_server: "https://api.conecto.chat/mcp/inventory"
auth: "Authorization: Bearer <conecto_sk_ key>"
docs_url: "https://conecto.chat/tools/inventory/inventory_locations"
---

# List locations (`inventory_locations`)

Every location with how many items it holds and their value.

Every location with how many items it holds and their value at the moving average.

Price: Free up to 1,000,000 reads a month for the whole account, then $0.50 per 10,000 reads. A call that fails costs nothing.

## Use it when

Someone asks how stock is spread, or a location's name is needed.

## Say this to your agent

> How much stock do we hold at the test kitchen compared with the warehouse, in euros?

## Inputs

| Name | Type | Required | Description | Allowed values | Default |
|---|---|---|---|---|---|
| `include_archived` | boolean | no |  |  | `false` |

## Example

Written for Hansen & Voss, a restaurant-equipment wholesaler in Hamburg with 60 staff.

MCP: call `inventory_locations` on the MCP server `https://api.conecto.chat/mcp/inventory` with these arguments:

```json
{}
```

REST:

```bash
curl https://api.conecto.chat/v1/tools/inventory_locations \
  -H "Authorization: Bearer $CONECTO_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

## Response

```json
{
  "call_id": "5f0c8a2e-3b7d-4c1e-9a64-2d8e1f7b0c93",
  "tool": "inventory_locations",
  "status": "succeeded",
  "replayed": false,
  "cost_usd": "$0.00",
  "balance_usd": "$19.75",
  "result": {
    "locations": [
      {
        "name": "Main",
        "description": null,
        "items": 3,
        "value": {
          "EUR": "15400.00"
        },
        "archived": false
      },
      {
        "name": "Test kitchen",
        "description": "Billbrookdeich 112",
        "items": 2,
        "value": {
          "EUR": "29430.00"
        },
        "archived": false
      }
    ]
  }
}
```

`result`: locations: each with its name, description, how many items it holds, their value per currency, and archived.

## Errors

This tool has no errors of its own.

The refusals every tool can give (401 key, 402 balance, 429 limits) are on the errors page: https://conecto.chat/docs/errors.md

## Related

- [inventory_save_items](https://conecto.chat/tools/inventory/inventory_save_items.md): Adds stock items or changes them by SKU: name, unit, barcode, cost, price and reorder point. $0.005 per item saved.
- [inventory_list_items](https://conecto.chat/tools/inventory/inventory_list_items.md): Items with their stock in total and per location, the moving-average cost and the value. Free up to 1,000,000 reads a month.
- [inventory_move](https://conecto.chat/tools/inventory/inventory_move.md): Changes stock, all moves or none: receive, ship, transfer between locations, or adjust. $0.005 per move.
- [inventory_stocktake](https://conecto.chat/tools/inventory/inventory_stocktake.md): Records a count of one location; each difference from the books becomes a count move. $0.002 per line counted.
- [inventory_history](https://conecto.chat/tools/inventory/inventory_history.md): Stock moves, newest first, of one item, at one location, of one kind, or in a period. Free up to 1,000,000 reads a month.
- [inventory_save_location](https://conecto.chat/tools/inventory/inventory_save_location.md): Adds a location (a warehouse, a shop, a van), or renames, describes or archives one. $0.001 a call.
- [inventory_report](https://conecto.chat/tools/inventory/inventory_report.md): Valuation (what was held on a day and its value), movement (per item in a period, with the cost of goods shipped) or low stock. Free up to 1,000,000 reads a month.
- [inventory_import](https://conecto.chat/tools/inventory/inventory_import.md): Creates or changes items from a CSV in the file store, with optional quantities per location; all rows or none. $0.001 per row imported.
- [inventory_export](https://conecto.chat/tools/inventory/inventory_export.md): A CSV of the items (per location, with quantities and value) or of the moves in a period, with a download link. $0.001 a call.