Stock history
Stock moves, newest first, of one item, at one location, of one kind, or in a period.
Free*
*Free up to 1,000,000 reads a month for the whole account, then $0.50 per 10,000 reads.
An example
Where did the black bistro chairs go this month?
Your agent callsinventory_historyFree*
The example business is Hansen & Voss, a restaurant-equipment wholesaler in Hamburg with 60 staff. The reply is the one the tool really gives.
{
"sku": "CHAIR-BISTRO-BLACK",
"from": "2026-10-01",
"to": "2026-10-31"
}Use it when
Someone asks where stock went, or when it came in.
What it does
Moves newest first: of one item, at one location, of one kind, in a period.
What comes back
moves: newest first, each with its move_id, date, kind, SKU, quantity, from, to, unit cost, value, quantity after, reference and note; and the total. Every reply also carries cost_usd and balance_usd.
Inputs
| Name | Type | What it is |
|---|---|---|
sku | string | The item's SKU. 1 to 64 characters. |
location | string | A location by name. Default: "Main" (made on first use). Up to 120 characters. |
kind | string | One of: receive,ship,transfer,adjust,count. |
from | string | YYYY-MM-DD. Matches ^\d{4}-\d{2}-\d{2}$. |
to | string | YYYY-MM-DD. Matches ^\d{4}-\d{2}-\d{2}$. |
limit | integer | 1 to 500. Default: 100. |
offset | integer | At least 0. Default: 0. |
The call
Over MCP, call inventory_history on https://api.conecto.chat/mcp/inventory. Over REST:
curl -X POST https://api.conecto.chat/v1/tools/inventory_history \
-H "Authorization: Bearer $CONECTO_KEY" \
-H "Content-Type: application/json" \
-d '{"sku":"CHAIR-BISTRO-BLACK","from":"2026-10-01","to":"2026-10-31"}'When it refuses
A refused call costs nothing and says what to do next.
| Code | When | What to do |
|---|---|---|
not_found404 | No location has that name. | Call inventory_locations, or add it with inventory_save_location. |
archived409 | The item or location is archived. | Use another one, or name a location that is in use. |
not_found404 | No item has that SKU. | Find it with inventory_list_items. |
invalid_input400 | A date is not a date like 2026-10-01. | Fix the date. |
More Inventory tools
All 10 tools- Add or change items
inventory_save_itemsAdds stock items or changes them by SKU: name, unit, barcode, cost, price and reorder point.$0.005 per item saved - List items
inventory_list_itemsItems with their stock in total and per location, the moving-average cost and the value.Free* - Move stock
inventory_moveChanges stock, all moves or none: receive, ship, transfer between locations, or adjust.$0.005 per move - Count a location
inventory_stocktakeRecords a count of one location; each difference from the books becomes a count move.$0.002 per line counted - List locations
inventory_locationsEvery location with how many items it holds and their value.Free* - Add or change a location
inventory_save_locationAdds a location (a warehouse, a shop, a van), or renames, describes or archives one.$0.001 a call - Run an inventory report
inventory_reportValuation (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* - Import items from CSV
inventory_importCreates or changes items from a CSV in the file store, with optional quantities per location; all rows or none.$0.001 per row imported
Give this to your agent.
Set up Conecto from https://conecto.chat/SKILL.md