buy_return_status - Agentcard

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.

Not in the default tools/list. It is still callable by exact name, and appears when the client sends the x-expert-tools: 1 header.

What it does

Status + return-label URLs for a return started with buy_return_order (by its return_id). Statuses: open (being processed), approved (labels issued — relay them), denied (see resolution notes), credited (refund issued).

Inputs

Field	Type	Description
`merchant` (required)	string
`return_id` (required)	string	the return_id from buy_return_order

Returns

None.

Example call

{
  "tool": "buy_return_status",
  "arguments": {
    "merchant": "\u2026",
    "return_id": "\u2026"
  }
}