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.

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
listingOutpoint	string Required	The outpoint of the listing to purchase (txid_vout format)
listingType	"nft" \| "token" Optional	Type of listing: 'nft' for ordinal NFTs, 'token' for BSV21 tokens default: "nft"
tokenID	string Optional	Token ID (txid_vout of deploy transaction) — required when listingType is 'token'
tokenAmount	string Optional	Amount of tokens in the listing (as string) — required when listingType is 'token'

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

Full input schema

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