Plugin marketplaces
Marketplaces
.claude-plugin/marketplace.json
Vendor docs
config
| name | type | required | meaning | concept | |
|---|---|---|---|---|---|
| $schema | string |
JSON Schema URL for editor autocomplete and validation. Claude Code ignores this field at load time.
|
docs ↗ | ||
| agents | string |
Custom paths to agent files
|
docs ↗ | ||
| allowCrossMarketplaceDependenciesOn | array |
Other marketplaces that plugins in this marketplace may depend on. Dependencies from a marketplace not listed here are blocked at install. See Depend on a plugin from another marketplace.
|
docs ↗ | ||
| author | object |
Plugin author information (`name` required, `email` optional)
|
docs ↗ | ||
| category | string |
Plugin category for organization
|
docs ↗ | ||
| commands | string |
Custom paths to flat `.md` skill files or directories
|
docs ↗ | ||
| defaultEnabled | boolean |
Whether the plugin is enabled after install (default: true). Set to `false` to install the plugin disabled until the user opts in. Takes precedence over the same field in the plugin's `plugin.json`. See Default enablement. Requires Claude Code v2.1.154 or later.
|
docs ↗ | ||
| description | string |
Brief marketplace description
|
docs ↗ | ||
| displayName | string |
Human-readable name shown in UI surfaces. Falls back to `name` when omitted. May contain spaces and any casing. Not used for namespacing or lookup. Requires Claude Code v2.1.143 or later.
|
docs ↗ | ||
| string |
Contact email for the maintainer
|
docs ↗ | |||
| homepage | string |
Plugin homepage or documentation URL
|
docs ↗ | ||
| hooks | string |
Custom hooks configuration or path to hooks file
|
docs ↗ | ||
| keywords | array |
Tags for plugin discovery and categorization
|
docs ↗ | ||
| license | string |
SPDX license identifier (for example, MIT, Apache-2.0)
|
docs ↗ | ||
| lspServers | string |
LSP server configurations or path to LSP config
|
docs ↗ | ||
| mcpServers | string |
MCP server configurations or path to MCP config
|
docs ↗ | ||
| metadata.pluginRoot | string |
Base directory prepended to relative plugin source paths (for example, `"./plugins"` lets you write `"source": "formatter"` instead of `"source": "./plugins/formatter"`)
|
docs ↗ | ||
| name | string | yes |
Marketplace identifier (kebab-case, no spaces). This is public-facing: users see it when installing plugins (for example, `/plugin install my-tool@your-marketplace`). Each user can register only one marketplace per name: adding a second marketplace with the same name replaces the first. To publish multiple plugins under one marketplace name, list them all in a single `marketplace.json`.
|
docs ↗ | |
| owner | object | yes |
Marketplace maintainer information (see fields below)
|
docs ↗ | |
| plugins | array | yes |
List of available plugins
|
docs ↗ | |
| relevance | object |
Signals that tell Claude Code when to suggest this plugin to users. Takes effect only for marketplaces an administrator allowlists in managed settings. See Recommend plugins for your org. Requires Claude Code v2.1.152 or later.
|
docs ↗ | ||
| renames | object |
Map from a former plugin `name` to its current name, or to `null` if the plugin was removed. Lets existing users migrate automatically when you rename or remove an entry in `plugins`. See Rename or remove a plugin. Requires Claude Code v2.1.193 or later.
|
docs ↗ | ||
| repository | string |
Source code repository URL
|
docs ↗ | ||
| skills | string |
Custom paths to skill directories containing `<name>/SKILL.md`
|
docs ↗ | ||
| source | string | yes |
Where to fetch the plugin from (see Plugin sources below)
|
docs ↗ | |
| strict | boolean |
Controls whether `plugin.json` is the authority for component definitions (default: true). See Strict mode below.
|
docs ↗ | ||
| tags | array |
Tags for searchability
|
docs ↗ | ||
| version | string |
Marketplace manifest version
|
docs ↗ |