Agent skill

Metaplex on Solana

by internet-court in internet-court/internet-court-skill

Directs Metaplex work on Solana: NFTs, tokens, compressed NFTs, Candy Machine drops, Genesis launches and the agent registry, using the mplx CLI by default and Umi or Kit for code.

Apache-2.0Auto-check passedDevelopment

Install Metaplex on Solana

skills CLI
$ npx skills add internet-court/internet-court-skill --skill metaplex -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install internet-court/internet-court-skill metaplex --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/internet-court/internet-court-skill.git skills-src && mkdir -p .claude/skills && cp -r skills-src/vendored/metaplex/metaplex .claude/skills/metaplex && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
metaplex
GitHub stars
6.6k
Token cost
~2.5k tokens
SKILL.md length
922 words
Files
23 (incl. references)
Skills in repo
80
Repo updated
First seen
Licence
Apache-2.0

At a glance

Directs Metaplex work on Solana: NFTs, tokens, compressed NFTs, Candy Machine drops, Genesis launches and the agent registry, using the mplx CLI by default and Umi or Kit for code.

  • Minting an NFT collection with Metaplex Core on Solana
  • SKILL.md covers Overview, Tool Selection, Task Router and CLI Capabilities, plus 3 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md
  • Creating compressed NFTs with Bubblegum

What it does

The Metaplex programs on Solana are laid out here with a note on what each is for: Agent Registry for on-chain agent identity, wallets and execution delegation, Genesis for token launches with fair distribution and liquidity graduation, Core as the recommended NFT standard for new projects, Token Metadata for fungible tokens and legacy NFTs, Bubblegum for compressed NFTs on Merkle trees, and Candy Machine for NFT drops with configurable minting rules.

The agent is told to prefer the mplx CLI for direct execution and to fall back to the Umi SDK when you need code, or the Kit SDK only for Token Metadata work with @solana/kit. A task router maps each job, such as Core collections, Bubblegum, Candy Machine or a Genesis launch, to reference files, and the agent must read those before running any command because syntax, flags and batching rules live only there. The references folder also has pages on concepts and metadata JSON.

When your agent uses it

  • Minting an NFT collection with Metaplex Core on Solana
  • Creating compressed NFTs with Bubblegum
  • Setting up a Candy Machine drop with minting rules
  • Launching a token through Genesis
  • Registering an on-chain agent identity with the Agent Registry

Example prompts

  • “Create a Core NFT collection with the mplx CLI and mint three assets into it.”
  • “Set up a Candy Machine for my collection with a start date and a price.”
  • “Write Umi SDK code that mints a compressed NFT with Bubblegum.”
  • “Launch a new token with Genesis and explain how the liquidity graduation works.”

Requirements

  • The mplx CLI

What it can do on your machine

Read from SKILL.md and the folder at commit fa89195. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Links to these hosts (documentation or services it may open):

    • metaplex.com

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Metaplex on Solana loads about 2.5k tokens when it runs, and up to ~59k if it reads all its reference files. Until then it costs about 59 tokens; SKILL.md has 922 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~59
When it runs · the whole SKILL.md, loaded when a task matches
~2.5k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~59k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from internet-court/internet-court-skill at commit fa89195, republished under its Apache-2.0 licence (© internet-court). 922 words, ~2,472 tokens.

