# wallet_purchaseListing

Purchases a listing from the Bitcoin SV ordinals marketplace. Supports both NFT purchases and BSV21 token purchases.

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

Purchases a listing from the Bitcoin SV ordinals marketplace. Supports both NFT purchases and BSV21 token purchases.

| Field | Type | Required | Description | Constraints |
| --- | --- | --- | --- | --- |
| listingOutpoint | string | Yes | The outpoint of the listing to purchase (txid_vout format) |  |
| listingType | "nft" \| "token" | No | Type of listing: 'nft' for ordinal NFTs, 'token' for BSV21 tokens | default: "nft" |
| tokenID | string | No | Token ID (txid_vout of deploy transaction) — required when listingType is 'token' |  |
| tokenAmount | string | No | Amount of tokens in the listing (as string) — required when listingType is 'token' |  |

Nested requirements apply when their parent is supplied.

### Input schema

```json
{
  "type": "object",
  "properties": {
    "listingOutpoint": {
      "type": "string",
      "description": "The outpoint of the listing to purchase (txid_vout format)"
    },
    "listingType": {
      "default": "nft",
      "description": "Type of listing: 'nft' for ordinal NFTs, 'token' for BSV21 tokens",
      "type": "string",
      "enum": [
        "nft",
        "token"
      ]
    },
    "tokenID": {
      "description": "Token ID (txid_vout of deploy transaction) — required when listingType is 'token'",
      "type": "string"
    },
    "tokenAmount": {
      "description": "Amount of tokens in the listing (as string) — required when listingType is 'token'",
      "type": "string"
    }
  },
  "required": [
    "listingOutpoint"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "description": "Schema for the wallet_purchaseListing tool arguments (purchase NFTs or BSV21 tokens)."
}
```

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