> ## Documentation Index
> Fetch the complete documentation index at: https://docs.agentcard.sh/llms.txt
> Use this file to discover all available pages before exploring further.

# buy_list_merchants

> List merchants available for agent commerce (Rappi, Good Eggs, DoorDash) and whether this user has linked each one.

Connect to `https://mcp.agentcard.sh/mcp` with the **user's connection token** (or a `buy_token` for org-owned accounts).

**Behavior:** read-only, idempotent.

## What it does

List merchants available for agent commerce (Rappi, Good Eggs, DoorDash) and whether this user has linked each one. Link a merchant before shopping it.

## Inputs

None.

## Returns

| Field | Type | Description |
| - | - | - |
| `message` *(required)* | string | Human-readable merchant list (or an error / empty note). |
| `status` | string | Outcome: 'ok', 'empty', or 'error'. |
| `count` | number | Number of merchants returned. |
| `merchants` | array | Available commerce merchants and this user's link status for each. |

## Example call

```json theme={null}
{
  "tool": "buy_list_merchants",
  "arguments": {}
}
```


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