buy_set_substitution - Agentcard

Connect to https://mcp.agentcard.sh/mcp with the user’s connection token (or a buy_token for org-owned accounts). Behavior: 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

Set the out-of-stock preference for one item in a placed order. item_msid is the item’s msid from buy_search_products; preference is similar (any similar item), refund, or contact.

Inputs

Field	Type	Description
`merchant` (required)	string
`order_id` (required)	string	the order id from buy_order_history
`item_msid` (required)	string	the item msid from buy_search_products
`preference` (required)	string: `similar` · `refund` · `contact`

Returns

None.

Example call

{
  "tool": "buy_set_substitution",
  "arguments": {
    "merchant": "\u2026",
    "order_id": "\u2026",
    "item_msid": "\u2026",
    "preference": "\u2026"
  }
}