Skip to content

x402agent/SolanaOS / .agents/skills/metaplex

metaplex

Verified

Metaplex development on Solana — NFTs, tokens, compressed NFTs, candy machines, token launches. Use when working with Token Metadata, Core, Bubblegum, Candy Machine, Genesis, or the mplx CLI.

references/cli-token-metadata.md

View on GitHub
# Token Metadata CLI Reference

Commands for creating and managing Token Metadata NFTs and pNFTs via the `mplx` CLI.

> **Prerequisites**: Run Initial Setup from `./cli.md` first (RPC, keypair, SOL balance).

---

## pNFT vs NFT

| Type | Flag | Royalties | Use Case |
|------|------|-----------|----------|
| **pNFT** (default) | _(none)_ | Enforced at protocol level | Recommended for most NFTs |
| **NFT** | `--type nft` | Advisory only | Legacy compatibility, simpler transfers |

## Commands

```bash
# Create
mplx tm create --wizard                                                  # Interactive (recommended)
mplx tm create --name <NAME> --uri <URI>                                 # pNFT (default)
mplx tm create --name <NAME> --uri <URI> --type nft                      # Regular NFT
mplx tm create --name <NAME> --uri <URI> --collection <ADDR>             # In collection
mplx tm create --name <NAME> --royalties <PERCENT>                      # With royalties (see note below)
mplx tm create --image <PATH> --offchain <PATH>                              # From local files (uploads automatically)

# Transfer
mplx tm transfer <MINT> <DESTINATION>

# Update
mplx tm update <MINT> --name <NAME>
mplx tm update <MINT> --uri <URI>
mplx tm update <MINT> --symbol <SYMBOL>
mplx tm update <MINT> --description <DESCRIPTION>
mplx tm update <MINT> --image <PATH>                                     # Re-uploads image
```

**Notes:**
- `--uri` and `--royalties` are **mutually exclusive**. `--royalties` triggers a metadata building + upload flow (prompts for image, description, etc.) which conflicts with providing a pre-made URI. Use one or the other.
- `--royalties` takes a **whole number percentage** (0-100). Example: `--royalties 5` = 5% royalties (500 basis points).
- Default type is pNFT. Use `--type nft` for a regular (non-programmable) NFT.

---

## TM Collection Workflow

TM has no separate collection command. Create a collection NFT, then reference it:

```bash
# 1. Create collection NFT
mplx tm create --name "My Collection" --uri "<COLLECTION_URI>"
# Note the MINT address returned

# 2. Create NFTs in collection
mplx tm create --name "NFT #1" --uri "<URI_1>" --collection <COLLECTION_MINT> && \
mplx tm create --name "NFT #2" --uri "<URI_2>" --collection <COLLECTION_MINT>
```

> **Collection verification**: Unlike Core (which auto-verifies), TM collection items start **unverified**. The CLI handles verification automatically during `mplx tm create --collection`, but if you're building with the SDK you must call `verifyCollectionV1` separately (see `./sdk-token-metadata.md`).
slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack."Stars: 198kUpdated Claude CodeCodexVerifiedInstall
ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read.Stars: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report.Stars: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt.Stars: 194kUpdated Claude CodeCodexVerifiedInstall