# wallet_listOrdinal

List an ordinal for sale on the marketplace

## Result

An MCP result containing the operation outcome as text, with structured content where supplied. Check isError before using it; an output schema is shown when registered.

## Permissions

This operation can change wallet, account or service state. A connected wallet applies its own permissions. Guarded broadcasts also require broadcasting to be enabled; service authorization is separate from wallet approval.

## Definition 1 (full)

Registered in: Legacy local wallet; Legacy local identity; Local Vault · broadcasting disabled; Local Vault · all roles; External BRC-100 wallet; Local Vault + sponsor.

List an ordinal for sale on the marketplace

| Field | Type | Required | Description | Constraints |
| --- | --- | --- | --- | --- |
| id | string | Yes | Tracking id of the ordinal in the ordinals basket (the 'id:' tag from wallet_getOrdinals) |  |
| price | integer | Yes | Price in satoshis; whole satoshis above zero | maximum: 9007199254740991; exclusiveMinimum: 0 |
| payAddress | string | No | Address to receive payment on purchase. Defaults to the wallet's P1SAT '1sat 0' address. |  |

Nested requirements apply when their parent is supplied.

### Input schema

```json
{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "Tracking id of the ordinal in the ordinals basket (the 'id:' tag from wallet_getOrdinals)"
    },
    "price": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991,
      "description": "Price in satoshis; whole satoshis above zero"
    },
    "payAddress": {
      "description": "Address to receive payment on purchase. Defaults to the wallet's P1SAT '1sat 0' address.",
      "type": "string"
    }
  },
  "required": [
    "id",
    "price"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
```

[All tools](https://bsvmcp.com/docs/tools)