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

> Check the status of a hosted merchant login started with buy_connect.

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

Check the status of a hosted merchant login started with buy\_connect. Returns linking (still in progress — call again in a few seconds), linked (success — the merchant is ready to shop), expired, or error. Pass the merchant and the pending\_id from buy\_connect. ONLY for logins started by the buy\_connect tool: a login link handed out by the conversational `buy` tool has no pending\_id — for those, reply to the same `buy` conversation ("done — I logged in") instead of calling this.

## Inputs

| Field                     | Type   | Description                               |
| ------------------------- | ------ | ----------------------------------------- |
| `merchant` *(required)*   | string | merchant slug (e.g. doordash)             |
| `pending_id` *(required)* | string | The pending\_id returned by buy\_connect. |

## Returns

| Field                  | Type    | Description                                                                                                                                                  |
| ---------------------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `message` *(required)* | string  | Human-readable status / next step.                                                                                                                           |
| `status`               | string  | Connect state: 'linking', 'linked', 'expired', or 'error'.                                                                                                   |
| `merchant`             | string  | The merchant slug, present when linked.                                                                                                                      |
| `cart_carried_over`    | boolean | True when a cart built anonymously before linking was moved onto the linked account — re-show it (buy\_view\_cart) and re-confirm the total before checkout. |

## Example call

```json theme={null}
{
  "tool": "buy_connect_status",
  "arguments": {
    "merchant": "\u2026",
    "pending_id": "\u2026"
  }
}
```