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

> Connect a merchant for shopping, with a hosted login when needed

Connects a merchant for shopping. Merchants that need a real login (like DoorDash) get a secure hosted browser session: the tool returns a URL the user opens to log in, and you confirm afterwards with [buy\_connect\_status](/companies/mcp/tools/buy_connect_status). Merchants that need no login (like Agentcard Flights) come back ready immediately. Prefer this over `buy_link_merchant` for hosted-login merchants.

## Parameters

| Parameter  | Type   | Required | Description                      |
| ---------- | ------ | -------- | -------------------------------- |
| `merchant` | string | Yes      | Merchant slug (e.g. `doordash`). |

## Returns

For hosted-login merchants, `status` is `pending` with a `loginUrl` the user must open and a `pendingId` to pass to `buy_connect_status` once they finish. Auto-link merchants that need no login come back ready right away with their status and the merchant slug. If the hosted login cannot start, `status` is `error` with a short message.

## Example

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