Plugins
Plugins
.cursor-plugin/plugin.json
Vendor docs
config
| name | type | required | meaning | concept | |
|---|---|---|---|---|---|
| agents | string |
Path(s) to agent files or directories
|
docs ↗ | ||
| author | object |
Author info: `name` (required), `email` (optional)
|
docs ↗ | ||
| commands | string |
Path(s) to command files or directories
|
docs ↗ | ||
| description | string |
Brief plugin description
|
docs ↗ | ||
| homepage | string |
URL to plugin homepage
|
docs ↗ | ||
| hooks | string |
Path to hooks config file, or inline hook config
|
docs ↗ | ||
| keywords | array |
Tags for discovery and categorization
|
docs ↗ | ||
| license | string |
License identifier (e.g., `MIT`)
|
docs ↗ | ||
| logo | string |
Relative path to a logo file in the repo (e.g., `assets/logo.svg`), or an absolute URL. Relative paths resolve to `raw.githubusercontent.com` URLs. Preferred: commit the logo to your repo and use a relative path.
|
docs ↗ | ||
| mcpServers | string |
Path to MCP config file, inline MCP server config, or an array of either. Overrides default `mcp.json` discovery.
|
docs ↗ | ||
| name | string | yes |
Plugin identifier. Lowercase, kebab-case (alphanumerics, hyphens, and periods). Must start and end with an alphanumeric character. Examples: `my-plugin`, `prompts.chat`
|
docs ↗ | |
| repository | string |
URL to plugin repository
|
docs ↗ | ||
| rules | string |
Path(s) to rule files or directories
|
docs ↗ | ||
| skills | string |
Path(s) to skill directories
|
docs ↗ | ||
| variables | object |
JSON Schema that declares variable **names** (tokens, connection strings). The plugin does not store secret values; users set them in the dashboard (**Plugins** → **Configure**). Substituted into `${VAR}` placeholders. See Variables.
|
docs ↗ | ||
| version | string |
Semantic version (e.g., `1.0.0`)
|
docs ↗ |