Download SKILL.mdSave it as .claude/skills/metaplex/SKILL.md (or your agent's skills folder). This skill also uses 22 other files; get the full folder from GitHub.
name
metaplex
description
Metaplex development on Solana — NFTs, tokens, compressed NFTs, candy machines, token launches, autonomous agents. Use when working with Token Metadata, Core, Bubblegum, Candy Machine, Genesis, Agent Registry, or the mplx CLI.
license
Apache-2.0
metadata.author
metaplex-foundation
metadata.version
0.3.0

Metaplex Development Skill

Overview

Metaplex provides the standard infrastructure for NFTs and tokens on Solana:

  • Agent Registry: On-chain agent identity, wallets, and execution delegation for MPL Core assets
  • Genesis: Token launch protocol with fair distribution + liquidity graduation
  • Core: Next-gen NFT standard (recommended for new NFT projects)
  • Token Metadata: Fungible tokens + legacy NFTs/pNFTs
  • Bubblegum: Compressed NFTs (cNFTs) using Merkle trees — massive scale at minimal cost
  • Candy Machine: NFT drops with configurable minting rules

Tool Selection

Prefer CLI over SDK for direct execution. Use SDK only when user specifically needs code.

ApproachWhen to Use
CLI (mplx)Default choice - direct execution, no code needed
Umi SDKUser needs code — default SDK choice. Covers all programs (TM, Core, Bubblegum, Genesis)
Kit SDKUser specifically uses @solana/kit, or asks for minimal dependencies. Token Metadata only — no Core/Bubblegum/Genesis support

Task Router

IMPORTANT: You MUST read the detail file for your task BEFORE executing any command or writing any code. The command syntax, required flags, setup steps, and batching rules are ONLY in the detail files. Do NOT guess commands from memory.

Task TypeRead This File
Any CLI operation (agent guidelines, batching, explorer links)./references/cli.md
CLI: Agent Registry (identity, delegation, revocation, token linking)./references/cli.md + ./references/cli-agent.md
CLI: Core NFTs/Collections./references/cli.md + ./references/cli-core.md + ./references/metadata-json.md
CLI: Token Metadata NFTs./references/cli.md + ./references/cli-token-metadata.md + ./references/metadata-json.md
CLI: Compressed NFTs (Bubblegum)./references/cli.md + ./references/cli-bubblegum.md + ./references/metadata-json.md
CLI: Candy Machine (NFT drops)./references/cli.md + ./references/cli-candy-machine.md + ./references/metadata-json.md
CLI: Token launch / bonding curve (Genesis)./references/cli.md + ./references/cli-genesis.md
CLI: Execute / asset-signer wallets / agent vault./references/cli.md + ./references/cli-core.md (execute section)
SDK: Execute / asset-signer PDA / agent vault./references/sdk-umi.md + ./references/sdk-core.md (execute section)
CLI: Fungible tokens./references/cli.md + ./references/cli-toolbox.md
SDK setup (Umi)./references/sdk-umi.md
SDK: Core NFTs./references/sdk-umi.md + ./references/sdk-core.md + ./references/metadata-json.md
SDK: Token Metadata./references/sdk-umi.md + ./references/sdk-token-metadata.md + ./references/metadata-json.md
SDK: Compressed NFTs (Bubblegum)./references/sdk-umi.md + ./references/sdk-bubblegum.md + ./references/metadata-json.md
SDK: Token Metadata with Kit./references/sdk-token-metadata-kit.md + ./references/metadata-json.md
SDK: Agent Registry (identity, wallets, delegation)./references/sdk-umi.md + ./references/sdk-agent.md
SDK: Token launch + bonding curve swaps (Genesis)./references/sdk-umi.md + ./references/sdk-genesis.md
SDK: Low-level Genesis (custom buckets, presale, vesting)./references/sdk-umi.md + ./references/sdk-genesis-low-level.md
Off-chain metadata JSON format/schema (NFT or token)./references/metadata-json.md
Account structures, PDAs, concepts./references/concepts.md
CLI errors, localnet issues./references/cli-troubleshooting.md

CLI Capabilities

The mplx CLI can handle most Metaplex operations directly. Read ./references/cli.md for agent guidelines (batching, JSON output, explorer links), then the program-specific file.

CLI v0.1.0 breaking changes (for agents/scripts migrating from older versions):

  • --json <file> (used to pass an offchain metadata file path) is now --offchain <file>. --json is now the standard OCLIF flag for machine-readable output.
  • All commands now return structured JSON when --json is passed — use this for programmatic/agent use.
TaskCLI Support
Register agent identity✅
Fetch agent data✅
Revoke execution delegation✅
Set agent token (Genesis link)✅ (requires asset-signer mode)
Create fungible token✅
Create Core NFT/Collection✅
Create TM NFT/pNFT✅
Transfer TM NFTs✅
Transfer fungible tokens✅
Transfer Core NFTs✅
Upload to Irys✅
Candy Machine drop✅ (setup/config/insert — minting requires SDK)
Compressed NFTs (cNFTs)✅ (batch limit ~100, use SDK for larger)
Execute (asset-signer wallets)✅
Check SOL balance / Airdrop✅
Query assets by owner/collection❌ SDK only (DAS API)
Token launch (Genesis)✅
Bonding curve swap (Genesis)✅

Program IDs

Agent Identity:  1DREGFgysWYxLnRnKQnwrxnJQeSMk2HmGaC6whw2B2p
Agent Tools:     TLREGni9ZEyGC3vnPZtqUh95xQ8oPqJSvNjvB7FGK8S
Genesis:         GNS1S5J5AspKXgpjz6SvKL66kPaKWAhaGRhCqPRxii2B
Core:            CoREENxT6tW1HoK8ypY1SxRMZTcVPm7R94rH4PZNhX7d
Token Metadata:  metaqbxxUerdq28cj1RbAWkYQm3ybzjb6a8bt518x1s
Bubblegum V1:    BGUMAp9SX3uS4efGcFjPjkAQZ4cUNZhtHaMq64nrGf9D
Bubblegum V2:    BGUMAp9Gq7iTEuizy4pqaxsTyUCBK68MDfK752saRPUY
Core Candy:      CMACYFENjoBMHzapRXyo1JZkVS6EtaDDzkjMrmQLvr4J

Quick Decision Guide

Autonomous Agents

Use Agent Registry to register on-chain identity and execution delegation for MPL Core assets. The Mint Agent API (mintAndSubmitAgent) is the recommended path — it creates the Core asset and registers identity in a single transaction. For existing assets, use registerIdentityV1 directly. Any Core asset already has a built-in wallet (Asset Signer PDA) via Core's Execute hook — the registry adds discoverable identity records and lets owners delegate an off-chain executive to operate the agent. Agents can optionally link a Genesis token via setAgentTokenV1. Read ./references/cli-agent.md (CLI) or ./references/sdk-umi.md + ./references/sdk-agent.md (SDK).

Show full SKILL.md (337 more words)Show less
Token Launches (Token Generation Event / Fair Launch / Bonding Curve)

Use Genesis. The Launch API (genesis launch create / createAndRegisterLaunch) is recommended — it handles everything in one step. Two launch types:

  • launchpool (default): Configurable allocations, 48h deposit, team vesting support
  • bonding-curve: Instant bonding curve (constant product AMM) — no deposit window, trading starts immediately, auto-graduates to Raydium CPMM on sell-out. Supports creator fees, first buy, and agent mode.

Read ./references/cli.md + ./references/cli-genesis.md (CLI) or ./references/sdk-genesis.md (SDK launch flow). For custom buckets/presale/vesting, use ./references/sdk-genesis-low-level.md.

NFTs: Core vs Token Metadata
ChooseWhen
CoreNew NFT projects, lower cost (87% cheaper), plugins, royalty enforcement
Token MetadataExisting TM collections, need editions, pNFTs for legacy compatibility
Compressed NFTs (Massive Scale)

Use Bubblegum when minting thousands+ of NFTs at minimal cost. See ./references/cli-bubblegum.md (CLI) or ./references/sdk-bubblegum.md (SDK).

Fungible Tokens

Always use Token Metadata. Read ./references/cli-toolbox.md for CLI commands.

NFT Drops

Use Core Candy Machine. Read ./references/cli.md + ./references/cli-candy-machine.md.

App Mints into a Core Collection WITHOUT Candy Machine

Creating an asset into a Core collection requires the collection's update authority (or an UpdateDelegate) to sign — a user's wallet can't, and the authority key must never be in a frontend. The app needs either a custom on-chain program (PDA granted UpdateDelegate, mint logic in the program) or a backend/API holding a delegate keypair that signs mints. Read the "Minting into a Collection from an App" section in ./references/sdk-core.md before designing the minting flow.

Asset as Agent / Vault / Wallet (Execute)

Use Core Execute when an asset (NFT, agent, vault) needs to hold SOL/tokens, transfer funds, sign transactions, or own other assets. Every Core asset has a signer PDA that can act as an autonomous wallet. Read ./references/cli-core.md (CLI) or ./references/sdk-core.md (SDK), execute section.

For more info

When a task needs deeper detail than the skill references provide (edge cases, full API surfaces, guides), consult the Metaplex docs:

© internet-court, Apache-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 22 other files (references) in vendored/metaplex/metaplex of internet-court/internet-court-skill.

  • SKILL.md
  • LICENSE
  • references/cli-agent.md
  • references/cli-bubblegum.md
  • references/cli-candy-machine.md
  • references/cli-config.md
  • references/cli-core.md
  • references/cli-genesis.md
  • references/cli-initial-setup.md
  • references/cli-token-metadata.md
  • references/cli-toolbox.md
  • references/cli-troubleshooting.md
  • references/cli.md
  • references/concepts.md
  • references/metadata-json.md
  • references/sdk-agent.md
  • references/sdk-bubblegum.md
  • references/sdk-core.md
  • references/sdk-genesis-low-level.md
  • references/sdk-genesis.md
  • … and 3 more

Open the folder on GitHubat commit fa89195

Compare with similar skills

Metaplex on Solana next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Metaplex on Solana compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Metaplex on Solana this skillinternet-court/internet-court-skill6.6k—~2.5kAutomated safety check: PassApache-2.0
Pump TS Vanitynirholas/pump-fun-sdk134—~738Automated safety check: PassCustom licence
Solana Kit Migrationsendaifun/skills1301 repos~2.6kAutomated safety check: PassApache-2.0
Solana Token Extensionssolanabr/ai-kit109—~3.5kAutomated safety check: PassMIT
BlockrunBlockRunAI/blockrun-mcp391—~2.7kAutomated safety check: PassMIT
Payram Crypto PaymentsPayRam/payram-mcp158—~2kAutomated safety check: NotesNone

Similar skills

  • Pump TS Vanity

    nirholas/pump-fun-sdk

    Educational single-threaded TypeScript vanity address generator for Solana using @solana/web3.js with async iteration, event-loop yielding, streaming generator API, and best-effort memory zeroization.

    134 GitHub stars~738 tokensUpdated yesterday
    DevelopmentAuto-check passed
  • Solana Kit Migration

    sendaifun/skills

    Helps developers understand when to use @solana/kit vs @solana/web3.js (v1), provides migration guidance, API mappings, and handles edge cases for Solana JavaScript SDK transitions

    130 GitHub starsUsed in 1 repo~2.6k tokens
    Business, Finance & HRAuto-check passed
  • Helps choose, combine and create Token-2022 mint and account extensions on Solana with the spl-token CLI, @solana/kit or Anchor, and integrate the resulting mints.

    109 GitHub stars~3.5k tokensUpdated today
    Backend & APIsAuto-check passed
  • Blockrun

    BlockRunAI/blockrun-mcp

    Pay-per-call access to AI models, real-time data, media generation and multi-chain RPC over x402 micropayments (USDC on Base or Solana), or a BlockRun account API key.

    391 GitHub stars~2.7k tokensUpdated 3 days ago
    Media & CreativeAuto-check passed
  • Payram Crypto Payments

    PayRam/payram-mcp

    Self-hosted crypto and stablecoin payment gateway. An agent skill from PayRam/payram-mcp.

    158 GitHub stars~2k tokensUpdated 2 days ago
    Backend & APIsAuto-check: notes
  • Swap Tokens

    circlefin/skills

    Build browser or server token swaps with Circle App Kit or standalone Swap Kit.

    155 GitHub stars~4.6k tokensUpdated yesterday
    Backend & APIsAuto-check: notes

More from internet-court/internet-court-skill

All 80 skills in this repo
  • Kleros IPFS Upload

    internet-court/internet-court-skill

    Uploads one Kleros-related file per paid request to IPFS through the Kleros x402 gateway for 0.01 USDC on Base, returning a CID that Kleros contracts can reference.

    6.6k GitHub stars~4.9k tokensUpdated 1 mo ago
    Auto-check: notes
  • 0G Compute Network Guide

    internet-court/internet-court-skill

    Guides building on the 0G Compute Network, a decentralized GPU marketplace for AI inference and fine-tuning, with SDK patterns and CLI commands.

    6.6k GitHub starsUsed in 1 repo~1.9k tokens
    Auto-check passed
  • PNP Prediction Markets on Solana

    internet-court/internet-court-skill

    Creates, trades and settles permissionless prediction markets on Solana with any SPL token as collateral, including social-media and custom-oracle markets.

    6.6k GitHub stars~7.5k tokensUpdated 1 mo ago
    Auto-check: notes
  • BNB Chain MCP Server

    internet-court/internet-court-skill

    Connects an agent to the BNB Chain MCP server to read blocks and contracts, move tokens and NFTs, register ERC-8004 agents and use Greenfield storage.

    6.6k GitHub starsUsed in 1 repo~1.7k tokens
    Auto-check passed
  • GenLayer ERC-7710 Connector

    internet-court/internet-court-skill

    Specifies how a GenLayer Intelligent Contract decision about an agent's performance becomes an ERC-7710 revocation or policy change, through a relayer or bridge and an EVM controller.

    6.6k GitHub starsUsed in 1 repo~2.2k tokens
    Auto-check passed
  • GenLayer Agent Supervision Adapter

    internet-court/internet-court-skill

    Specifies how a GenLayer Intelligent Contract should supervise an AI agent, with review rubrics, evidence schemas and continue, warn, constrain or revoke decisions.

    6.6k GitHub starsUsed in 1 repo~1.8k tokens
    Auto-check passed

Works with

Questions about Metaplex on Solana

What does Metaplex on Solana do?

Directs Metaplex work on Solana: NFTs, tokens, compressed NFTs, Candy Machine drops, Genesis launches and the agent registry, using the mplx CLI by default and Umi or Kit for code. The Metaplex programs on Solana are laid out here with a note on what each is for: Agent Registry for on-chain agent identity, wallets and execution delegation, Genesis for token launches with fair distribution and liquidity graduation, Core as the recommended NFT standard for new projects, Token Metadata for fungible tokens and legacy NFTs, Bubblegum for compressed NFTs on Merkle trees, and Candy Machine for NFT drops with configurable minting rules.

When should I use Metaplex on Solana?

Metaplex on Solana fits situations like: minting an NFT collection with Metaplex Core on Solana; creating compressed NFTs with Bubblegum; setting up a Candy Machine drop with minting rules; launching a token through Genesis.

How do I install Metaplex on Solana in Claude Code?

Run `npx skills add internet-court/internet-court-skill --skill metaplex -a claude-code`. Or copy the skill folder (vendored/metaplex/metaplex in internet-court/internet-court-skill) into .claude/skills/metaplex in your project. Claude Code loads it when a task matches its description.

How do I install Metaplex on Solana in Codex?

Run `npx skills add internet-court/internet-court-skill --skill metaplex -a codex`. Or copy the skill folder (vendored/metaplex/metaplex in internet-court/internet-court-skill) into .agents/skills/metaplex in your project. Codex loads it when a task matches its description.

Can I use Metaplex on Solana in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add internet-court/internet-court-skill --skill metaplex -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/metaplex, .gemini/skills/metaplex, .github/skills/metaplex and .opencode/skills/metaplex in your project.

What does Metaplex on Solana need to run?

SKILL.md names no scripts, command-line tools or credentials: Metaplex on Solana is instructions for the agent only. Our summary lists: The mplx CLI.

Does Metaplex on Solana access the network?

SKILL.md names 1 domain. As links in the text: metaplex.com. This is read from the text; nothing was executed.

Is Metaplex on Solana safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Metaplex on Solana use?

Metaplex on Solana is published under the Apache-2.0 licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Metaplex on Solana use?

About 2.5k tokens (SKILL.md is roughly 9.9k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 56k tokens, read only when the agent opens those files.

What are the alternatives to Metaplex on Solana?

Skills that share tags, products or a category with Metaplex on Solana: Pump TS Vanity (nirholas/pump-fun-sdk, 134 stars), Solana Kit Migration (sendaifun/skills, 130 stars), Solana Token Extensions (solanabr/ai-kit, 109 stars) and Blockrun (BlockRunAI/blockrun-mcp, 391 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Metaplex on Solana?

internet-court (a GitHub organization) maintains it in internet-court/internet-court-skill, which has 6,551 GitHub stars. The repository holds 80 skills in this directory. The repository was last updated on August 19, 2026.

Source: internet-court/internet-court-skill on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.