Skip to main content
MCPDocs

Checkout is prepare then place

Checkout is two tools: prepare_checkout returns the review (review_hash, total), then checkout places with that hash and total_minor. place_order is gone.
  • create_session accepts account: "platform" (signed-in seeded context; shared cart cleared on create) or guest (default).
  • Cart: ensure_cart clears then adds; set_cart_item_quantity sets one line. get_product returns the same catalog fields as a search hit.
  • REST: POST /v1/sessions/:id/prepare_checkout, POST /v1/sessions/:id/checkout, POST /v1/sessions/:id/cart/ensure.
Docs

Docs expanded for the partner beta

New pages: Quickstart, Auth and keys, Errors, Console. Overview and concept pages match live MCP/REST (no phantom tools). REST docs cover session/sign-in routes and /v1/console/*.
MCP

Search source flag + URL-only add_to_cart

search defaults to the Channel3 catalog. Pass source: "merchant" with a session_id for live Walmart search when catalog results are empty or poor. add_to_cart requires the item url from search (no Channel3 id lookup). The old no_grocery coverage gate is gone.
Docs

Docs audit: tools reference matches live MCP server

The MCP tools reference now lists only the 19 tools registered on the live apps/api MCP server. Stale tool names from the previous Worker-based server (get_cart, update_cart, create_checkout, complete_checkout, etc.) have been removed, and missing tools (end_session, submit_sign_in_otp, read_cart, add_to_cart, update_cart_item, remove_cart_item, clear_cart, list_addresses, write_address) have been added.
  • Cart errors in Connect your agent now document the real error shape (code + message) and list all cart error codes.
  • Concept pages updated to reference place_order instead of the old create_checkout / complete_checkout flow.
API

REST API at api.getagentmall.com

Beta partners can call the Session model over HTTPS at https://api.getagentmall.com (Bearer partner key on /v1/*):
  • POST /v1/sessions, search, cart, and two-call place-order (prepare → human confirmation → commit)
  • Same operator-backed Walmart path as MCP; GET /health is open
See REST API. MCP remains at https://mcp.getagentmall.com.
MCP

Real cards through Basis Theory

write_payment_method saves a card via Basis Theory (vault_ref or raw card fields). Prefer vault refs so PANs never sit in tool logs. See Vault and credentials.
  • payment_method_id values start with pmt_.
  • Guest sessions have no saved merchant cards — pass card / vault_ref to place_order.
  • place_order checks the card before checkout opens: payment_reference_not_found, payment_method_expired.
MCP

Removed 7 tools with no merchant backing

Seven MCP tools that had no working Walmart MerchantOps behind them have been removed from the server. They returned mock data but could not drive real purchases.
  • create_refund, get_refund: refunds are issued by Walmart after a return or cancellation, not by the agent.
  • modify_order: Walmart does not support order modification. Cancel and reorder instead.
  • get_return: no read path for return status in the merchant contract. create_return stays.
  • cancel_checkout: Walmart checkout is page state. Use cancel_cart to abandon a basket.
  • search_locations, lookup_locations: store lookup only works inside checkout via the merchant’s pickup flow.
Tool count is now 36. revoke_payment_reference stays — it operates in AgentMall’s vault, not at the merchant.
MCP

Test keys for beta partners

Beta partners now get their own test key. Send it as an Authorization: Bearer <key> header, or add ?key=<key> to the server URL if your client only takes a URL.
  • A key has its own daily search allowance, separate from keyless test mode. When it runs out, search returns daily_limit_reached with used_today and daily_cap. Ask us if you need it raised.
  • An unrecognised key returns invalid_key. Check the key, or remove it to use keyless test mode.
Docs

Concept guides and MCP tools reference

Six concept pages explain how AgentMall works:
  • Sessions: how a shopping run is recorded, from first search to order.
  • Order flow: the tool calls from search to order, and every order state.
  • Route planning: where and how an order will be placed, shown before approval.
  • Mandates and approval: how a shopper’s approval is tied to one basket and one maximum total.
  • Vault and credentials: how payment details stay out of your agent’s context.
  • Evidence: the record of what the agent did and what happened to the order.
The MCP tools reference lists all 36 tools with their inputs, and marks which ones work in keyless test mode.
MCP

Test mode: connect with no key

AgentMall’s MCP server is live in test mode. Add it to Claude Code, Cursor, VS Code or any client that supports streamable HTTP, with no account, key or card.
  • search returns up to 10 real Walmart products, with price and stock.
  • get_product returns one of them.
  • Every other tool is listed, so your agent can see the full API. They return needs_test_key.
  • Test mode allows 5 searches a minute and 10 a day for each address.
To set it up, see Connect your agent.
Docs

Docs site

The AgentMall docs are live, with search and light and dark mode.