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

> List delivery addresses saved on a linked merchant account

Lists the delivery addresses saved on a linked merchant account. Use it to find an address id for `buy_set_default_address`.

<Note>Not advertised in `tools/list` by default — the [buy](/companies/mcp/tools/buy) tool covers this conversationally. Expert integrations can still call it by name.</Note>

## Parameters

| Parameter  | Type   | Required | Description                            |
| ---------- | ------ | -------- | -------------------------------------- |
| `merchant` | string | Yes      | Merchant slug (for example `doordash`) |

## Returns

One line per saved address with its label or street, the full printable address when available, and its id. If the account has none you get "No saved addresses." Failures return a short error message.

## Example

```json theme={null}
{ "name": "buy_addresses", "arguments": { "merchant": "doordash" } }
```