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` and `url` 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.
|
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.
|
docs ↗ | ||
| string |
Contact email for the maintainer
|
docs ↗ | |||
| headers | object |
HTTP headers Claude Code sends when it downloads this entry's archive. Overrides the marketplace's headers of the same name. Requires Claude Code v2.1.238 or later.
|
docs ↗ | ||
| headersHelper | string |
Command that prints the HTTP headers for this entry's archive download as one JSON object, for a credential that expires. See Authenticate archive downloads. The entry must also set `"strict": false`. Requires Claude Code v2.1.238 or later.
|
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 | object |
Free-form object for your own fields, such as entitlement or catalog data. Claude Code doesn't read it. Before v2.1.222, `claude plugin validate` reported the key as an unrecognized field.
|
docs ↗ | ||
| metadata.pluginRoot | string |
Directory that Claude Code resolves bare plugin source names under. See Relative paths. Requires Claude Code v2.1.239 or later.
|
docs ↗ | ||
| name | string | yes |
Marketplace identifier in kebab-case, with no spaces, control characters, or bidirectional-formatting characters. 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: when they add a second marketplace with the same name, Claude Code 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.
|
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 ↗ | ||
| url | string |
Website, GitHub profile, or organization URL
|
docs ↗ | ||
| version | string |
Marketplace manifest version
|
docs ↗ |