← BSV MCPInstall
Wallet

wallet_getOrdinals

List ordinals/inscriptions in the wallet with metadata. Each result carries an 'id:' tag; that tracking id is the handle the transfer, listing and cancel tools take.

Read as Markdown

Result

The ordinals listing result as JSON text.

Permissions

Requires the configured wallet or identity context. Wallet read permissions apply; this handler does not request a payment.

Also available through wallet_read in compact mode.

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

FieldType / requiredDescription
limitinteger
Optional
Max number of results to return

minimum: -9007199254740991; maximum: 9007199254740991

offsetinteger
Optional
Number of results to skip

minimum: -9007199254740991; maximum: 9007199254740991

tagsarray of string
Optional
Filter by output tags (e.g. 'type:image/png')
tagQueryMode"all" | "any"
Optional
Whether results must match all tags or any tag

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

Full input schema
{
  "type": "object",
  "properties": {
    "limit": {
      "description": "Max number of results to return",
      "type": "integer",
      "minimum": -9007199254740991,
      "maximum": 9007199254740991
    },
    "offset": {
      "description": "Number of results to skip",
      "type": "integer",
      "minimum": -9007199254740991,
      "maximum": 9007199254740991
    },
    "tags": {
      "description": "Filter by output tags (e.g. 'type:image/png')",
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "tagQueryMode": {
      "description": "Whether results must match all tags or any tag",
      "type": "string",
      "enum": [
        "all",
        "any"
      ]
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}