Skip to main content
Nine: Walmart (mrc_walmart), Target (mrc_target), Best Buy (mrc_bestbuy), Kroger (mrc_kroger), Instacart (mrc_instacart), Albertsons (mrc_albertsons), Wegmans (mrc_wegmans) and FreshDirect (mrc_freshdirect) in the US, in USD, and Ocado (mrc_ocado) in Great Britain, in GBP. Call list_merchants for the current list. See Merchants.
Yes. With a live key (am_live_), complete_checkout submits a real order to the merchant. Nothing is placed until your agent approves the exact total.
The shopper’s own card. The merchant is the merchant of record and charges the shopper directly. AgentMall adds no markup to the basket. You give us the card in one of two ways:
  • Our vault (Evervault): the shopper enters their card once on our hosted page, and you get a token back.
  • Your vault: you send us a token from your own vault provider.
Either way, the card number never touches your systems or the model. See Security.
$0.50 per completed order. Failed orders are free. Search, cart, and checkout operations are free. Orders placed with a test key (`am_test_`) are free: the full flow runs but nothing is submitted to the merchant. New accounts include $5 of credit, 10 free completed orders at $0.50, from the moment you create your organization. Credit may be added to an account case by case, and it pays order fees before your card is charged.
It depends on the error code:
  • review_changed — the cart changed since approval. Nothing was placed. Read the new checkout and try again.
  • review_mismatch or total_mismatch — the hash or total is stale. Read the checkout again.
  • commit_unknown — the order may have been placed. Do not retry. Call get_order to check the outcome.
See Error Codes for every code.
With account: "platform" on create_cart, AgentMall uses its own signed-in account at the merchant. No sign-in needed.With account: "shopper", you sign in with Evervault-encrypted credentials (ev: ciphertext). If the merchant sends an SMS challenge, sign_in returns challenge_required and you call submit_sign_in_otp with the code.
A SHA-256 fingerprint of the checkout state: items, quantities, totals, address, delivery method, and payment. complete_checkout compares the hash you send with the live checkout. If they differ, it returns review_changed with the new state instead of placing the order.This prevents placing an order on stale data. Always pass the latest review_hash from the checkout response.
Yes. Use a test key (am_test_). The full checkout flow runs — the review is read and checked — but nothing is submitted to the merchant. The order is stored with test: true and no fee is charged.
Use the console at console.getagentmall.com/collect?session=ses_…&kind=card. It opens an Evervault iframe that encrypts the card. The result is an ev: ciphertext string. Plaintext card numbers never touch AgentMall’s servers.
The API Keys page in the console, or your welcome email. The same page shows today’s search usage against your daily cap.
Same operations, same error codes, same data shapes. MCP is for AI agents that speak the Model Context Protocol. REST is for backends that want standard HTTP.Two tools are MCP only: get_product and sign_out. Everything else is available on both surfaces.