> ## 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"
  }
}
```


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