buy_connect_status

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

{
  "tool": "buy_connect_status",
  "arguments": {
    "merchant": "\u2026",
    "pending_id": "\u2026"
  }
}

MCP

Organization tools

User tools

buy_connect_status

What it does

Inputs

Returns

Example call

​What it does

​Inputs

​Returns

​Example call

What it does

Inputs

Returns

Example call