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

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

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

| Field | Type | Required | Description | Constraints |
| --- | --- | --- | --- | --- |
| limit | integer | No | Max number of results to return | minimum: -9007199254740991; maximum: 9007199254740991 |
| offset | integer | No | Number of results to skip | minimum: -9007199254740991; maximum: 9007199254740991 |
| tags | array of string | No | Filter by output tags (e.g. 'type:image/png') |  |
| tagQueryMode | "all" \| "any" | No | Whether results must match all tags or any tag |  |

Nested requirements apply when their parent is supplied.

### Input schema

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

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