← BSV MCPInstall
Wallet

wallet_mintCollection

Mint a collection of ordinals from a folder of images with proper metadata. This tool creates a collection inscription first, then mints each image as a collection item with the appropriate metadata linking it to the collection.

Read as Markdown

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

FieldType / requiredDescription
folderPathstring
Required
Path to folder containing images to mint as a collection
collectionNamestring
Required
Name of the collection
descriptionstring
Required
Description of the collection
rarityLabelsarray of object
Optional
Rarity labels and their percentages
rarityLabels[].labelstring
Required
See schema for details.
rarityLabels[].percentagenumber
Required
See schema for details.

minimum: 0; maximum: 100

traitsstring
Optional
Collection traits as JSON string of key-value pairs where values are arrays, e.g. '{"Background": ["Blue", "Red"], "Eyes": ["Big", "Small"]}'
skipBroadcastboolean
Optional
Skip broadcasting transactions (for testing)

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

Full input schema
{
  "type": "object",
  "properties": {
    "folderPath": {
      "type": "string",
      "description": "Path to folder containing images to mint as a collection"
    },
    "collectionName": {
      "type": "string",
      "description": "Name of the collection"
    },
    "description": {
      "type": "string",
      "description": "Description of the collection"
    },
    "rarityLabels": {
      "description": "Rarity labels and their percentages",
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "label": {
            "type": "string"
          },
          "percentage": {
            "type": "number",
            "minimum": 0,
            "maximum": 100
          }
        },
        "required": [
          "label",
          "percentage"
        ]
      }
    },
    "traits": {
      "description": "Collection traits as JSON string of key-value pairs where values are arrays, e.g. '{\"Background\": [\"Blue\", \"Red\"], \"Eyes\": [\"Big\", \"Small\"]}'",
      "type": "string"
    },
    "skipBroadcast": {
      "description": "Skip broadcasting transactions (for testing)",
      "type": "boolean"
    }
  },
  "required": [
    "folderPath",
    "collectionName",
    "description"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}