> ## Documentation Index > Fetch the complete documentation index at: https://agentmall.mintlify.site/llms.txt > Use this file to discover all available pages before exploring further. # Changelog > What's new in AgentMall for developers. **November 4, 2026** ## 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`. **November 3, 2026** ## Docs expanded for the partner beta New pages: [Quickstart](https://agentmall.mintlify.site/quickstart.md), [Auth and keys](https://agentmall.mintlify.site/auth-and-keys.md), [Errors](https://agentmall.mintlify.site/errors), [Console](https://agentmall.mintlify.site/console.md). Overview and concept pages match live MCP/REST (no phantom tools). REST docs cover session/sign-in routes and `/v1/console/*`. **November 3, 2026** ## 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. **November 3, 2026** ## Docs audit: tools reference matches live MCP server The [MCP tools reference](https://agentmall.mintlify.site/mcp/tools.md) 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](https://agentmall.mintlify.site/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. **November 2, 2026** ## 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](https://agentmall.mintlify.site/api/rest.md). MCP remains at `https://mcp.getagentmall.com`. **November 2, 2026** ## 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](https://agentmall.mintlify.site/concepts/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`. **November 2, 2026** ## 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. **November 2, 2026** ## Test keys for beta partners Beta partners now get their own test key. Send it as an `Authorization: Bearer ` header, or add `?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. **October 30, 2026** ## Concept guides and MCP tools reference Six concept pages explain how AgentMall works: * [Sessions](https://agentmall.mintlify.site/concepts/sessions): how a shopping run is recorded, from first search to order. * [Order flow](https://agentmall.mintlify.site/concepts/order-flow): the tool calls from search to order, and every order state. * [Route planning](https://agentmall.mintlify.site/concepts/route-planning): where and how an order will be placed, shown before approval. * [Mandates and approval](https://agentmall.mintlify.site/concepts/mandates-and-approval): how a shopper's approval is tied to one basket and one maximum total. * [Vault and credentials](https://agentmall.mintlify.site/concepts/vault-and-credentials): how payment details stay out of your agent's context. * [Evidence](https://agentmall.mintlify.site/concepts/evidence): the record of what the agent did and what happened to the order. The [MCP tools reference](https://agentmall.mintlify.site/mcp/tools.md) lists all 36 tools with their inputs, and marks which ones work in keyless test mode. **October 30, 2026** ## 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](https://agentmall.mintlify.site/connect-your-agent). **October 27, 2026** ## Docs site The AgentMall docs are live, with search and light and dark mode. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.