--- title: "How to List Your SaaS in the Claude Plugin Directory | Viraloop" description: "Package an MCP server and a skill as a Claude plugin, validate it, and submit the public repo to the Claude plugin directory. Every requirement, file and gotcha." source: https://viraloop.io/ai-plugin-directories/claude-plugins --- [AI plugin directories](/ai-plugin-directories) # How to list on Claude plugins The Claude plugin directory is the catalog every Claude Code and Cowork user sees when they open the plugin browser. A listing there means a developer can install your product into Claude with one command, and Claude then knows how to use it because your skill ships with it. It is the highest-signal directory on this list for developer tools, and the only one where the listing stays in sync with your repo after approval. You ship Public repo: .claude-plugin/plugin.json, .mcp.json, skills/ Submit at platform.claude.com/plugins/submit Review Automated screening; Anthropic Verified badge is a separate, optional review Auth Env var API key or a remote MCP with OAuth 01 ## What a Claude plugin is A plugin is a folder in a public git repo. It bundles any combination of skills (markdown instructions Claude activates when relevant), MCP connectors (the tools), slash commands and sub-agents. For a SaaS the useful shape is one skill that teaches the workflow plus one MCP server that exposes the API. Anthropic's own guidance says the best plugins solve a job end to end rather than exposing one tool, so write the skill around the three or four things a customer actually does with you. 02 ## The files - .claude-plugin/plugin.json: name, version, description, author, homepage, repository, license, keywords - .claude-plugin/marketplace.json: makes the repo its own marketplace, so users can install before you are in the directory - .mcp.json: the MCP server, either a remote URL or a local npx command with the env var it needs - skills//SKILL.md: the skill, plus references/ files for the API reference and workflows - README.md: install commands, how to get an API key, what the plugin can do 03 ## Submit it 1. 1Push the plugin to a public GitHub repo. Closed-source plugins are rejected. 2. 2Run claude plugin validate in the repo and fix everything it flags. 3. 3Sign in to the Console at platform.claude.com with a Developer, Admin or Owner role on the organization. 4. 4Submit the repo link at platform.claude.com/plugins/submit. Team and Enterprise admins can use claude.ai/admin-settings/directory/submissions/plugins/new instead. 5. 5Wait for the automated review. Times vary with the queue; there is no fixed SLA. 6. 6After approval, push updates to the repo. CI mirrors them into the public marketplace and re-screens each one, so you never re-submit the form. 04 ## What users do once you are listed In Claude Code the directory appears as the official claude-plugins-official marketplace, available to everyone without setup. Before you are listed, and for users who want the latest commit, the repo doubles as a marketplace: Install from your own repo /plugin marketplace add / /plugin install @ 05 ## What we learned shipping ours - Generate the plugin folder from the same source as your API docs and OpenAPI spec. Hand-maintained manifests drift within a month. - Ship the MCP server as an npm package started with npx so the plugin works on a fresh machine with nothing preinstalled. - The repo the plugin syncs to needs a LICENSE file. Keep it out of the sync so the generator does not delete it. - Include a SETUP.md skill if the MCP server needs a key: Claude reads it on install and walks the user through creating one. - The Connectors Directory is a separate submission for remote MCP servers. Do both: the plugin for Claude Code and Cowork, the connector for claude.ai chat. Vendor docs this guide is checked against - [Submitting your plugin](https://claude.com/docs/plugins/submit)claude.com/docs/plugins/submit - [Claude Code plugin guide](https://code.claude.com/docs/en/plugins)code.claude.com/docs/en/plugins - [Community marketplace repo](https://github.com/anthropics/claude-plugins-community)github.com/anthropics/claude-plugins-community ## Listed is step one. Being named is the job. Assistants recommend the brands they keep seeing. Viraloop generates and posts your short-form content daily, so the model's answer about you stays current. [Start posting daily](/register)[All directories](/ai-plugin-directories)