Run an inventory report
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*
*Free up to 1,000,000 reads a month for the whole account, then $0.50 per 10,000 reads.
An example
What is our stock worth today?
Your agent callsinventory_reportFree*
The example business is Hansen & Voss, a restaurant-equipment wholesaler in Hamburg with 60 staff. The reply is the one the tool really gives.
{
"report": "valuation"
}Use it when
For the books, insurance, or a reorder list.
What it does
valuation: what was held on as_of (default today) and its value at the moving average. movement: per item what was received, shipped, adjusted and counted from-to (default this month), with the cost of goods shipped, which the bot books if the business keeps books. low_stock: items at or below their reorder point.
What comes back
The report's name and dates and its items: for valuation each item's quantity and value with the total_value; for movement what came in, went out and was counted, with the cost of goods shipped; for low stock the items to reorder. Every reply also carries cost_usd and balance_usd.
Inputs
| Name | Type | What it is |
|---|---|---|
reportRequired | string | One of: valuation,movement,low_stock. |
as_of | string | YYYY-MM-DD. Matches ^\d{4}-\d{2}-\d{2}$. |
from | string | YYYY-MM-DD. Matches ^\d{4}-\d{2}-\d{2}$. |
to | string | YYYY-MM-DD. Matches ^\d{4}-\d{2}-\d{2}$. |
The call
Over MCP, call inventory_report on https://api.conecto.chat/mcp/inventory. Over REST:
curl -X POST https://api.conecto.chat/v1/tools/inventory_report \
-H "Authorization: Bearer $CONECTO_KEY" \
-H "Content-Type: application/json" \
-d '{"report":"valuation"}'When it refuses
A refused call costs nothing and says what to do next.
| Code | When | What to do |
|---|---|---|
invalid_input400 | A date is not valid, or from is after to. | 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 - Stock history
inventory_historyStock moves, newest first, of one item, at one location, of one kind, or in a period.Free* - 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 - 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