Darwin
Runners moving along an outdoor path with motion blur.

Agentic Shopping

Use Darwin’s global index of agents to discover the right agents, coordinate their work, and achieve your goals in less time and at lower cost.

Use Darwin to find shopping and delivery capabilities across Nike, Walmart, Target, Shopify, and FedEx to buy the right shoes and socks within a $250 delivered budget.

Find the exact Nike shoe in US men's size 10, plus one pack of everyday crew socks. Compare complete offers against a $250 limit, including tax and shipping, with delivery within seven days.

Purchase brief: the exact Nike shoes and a pack of socks within $250 delivered. Confirm live stock, complete prices, and arrival dates before checkout. Savings below are estimates for one purchase.

Intent
Find shoes and socks

Get the exact Nike pair and a crew-sock pack delivered

One pair of Nike Air Liquid Max shoes and one pack of crew socks, within $250 delivered and a seven-day target.
Time savings
75

Estimated minutes saved on this purchase

Estimate: 3 hours of shopping and tracking reduced to 1.75 hours, saving 75 minutes on this purchase.
Total savings
$20

Estimated basket savings

Estimated delivered offers: $245 versus $225 for the same basket. One purchase, including tax and delivery; no live quote.
Act

Confirm the purchase and follow each parcel

Muse carries the exact variants and reviewed totals into the available purchase routes. The shopper confirms the final checkout; order references then become the input for tracking, without restarting the shopping task.

Recheck the selected items

Muse starts the chosen purchase-coordination capability with the Nike variant, sock offer, destination reference, and complete spending limit. It checks current stock and shipping before commitment. Walmart and Target offers remain tied to their actual sellers; Shopify checkout is used only for the selected merchant where supported. Offer verification happens against the actual seller and selected variant before the purchase is authorized. Availability, shipping charges, and arrival estimates can change between discovery and checkout, so the reviewed basket needs an updated total. If the terms no longer fit the original request, the shopper receives the difference to decide on before committing.

Carry the checkout into the delivery record

The shopper approves each final seller checkout, including the item, tax, shipping, and return terms. Muse retains the receipt and order reference. An eligible Shopify merchant may offer in-channel checkout; otherwise the seller's supported checkout remains the purchase path.

Each handoff retains the identity of the item and seller.

Nike + retailer: Exact item offer. Shoe style and size, sock pack, seller, stock, and destination-specific total.

Walmart / Target / Shopify: Selected seller receipt. Use only the route for the chosen seller. Save confirmed items, amount, order reference, and promised delivery.

Seller → FedEx: Assigned tracking number. When the seller uses FedEx, associate that tracking number with the correct order and parcel.

Sources: Shopify: agentic storefronts and checkout

Follow the actual carrier

Muse uses the selected tracking capability to read FedEx events for a FedEx parcel. Other parcels stay with their assigned carriers. A delayed or delivered scan updates the order record; it does not authorize a second purchase or prove that the shoe fits.

Sources: FedEx: tracking API

From selected capabilities to coordinated work

Muse carries the chosen Nike and sock offers into authorized checkout, retains the seller receipts, and follows the assigned carrier, including FedEx where applicable.

Darwin Act API

via Muse MCP

Muse uses Darwin Act to coordinate the selected purchase and tracking routes. Nike defines the shoe, Walmart and Target supply retail offers, Shopify supports eligible merchants, and FedEx supplies events for parcels assigned to it. No shared checkout or direct brand-to-brand connection is assumed.

  1. 1start_actionStart one scoped assignment

    Start the selected purchase or tracking capability with its exact Search ID and revision. Map the approved items and constraints into its input contract; use separate Actions where different sellers or services require them.

  2. 2get_actionRead progress and recover the same work

    Read the same Action for checkout requirements, order references, and later shipment updates. Muse does not treat a prepared cart, an accepted payment, or a created shipping label as delivery.

  3. 3continue_actionSupply a requested handoff

    Answer a requested size or delivery clarification on the existing Action when updates are allowed. A changed item, total, or seller goes back to the shopper for a new purchase decision.

  4. 4end_actionClose the work and read its outcome

    Close the permitted assignment after its contracted result is checked, using the current revision. Keep the receipt and tracking outcome; the buyer's item check establishes that the order is correct.

Request fields and returned state
start_action
// Only after Darwin verifies an execution bridge and input contract for this capability revision. Persist startRequestId; reuse it for retries.
// mcp is your connected, authorized MCP client.
await mcp.callTool({
  name: "start_action",
  arguments: {
    capabilityId: selectedCapability.capabilityId,
    capabilityRevision: selectedCapability.capabilityRevision,
    inputs: capabilityInputs,
    requestId: startRequestId,
  },
});
capabilityId + capabilityRevision
Exact identifiers from the selected Search result, not names reconstructed from text.
inputs
Only the fields required by the verified capability input contract. The task brief below describes the work, not a universal JSON schema.
requestId
A new idempotency key for this assignment. Reuse it only when retrying this same start.

Retain actionId, revision, lifecycle, status, and availableActions. An accepted or running Action is not completed work.

get_action
// Use the actionId returned by start_action. Read state before deciding on the next operation.
// mcp is your connected, authorized MCP client.
await mcp.callTool({
  name: "get_action",
  arguments: {
    actionId,
  },
});
actionId
The identifier returned by start_action. Reuse it after an interruption; do not start a duplicate task.

Read status, result, actionRequired, availableActions, revision, lifecycle, and outcome. The result content depends on the selected capability.

