OrderLoop bronze

Ask the assistant

Ask in plain language. The assistant answers from the same tools; an action it proposes waits (input-required) until you reply { "confirm": true }. Needs the viewer role.

• What needs attention?
• Which orders over $10k are waiting for approval?

Place an order

Start an order on a published flow ({ flowId, version?, input, vars? }, as POST /api/v1/orders). The task follows the order: working while it runs, input-required when it waits for an approval or event, then its outcome. Repeating a message id returns the same order. Needs the operator role.

• { "skill": "place_order", "input": { "flowId": "flow_b2b", "input": { … } } }

Needs attention

What is waiting on people: open approvals (oldest first), orders that failed or rolled back in the last 3 days, and orders waiting on a business event for over a day. Needs the viewer role.

• { "skill": "needs_attention", "input": { … } }

Find orders

Search orders. Totals compare in USD. Returns the count and total of all matches plus up to `limit` rows. Needs the viewer role.

• { "skill": "find_orders", "input": { … } }

Get an order

One order: status, what it waits on (with where each decision leads), steps run so far and recent activity. Needs the viewer role.

• { "skill": "get_order", "input": { … } }

Assess an order

Ask typed questions about one order and get a probability for every option: noul (yes/no, the probability of yes), choice (pick one of 2–255 options) or score (an ordered rubric of 2–10 levels, lowest first). Optionally pass up to 4 images (the order’s R2 document keys, https or data URLs; PNG, JPEG or WebP). Needs the viewer role.

• { "skill": "assess_order", "input": { … } }

Find products

Products with stock, reserved and available quantities and reorder points. Needs the viewer role.

• { "skill": "find_products", "input": { … } }

List carts

Carts people are building before they become orders, most recently changed first: title, status, customer and, once submitted, its order. Needs the viewer role.

• { "skill": "list_carts", "input": { … } }

Get a cart

One cart: its lines (with each line’s id) at the prices its flow quoted, promo codes, problems the quote found, and why it can’t be submitted yet. Needs the viewer role.

• { "skill": "get_cart", "input": { … } }

List flows

All flows and their published versions. Needs the viewer role.

• { "skill": "list_flows", "input": { … } }

Get a flow

A flow’s saved draft: its steps, connections and validation problems. Needs the viewer role.

• { "skill": "get_flow", "input": { … } }

Propose a flow change

Draft a change to a flow from an instruction. Nothing is saved: a person reviews the proposal in the flow editor and applies it there. Needs the operator role.

• { "skill": "propose_flow_change", "input": { … } }

Draft a business-rule plugin

Draft a plugin of business-rule flow steps from an instruction (e.g. “hold orders over $5,000 shipping outside the US”), with test cases. Nothing runs: an admin reviews it on the Plugins page, runs its cases and approves it there. Give pluginId to revise a drafted plugin. Needs the admin role.

• { "skill": "draft_plugin", "input": { … } }

Draft product content

Draft a catalog product’s missing text (titles, descriptions, text attributes and image alt text, locale by locale) from what it says in its other locales. Name fields and locales to draft those instead. The drafts are saved on the product; nothing goes live until a person accepts and publishes them. Needs the operator role.

• { "skill": "draft_product_content", "input": { … } }

Open a cart

Open a cart priced by a published flow that prices orders, for a customer if given. Nothing is ordered until the cart is submitted. Needs the operator role.

• { "skill": "create_cart", "input": { … } }

Change a cart

Change an open cart, op by op in order: add a SKU, set a line’s quantity (0 removes it), set several lines’ quantities in one change (set_qtys, all or none), remove lines, clear it, add or remove a promo code, set or clear the ship-to address, choose a shipping option from the quote, lock, unlock or rename it. The cart’s flow prices it again; nothing is ordered. Needs the operator role.

• { "skill": "change_cart", "input": { … } }

Decide an approval

Approve or reject an approval an order is waiting on. Needs the approver role.

• { "skill": "decide_approval", "input": { … } }

Decide several approvals

Approve or reject up to 25 open approvals at once, with one note for all. Each is checked and decided on its own; one that can’t be decided is skipped and says why. Needs the approver role.

• { "skill": "decide_approvals", "input": { … } }

Deliver an event

Deliver a business event (e.g. payment.received) to the order waiting for it. Needs the operator role.

• { "skill": "deliver_event", "input": { … } }

Cancel an order

Cancel an order and undo what it did (release stock, void payment, cancel shipments). Needs the operator role.

• { "skill": "cancel_order", "input": { … } }

Submit a cart

Submit a priced cart as an order of its flow, with its lines, customer and promo codes. The order is priced again by its flow when it runs, as any order is. The cart ends. Needs the operator role.

• { "skill": "submit_cart", "input": { … } }

Publish a flow

Publish a flow’s saved draft as a new version. Needs the operator role.

• { "skill": "publish_flow", "input": { … } }

Run the stock review

Run the daily stock review now; it starts reorders for SKUs at or below their reorder point. Needs the operator role.

• { "skill": "run_stock_review", "input": { … } }

Start an order

Start a new order on a published flow: its lines (SKU and quantity), and optionally a customer or a guest contact, fulfilment (pickup and carry-out need a store), currency, title and document text for the flow to read. It runs the flow for real. Needs the operator role.

• { "skill": "start_order", "input": { … } }

Restart an order

Start a fresh order like an existing one: same customer, lines and fulfilment, on its flow’s current version. The old order stays as it is. Needs the operator role.

• { "skill": "restart_order", "input": { … } }

Cancel a cart

Cancel an open or locked cart. Nothing is ordered, and the cart ends. Needs the operator role.

• { "skill": "cancel_cart", "input": { … } }

Create a flow

Create a new, unpublished flow for a commerce model: from its template, a blank start, or drafted from a description of the steps. Nothing runs until it is published. Needs the operator role.

• { "skill": "create_flow", "input": { … } }

Duplicate a flow

Copy a flow’s current draft as a new, unpublished flow. Needs the operator role.

• { "skill": "duplicate_flow", "input": { … } }

Archive or restore a flow

Archive (or restore) a draft that was never published, so it leaves the flows list. Published flows can’t be archived. Needs the operator role.

• { "skill": "archive_flow", "input": { … } }

Test a flow

Run a test order on a flow: publishes its saved draft first when it changed since the live version, then starts an order with a demo input where the demo data is loaded. Needs the operator role.

• { "skill": "test_flow", "input": { … } }

Publish catalog edits

Publish the staged edits of up to 500 products to the live catalog, each product all or none. Needs the operator role.

• { "skill": "publish_catalog", "input": { … } }

Turn a plugin on or off

Turn an installed plugin on or off. Off, flows that use it can’t be published and their running steps fail. Needs the admin role.

• { "skill": "set_plugin_enabled", "input": { … } }

Approve a plugin version

Approve an uploaded or drafted plugin version so it runs. Needs a step-up; a plugin that asks for buyers’ details needs them granted. Needs the admin role.

• { "skill": "approve_plugin", "input": { … } }

Roll a plugin back

Run an earlier version of an installed plugin again. Needs a step-up. Needs the admin role.

• { "skill": "rollback_plugin", "input": { … } }

Uninstall a plugin

Uninstall a plugin installed at runtime. Needs a step-up. Needs the admin role.

• { "skill": "uninstall_plugin", "input": { … } }

urn:air:orderloop.app:mcp:orderloop