> ## 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.

# Merchants

> Supported merchants and how AgentMall connects to their sites.

![Merchant storefronts connected to the AgentMall hub](https://mintcdn.com/agentmall/ZuoglRqW4CDsIaRs/images/merchants.svg?fit=max\&auto=format\&n=ZuoglRqW4CDsIaRs\&q=85\&s=1379e73cc6d7302a2874da0b8230efac)

AgentMall connects to merchant websites through browser automation. Each merchant has a driver that handles its site.

## Supported merchants

| Merchant ID | Name | Domain | Country |
| - | - | - | - |
| `mrc_walmart` | Walmart | walmart.com | US |
| `mrc_target` | Target | target.com | US |
| `mrc_bestbuy` | Best Buy | bestbuy.com | US |
| `mrc_kroger` | Kroger | kroger.com | US |
| `mrc_instacart` | Instacart | instacart.com | US |
| `mrc_albertsons` | Albertsons | albertsons.com | US |
| `mrc_wegmans` | Wegmans | wegmans.com | US |
| `mrc_freshdirect` | FreshDirect | freshdirect.com | US |
| `mrc_ocado` | Ocado | ocado.com | GB |

## Availability

All nine merchants are live. Each one supports the full flow through the same API: search, product pages, cart, sign-in with OTP, checkout with the fulfillment methods that merchant offers, and order reading. Call `list_merchants` to get the current list. To switch store, pass a different `merchant_id`; nothing else in your integration changes.

## Currency

Prices and totals are in the merchant's currency, as integer minor units. The eight US merchants return `currency: "USD"` and amounts in cents (`1697` is \$16.97). Ocado (`mrc_ocado`) is in Great Britain: it returns `currency: "GBP"` and amounts in pence (`1697` is £16.97). Read `currency` on every product, cart, checkout, and order rather than assuming USD.

## Merchant IDs

Every merchant has an id prefixed `mrc_`. Pass it on `create_cart`, `search_catalog`, `get_product`, and `lookup_catalog`. The id is on every response that touches a merchant.

## What a driver handles

Each driver automates one merchant's website:

* **Search**: reads the merchant's search results page
* **Product pages**: reads pricing, availability, reviews, and variants
* **Cart**: adds items, reads the cart, clears items
* **Sign-in**: authenticates with encrypted credentials, handles OTP challenges
* **Checkout**: fills address, selects fulfillment, adds payment, reads the review, commits the order
* **Orders**: reads order status and confirmation from the merchant's order history

The API is the same across merchants. Differences in how each merchant's site works are handled inside the driver. Your agent sees one consistent interface.

## Capabilities per merchant

Every merchant supports search, product pages, cart, sign-in, checkout, and order reading. Fulfillment options differ because the stores themselves differ: some ship, some deliver, some offer pickup, and some have no pickup at all. A merchant without pickup returns no pickup options in `fulfillment.methods`. Read `fulfillment.methods` from `create_checkout` and offer only what is there.

When a capability is unavailable, the API returns a clear error rather than silently failing.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.