Whole-Pack Planner · HTTP + MCP
The cheaper unit price can cost you more.
Choose the lowest-cost whole-pack combination for the quantity you need.
No account, API key, card or wallet. No automatic paid fallback.
A concrete example
Need 12 identical items? A six-pack costs $7.99; a ten-pack costs $11.99. Two six-packs cost $15.98, while two ten-packs cost $23.98.
Synthetic demonstration, generated with the real handler during the build. Not a live price, customer task or testimonial.
1. Supply your input
Up to 3 offers, 1000 required units, 1000 units per pack, 50 packs per offer and 4096 UTF-8 input bytes.
Your input is sent to Agent Utilities when you run the check. Data policy.
2. Inspect the result
Build-time example output. Run to check your input.
{
"mode": "free-preview",
"executionPerformed": true,
"chargedMicroUsd": "0",
"result": {
"currency": "USD",
"minorUnitDigits": 2,
"requiredUnits": 12,
"feasible": true,
"totalUnits": 12,
"excessUnits": 0,
"itemSubtotal": "15.98",
"packCount": 2,
"lines": [
{
"id": "six-pack",
"packs": 2,
"units": 12,
"lineSubtotal": "15.98"
}
],
"scope": "Minimum item subtotal within supplied pack limits; ties prefer fewer excess units, then fewer packs. Offers must be interchangeable units of the same product and currency. No stock verification, shipping, tax, fees, discounts, product-equivalence checks or order placement. Infeasible means supplied limits cannot meet the requested quantity."
},
"limits": {
"maxOffers": 3,
"maxRequiredUnits": 1000,
"maxUnitsPerPack": 1000,
"maxPacksPerOffer": 50,
"maxInputBytes": 4096
},
"scope": "Custom supplied input, computed without payment. Same item-subtotal calculation as commerce.pack-plan within smaller limits. No live inventory, product-equivalence verification, shipping, tax, fees or order placement. No paid fallback."
}Give this request to your agent
HTTP needs no installation or credential. The request below always uses the bounded free endpoint.
curl --fail-with-body 'https://agent-utilities.agent-utilities.workers.dev/v1/preview/commerce.pack-plan' \
-H 'Content-Type: application/json' \
--data-binary @- <<'JSON'
{
"currency": "USD",
"minorUnitDigits": 2,
"requiredUnits": 12,
"offers": [
{
"id": "six-pack",
"unitsPerPack": 6,
"price": "7.99",
"maxPacks": 10
},
{
"id": "ten-pack",
"unitsPerPack": 10,
"price": "11.99",
"maxPacks": 10
}
]
}
JSONHosted MCP
Connect https://agent-utilities.agent-utilities.workers.dev/mcp/remote?category=commerce in your MCP client, then call agent_utilities_pack_preview with the editable input above.
{
"name": "agent_utilities_pack_preview",
"arguments": {
"currency": "USD",
"minorUnitDigits": 2,
"requiredUnits": 12,
"offers": [
{
"id": "six-pack",
"unitsPerPack": 6,
"price": "7.99",
"maxPacks": 10
},
{
"id": "ten-pack",
"unitsPerPack": 10,
"price": "11.99",
"maxPacks": 10
}
]
}
}Claude, Qwen and other client setup · Full trial contract, schema and limits
What the result means
Supply interchangeable items, exact prices and explicit pack limits in one currency. Item subtotal only: excludes delivery, taxes, fees and discounts. No live stock check, product-equivalence check or order placement.
An infeasible result means no combination satisfies the supplied limits. Inspect the status and quantities before acting.
Did this solve your task?
Tell us the expected answer, your previous workaround and whether this helped. Use public or sanitized data only. If you use it again for another real task, tell us separately.
Share feedback by emailNo purchase needed to give feedback.
When the free limit is too small
Full Whole-Pack Planner calls cost $0.0008 each. Service credits start at $1. Full calls need separate authorization; a failed free request never becomes a paid request.
Credit workspace ↗