Getting Started
Metaplex Skill
Last updated April 8, 2026
Metaplex Skill is an Agent Skill — a knowledge base that gives AI coding agents accurate, up-to-date knowledge of Metaplex programs, CLI commands, and SDK patterns.
Summary
The Metaplex Skill gives AI coding agents accurate knowledge of all Metaplex programs, CLI commands, and SDK patterns.
- Covers six programs: Agent Registry, Genesis, Core, Token Metadata, Bubblegum, and Candy Machine
- Supports CLI, Umi SDK, and Kit SDK approaches
- Works with Claude Code, Cursor, Copilot, Codex, Windsurf, and other compatible agents
- Uses progressive disclosure to minimize token usage while providing full coverage
Instead of relying on hallucinated APIs or incorrect flags, your AI agent can reference the Skill to get accurate commands and code on the first try.
Installation
Install the Skill in Claude Code, Cursor, Copilot, or any agent that supports the Agent Skills format.
How It Works
Learn how progressive disclosure keeps context lightweight while providing full coverage.
Programs Covered
The Skill covers six Metaplex programs and their full operation sets:
| Program | Purpose | CLI | Umi SDK | Kit SDK |
|---|---|---|---|---|
| Agent Registry | On-chain agent identity, wallets, and execution delegation | Yes | Yes | — |
| Genesis | Token launches via launchpool or bonding curve with Raydium graduation | Yes | Yes | — |
| Core | Next-gen NFTs with plugins and royalty enforcement | Yes | Yes | — |
| Token Metadata | Fungible tokens, NFTs, pNFTs, editions | Yes | Yes | Yes |
| Bubblegum | Compressed NFTs via Merkle trees | Yes | Yes | — |
| Core Candy Machine | NFT drops with configurable guards | Yes | Yes | — |
Operations Supported
The Skill provides reference material for three approaches to Metaplex development:
- CLI (
mplx) — Direct execution of Metaplex operations from the terminal. Agent registration (mplx agents), token launches and bonding curve creation (mplx genesis), asset creation, uploads, Candy Machine deployment, tree creation, transfers, and more. - Umi SDK — Full programmatic access covering all programs. Agent identity and delegation, Genesis launches and bonding curve swaps, fetches by owner/collection/creator, DAS API queries, delegate management, and plugin configuration.
- Kit SDK — Token Metadata operations using
@solana/kitwith minimal dependencies.
Compatible Agents
The Skill works with any AI coding agent that supports the Agent Skills format:
Next Steps
- Install the Skill to get started
- How It Works to understand the architecture
- Programs & Operations for detailed coverage
Quick Reference
The Metaplex Skill installs via a single command and provides coverage for six programs through CLI, Umi SDK, and Kit SDK.
| Item | Value |
|---|---|
| Install command | npx skills add metaplex |
| Skill format | Agent Skills |
| CLI package | @metaplex-foundation/cli (mplx) |
| Programs covered | 6 (Agent Registry, Genesis, Core, Token Metadata, Bubblegum, Candy Machine) |
| SDK approaches | Umi SDK (all programs), Kit SDK (Token Metadata only) |
Glossary
Key terms used throughout the Metaplex Skill documentation.
| Term | Definition |
|---|---|
| Agent Skill | A structured knowledge base that gives AI coding agents accurate context for a specific domain |
| Progressive disclosure | Architecture where the agent reads a lightweight router first, then loads only the reference files needed for the current task |
| SKILL.md | The router file that maps tasks to specific reference files |
mplx | The Metaplex CLI tool that provides direct terminal access to all supported programs |
| Umi SDK | Metaplex's primary TypeScript SDK framework for programmatic access to all programs |
| Kit SDK | A lightweight alternative SDK using @solana/kit, currently supporting Token Metadata only |
Notes
- The Skill requires an AI coding agent that supports the Agent Skills format
- Skill files are static references bundled into your project — re-run the install command to update
- The
npx skills addcommand requires Node.js and npm/npx