buy_connect

Connect to https://mcp.agentcard.sh/mcp with the user’s connection token (or a buy_token for org-owned accounts).

What it does

Connect a merchant for shopping. For merchants that need a real login (e.g. DoorDash) this opens a secure hosted browser session and returns a URL the user opens to log in; after they finish, call buy_connect_status with the pending_id to confirm. Merchants that need no login (e.g. Agentcard Flights) come back ready immediately. Use this instead of buy_link_merchant for hosted-login merchants. This tool pairs only with buy_connect_status and only tracks logins it started itself; a login link handed out by the conversational buy tool has no pending_id and is verified inside that same buy conversation (the user replies there, e.g. “done — I logged in”).

Inputs

Field	Type	Description
`merchant` (required)	string	merchant slug (e.g. doordash)

Returns

Field	Type	Description
`message` (required)	string	Human-readable next step.
`status`	string	Outcome: ‘pending’ (hosted login started), ‘ready’/‘linked’ (auto-link merchant — no login needed), or ‘error’.
`loginUrl`	string	URL the user must open to log in to the merchant. Absent for auto-link merchants.
`pendingId`	string	Session id to pass to buy_connect_status. Absent for auto-link merchants.
`merchant`	string	The merchant slug, present when an auto-link merchant needs no login.

Example call

{
  "tool": "buy_connect",
  "arguments": {
    "merchant": "\u2026"
  }
}

MCP

Organization tools

User tools

What it does

Inputs

Returns

Example call

​What it does

​Inputs

​Returns

​Example call

What it does

Inputs

Returns

Example call