> ## 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_request_merchant

> Log a feature request when the user asks to shop at a merchant/provider Agentcard does NOT support (anything not in buy_list_merchants — e.g.

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

**Behavior:** idempotent.

<Note>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.</Note>

## What it does

Log a feature request when the user asks to shop at a merchant/provider Agentcard does NOT support (anything not in buy\_list\_merchants — e.g. Instacart, Uber Eats, Amazon). Call it once per merchant the user asks for, then tell the user plainly that the merchant isn't supported yet and that their request has been passed to the team. Do NOT promise a timeline.

## Inputs

| Field                   | Type   | Description                                                                   |
| ----------------------- | ------ | ----------------------------------------------------------------------------- |
| `merchant` *(required)* | string | The merchant/provider the user asked for, as they said it (e.g. 'Instacart'). |
| `details`               | string | Optional: what they wanted to buy or do there, in one short sentence.         |

## Returns

| Field                  | Type   | Description                                     |
| ---------------------- | ------ | ----------------------------------------------- |
| `message` *(required)* | string | Human-readable confirmation (or an error note). |
| `status`               | string | Outcome: 'logged' or 'error'.                   |
| `merchant`             | string | The merchant the request was logged for.        |

## Example call

```json theme={null}
{
  "tool": "buy_request_merchant",
  "arguments": {
    "merchant": "\u2026"
  }
}
```