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-core.md
View on GitHub# Core CLI Reference
Commands for creating and managing Core NFTs and collections via the `mplx` CLI.
> **Prerequisites**: Run Initial Setup from `./cli.md` first (RPC, keypair, SOL balance).
---
## Commands
```bash
# Core Assets
mplx core asset create --name <NAME> --uri <URI>
mplx core asset create --name <NAME> --uri <URI> --owner <ADDR> # Mint to a different wallet — --owner works on all asset create variants
mplx core asset create --name <NAME> --uri <URI> --collection <ADDR>
mplx core asset create --files --image <PATH> --offchain <PATH> # From local files (uploads automatically) — may error on JSON upload; use manual upload workflow as fallback
mplx core asset fetch <ADDR>
mplx core asset update <ASSETID> --name <NAME>
mplx core asset update <ASSETID> --uri <URI>
mplx core asset update <ASSETID> --image <PATH> # Re-uploads image via Irys
mplx core asset update <ASSETID> --collectionId <ADDR> # Move to different collection
mplx core asset transfer <ASSETID> <NEW_OWNER> # Collection is auto-detected from the asset
mplx core asset burn <ADDR> # Also: --collection <ADDR>, --list <file.json>
mplx core asset template # Generate template files
# Core Collections
mplx core collection create --name <NAME> --uri <URI>
mplx core collection create --name <NAME> --uri <URI> --pluginsFile <PATH>
mplx core collection fetch <ADDR>
mplx core collection template # Generate template files
```
---
## Core Plugins
**Plugin file format** (for `--pluginsFile`):
```json
[{
"type": "Royalties",
"basisPoints": 500,
"creators": [{"address": "<CREATOR_ADDRESS>", "percentage": 100}],
"ruleSet": {"type": "None"}
}]
```
**Available Types:** `Royalties`, `FreezeDelegate`, `BurnDelegate`, `TransferDelegate`, `Attributes`, `ImmutableMetadata`, `PermanentFreezeDelegate`, `PermanentTransferDelegate`, `PermanentBurnDelegate`
**RuleSet Options:**
- `{"type": "None"}`
- `{"type": "ProgramAllowList", "programs": [...]}`
- `{"type": "ProgramDenyList", "programs": [...]}`
**Example - Collection with Royalties:**
```bash
# Create plugins.json
echo '[{
"type": "Royalties",
"basisPoints": 500,
"creators": [{"address": "<CREATOR_ADDRESS>", "percentage": 100}],
"ruleSet": {"type": "None"}
}]' > plugins.json
# Create collection with plugins
mplx core collection create \
--name "My Collection" \
--uri "https://gateway.irys.xyz/xxx" \
--pluginsFile ./plugins.json
```
Note: `basisPoints: 500` = 5%. Creator percentages must total 100.
---
## Metadata Workflow
### Before Creating - Gather from User:
- Name
- Description (optional)
- Attributes (optional)
- Image file
- For collections: Ask if they want royalties
### Single NFT/Collection
```bash
# Option A: Local files (one step) - recommended
mplx core asset create --files --image ./image.png --offchain ./metadata.json
# Option B: Manual upload workflow
# 1. Upload image
mplx toolbox storage upload ./image.png
# Returns: https://gateway.irys.xyz/<IMAGE_HASH>
# 2. Create metadata.json — follow the NFT schema in metadata-json.md, set image URI to above
# 3. Upload metadata
mplx toolbox storage upload ./metadata.json
# Returns: https://gateway.irys.xyz/<META_HASH>
# 4. Create asset
mplx core asset create --name "My NFT" --uri "https://gateway.irys.xyz/<META_HASH>"
```
### Multiple NFTs (Batch)
```bash
# 1. Upload all images at once
mplx toolbox storage upload ./images --directory
# 2. Create metadata files — one per NFT, each following the NFT schema in metadata-json.md
# Set each "image" + properties.files[0].uri to the corresponding uploaded image URI
# 3. Upload all metadata at once
mplx toolbox storage upload ./meta --directory
# 4. Create all assets (ONE command)
mplx core asset create --name "NFT #1" --uri "<META_URI_1>" --collection <ADDR> && \
mplx core asset create --name "NFT #2" --uri "<META_URI_2>" --collection <ADDR> && \
mplx core asset create --name "NFT #3" --uri "<META_URI_3>" --collection <ADDR>
```
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 |