List purchase orders
list_purchase_ordersUse this when the merchant asks what is ordered, drafted, open, partially received, received, cancelled, overdue, expected, or associated with a named supplier. Results are grouped by PO; this tool does not approve, receive, cancel, or otherwise modify an order. Requires a connected Forthcast store; the assistant will prompt to sign in.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "list_purchase_orders"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Maximum grouped purchase orders to return. | |
| status | No | Optional exact purchase-order status. | |
| supplier | No | Optional case-insensitive supplier name filter. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| count | Yes | ||
| orders | Yes | ||
| truncated | Yes | ||
| total_matching | Yes | ||
| applied_filters | No | ||
| purchase_order_url | Yes |