x402agent/SolanaOS / .agents/skills/metaplex
metaplex
VerifiedMetaplex 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.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 6.2 KB |
| references/cli-bubblegum.md | markdown | 4.8 KB |
| references/cli-candy-machine.md | markdown | 10.7 KB |
| references/cli-core.md | markdown | 4.1 KB |
| references/cli-genesis.md | markdown | 16.9 KB |
| references/cli-token-metadata.md | markdown | 2.5 KB |
| references/cli.md | markdown | 9.8 KB |
| references/concepts.md | markdown | 9.9 KB |
| references/metadata-json.md | markdown | 1.3 KB |
| references/sdk-bubblegum.md | markdown | 10.3 KB |
| references/sdk-core.md | markdown | 11.3 KB |
| references/sdk-genesis.md | markdown | 29.8 KB |
| references/sdk-token-metadata-kit.md | markdown | 7.7 KB |
| references/sdk-token-metadata.md | markdown | 12.6 KB |
| references/sdk-umi.md | markdown | 5.3 KB |
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`).
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| 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: 198k | Updated | Claude CodeCodex | Verified | Install |
| 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: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| 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: 194k | Updated | Claude CodeCodex | Verified | Install |