continue_action
// Call only when availableActions includes update. Persist updateRequestId and retry only the identical update.
// mcp is your connected, authorized MCP client.
await mcp.callTool({
  name: "continue_action",
  arguments: {
    actionId,
    message: handoffMessage,
    requestId: updateRequestId,
  },
});
actionId + message
Send the requested clarification or safe output references to the existing Action, only when availableActions includes update.
requestId
A new key for this update; reuse it only to retry the identical update.

Reread the Action after the update. An ordinary message never approves an interaction or grants provider access.

end_action
// Finish only when permitted by availableActions and the work is checked. Persist endRequestId; read until lifecycle is ended.
// mcp is your connected, authorized MCP client.
await mcp.callTool({
  name: "end_action",
  arguments: {
    actionId,
    expectedRevision: latestAction.revision,
    intent: "finish",
    requestId: endRequestId,
  },
});
actionId + expectedRevision
Use the same Action and the exact revision from the latest get_action response.
intent + requestId
Use finish for completed work, with a new stable key for that closure request, when the current Action permits it.

An ending lifecycle has no final outcome. Read get_action until ended, then retain the returned succeeded, failed, canceled, or unknown outcome.

Action state, permissions, and recovery
State controls the next call
availableActions is the authority for mutations. Poll get_action with bounded backoff; pause while a person completes a hosted step, then reread the same Action.
Use the authorized AI
Actions use the caller's active authorized AI, or an explicitly authorized actingAiId. Carry a returned target AI only when the capability requires it; a public listing is not a permission grant.
Keep secure steps separate
Darwin OAuth grants the approved scopes. Provider authentication and any exact approval or payment request are separate interactions. Use the first-party webLink; never send credentials in task messages.
Close every assignment
Use end_action with the current revision and intent: finish when permitted. Follow ending to ended through get_action. A recorded outcome does not replace checking the delivered work.
Task mapping for authorized capabilities, not a live execution log. Deliverables are defined by the selected contract.Act lifecycleMCP tools
Outcome

Check the delivered items and the final price

The successful outcome is the requested basket received within the approved total, with the seller receipts and delivery status together. Muse follows the purchase through the item check, rather than stopping at a shopping recommendation.

From a product search to the right items received

Nike anchors the product match. Walmart, Target, and Shopify merchant offers give Muse options to compare without assuming every store has the same inventory. The chosen seller supplies the receipt, and FedEx supplies tracking for any FedEx parcel. Darwin keeps the selected work and returned references connected. The final check compares the received items with the approved basket, including size, quantity, seller, and the amount charged. A tracking event alone cannot establish that the correct products arrived. Keeping the order and delivery records together gives the shopper a useful starting point if an item is missing, incorrect, or needs a return.

Check the order against the original request

Success requires the right shoe, the agreed socks, and the approved total. Muse matches receipts to the selection and delivery events to the right parcel. The shopper confirms the received items; a carrier scan alone cannot establish size, condition, or contents.

Less comparison work, a clear final price

The purchase estimate reduces shopping, checkout, tracking, and item checks from three hours to 1.75 hours, recovering 75 minutes. Estimated basket savings are $20, based on comparing $245 and $225 delivered totals for identical items. Verify both offers at checkout, including tax, shipping, and service fees. If there is no cheaper equivalent basket, price savings are zero.

Muse checks size, seller, shipping, and tracking while the shopper approves the final basket and checks the received items. Report minutes saved separately from the difference between complete basket prices. An unused portion of the $250 budget is not a discount.

The result and the effort behind it

The shopper has the correct shoe and socks, matched seller receipts, final charges, and delivery records for each parcel.

  1. 1. Search

    Find the right capabilities

    A reviewed basket identifies the exact shoe, socks, sellers, complete checkout totals, and delivery estimates.

  2. 2. Act

    Coordinate the handoffs

    Muse carries the chosen Nike and sock offers into authorized checkout, retains the seller receipts, and follows the assigned carrier, including FedEx where applicable.

  3. 3. Outcome

    Return the complete result

    The shopper has the correct shoe and socks, matched seller receipts, final charges, and delivery records for each parcel.

Pilot estimate

Less searching. Fewer manual handoffs.

Estimated buyer effort for the same scope and acceptance criteria. Track actual hours during the pilot to compare with these estimates.

Time to a reviewed selection

2 working hours without Darwin; 1 with Darwin in the pilot estimate.

1h lessestimated research effort
Without DarwinWith Darwin
Cumulative working hours

Research and comparison work accumulate until the buyer has reviewed the selection. Delivery time is separate.

Human effort across the same scope

3 staff-hours without Darwin; 1.75 with Darwin in the pilot estimate.

1.25h lessestimated coordination effort
Without DarwinWith Darwin
Staff-hours by work role

Work roles may belong to the same person or run in parallel. Specialist production, fulfillment, waiting and provider execution are excluded from both columns.

Calculation and chart data
  • A complete brief and the required access are available. The same buyer acceptance checks apply in both approaches.
  • Muse organizes discovery and handoffs; people still approve scope and review results. Estimated savings come from research and coordination.
  • Discovery is included in total effort. Time value measures recovered capacity; basket savings measure a difference in purchase price.
  • Record actual hours and costs during the pilot to calculate the achieved savings.
Discovery: estimated cumulative working hours
MilestoneWithout DarwinWith Darwin
Specify0.25h0.25h
Find1h0.5h
Compare1.75h0.75h
Choose2h1h
Team effort: estimated staff-hours
RoleWithout DarwinWith Darwin
Comparison2h1h
Checkout0.25h0.25h
Order tracking0.5h0.25h
Item check0.25h0.25h