← BSV MCPInstall
Wallet

wallet_getOrdinals

List ordinals/inscriptions in the wallet with metadata

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

Full tool description

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.

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