Agent Utilities

Checkout comparison

Compare checkout totals after shipping and discounts

The same item costs $18 at one checkout and $22 at another. With supplied shipping, discounts and tax, their totals become $25.49 and $22.50. These fictional snapshots demonstrate why the lower item price can lose. Confirm that carts meet the same requirements before comparing them.

$0.0010 for the 2 successful calls below; each step is billed separately.

Try the supplied checkout snapshots

These sample inputs and handler-generated results are free to read. For your own carts, save the Python client, comparison recipe and sample input together. Read checksums, budget and recovery instructions.

python3 compare_carts.py

The default command validates and prepares requests offline; it does not compute new totals or contact the service. The recipe accepts 2–10 comparable carts. Add --execute only to authorize paid calls using existing credits, capped by default at $0.001 for two carts. Each completed call remains charged if another fails.

Use hosted MCP

For each sample below, call agent_utilities_prepare with name commerce_price_components and the sample as input. Preparation is free. Save both prepared calls, inspect their prices and obtain spending approval before executing. Reuse each original call after uncertainty; do not prepare a replacement.

Read this complete workflow and its inputs as public JSON · Connect hosted MCP

01

Reconcile lower-item-price

Send this supplied snapshot as one separate call. Inspect total, missingComponents and any declared-total mismatch. Missing shipping, tax or fees must stay null; never replace an unknown cost with zero.

Sample input

{
  "currency": "USD",
  "minorUnitDigits": 2,
  "items": [
    {
      "id": "identical-item",
      "unitPrice": "18.00",
      "quantity": 1,
      "discount": "0.00"
    }
  ],
  "orderDiscount": "0.00",
  "shipping": "5.99",
  "tax": "1.50",
  "fees": "0.00"
}

Sample result

{
  "currency": "USD",
  "minorUnitDigits": 2,
  "lines": [
    {
      "id": "identical-item",
      "subtotal": "18.00",
      "discount": "0.00",
      "total": "18.00"
    }
  ],
  "itemSubtotal": "18.00",
  "lineDiscounts": "0.00",
  "orderDiscount": "0.00",
  "knownTotal": "25.49",
  "total": "25.49",
  "missingComponents": [],
  "matchesDeclaredTotal": null,
  "difference": null,
  "scope": "Exact arithmetic on supplied amounts only. Discounts are absolute amounts; line discount applies once to the whole line. Missing shipping, tax or fees remain unknown. No tax-law calculation, checkout verification or currency-exponent lookup."
}

Generated from the current handler at build time using fictional inputs. Reading this example sends no paid request.

commerce.price-components · $0.0005 per call ↗
02

Reconcile free-shipping

Send this supplied snapshot as one separate call. Inspect total, missingComponents and any declared-total mismatch. Missing shipping, tax or fees must stay null; never replace an unknown cost with zero.

Sample input

{
  "currency": "USD",
  "minorUnitDigits": 2,
  "items": [
    {
      "id": "identical-item",
      "unitPrice": "22.00",
      "quantity": 1,
      "discount": "0.00"
    }
  ],
  "orderDiscount": "1.00",
  "shipping": "0.00",
  "tax": "1.50",
  "fees": "0.00"
}

Sample result

{
  "currency": "USD",
  "minorUnitDigits": 2,
  "lines": [
    {
      "id": "identical-item",
      "subtotal": "22.00",
      "discount": "0.00",
      "total": "22.00"
    }
  ],
  "itemSubtotal": "22.00",
  "lineDiscounts": "0.00",
  "orderDiscount": "1.00",
  "knownTotal": "22.50",
  "total": "22.50",
  "missingComponents": [],
  "matchesDeclaredTotal": null,
  "difference": null,
  "scope": "Exact arithmetic on supplied amounts only. Discounts are absolute amounts; line discount applies once to the whole line. Missing shipping, tax or fees remain unknown. No tax-law calculation, checkout verification or currency-exponent lookup."
}

Generated from the current handler at build time using fictional inputs. Reading this example sends no paid request.

commerce.price-components · $0.0005 per call ↗

What you get

For these complete supplied snapshots, free-shipping has the lower total at $22.50, versus $25.49. Compare exact minor-unit integers in one currency and retain ties. Any incomplete candidate prevents an overall winner, even when other carts have known totals. A declared-total mismatch needs review. These are supplied-data calculations, not live quotes, tax advice, product-equivalence checks or orders. Each successful cart reconciliation is separately billable; preserve every prepared input and request ID before execution and recover uncertain calls without creating new IDs.

These are separate API calls that your agent orchestrates, not an automatic bundled workflow. Review each tool's example and contract; input fields must be mapped explicitly between steps.

A small first step

Pick a useful tool.
Give it a real task.

Try a small pack plan free. For full tools, review the example and price. For Stripe, create an API key and save your recovery key. Start with $1 or $5 in service credits through Stripe, or pay per call in USDC from your Circle Gateway balance.

Open workspace Read the quickstart