wallet_purchaseListing

Purchases a listing from the Bitcoin SV ordinals marketplace

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

Full tool description

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

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