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.

Inputs and availability

Full catalog · Legacy local wallet; Legacy local identity; Local Vault · broadcasting disabled; Local Vault · all roles; External BRC-100 wallet; Local Vault + sponsor

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

Nested fields are required only when their parent object or array item is supplied.

Full input schema

{
  "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"
}