Skip to main content

Claude Code Plugin Marketplace

LiteLLM AI Gateway acts as a central registry for Claude Code plugins. Admins can govern which plugins are available across the organization, and engineers can discover and install approved plugins from a single source.

Prerequisites​

  • LiteLLM Proxy running with database connected
  • Admin access to LiteLLM UI
  • Plugins hosted on GitHub, GitLab, or any git-accessible URL

Admin Guide: Managing the Marketplace​

Step 1: Navigate to Claude Code Plugins​

In the LiteLLM Admin UI, click on Claude Code Plugins in the left navigation menu.

Step 2: View the Plugins List​

You'll see the list of all registered plugins. From here you can add, enable, disable, or delete plugins.

Step 3: Add a New Plugin​

Click + Add New Plugin to register a plugin in your marketplace.

Step 4: Fill in Plugin Details​

Enter the plugin information:

  • Name: Plugin identifier (kebab-case, e.g., my-plugin)
  • Source Type: Choose GitHub or URL
  • Repository/URL: The git source (e.g., org/repo for GitHub)
  • Version: Semantic version (optional)
  • Description: What the plugin does
  • Category: Plugin category for organization
  • Keywords: Search terms

Step 5: Submit the Plugin​

After filling in the details, click Add Plugin to register it.

Step 6: Enable/Disable Plugins​

Toggle plugins on or off to control what appears in the public marketplace. Only enabled plugins are visible to engineers.

Engineer Guide: Installing Plugins​

Step 1: Add the LiteLLM Marketplace​

Add your company's LiteLLM marketplace to Claude Code:

claude plugin marketplace add http://your-litellm-proxy:4000/claude-code/marketplace.json

Step 2: Browse Available Plugins​

List all available plugins from the marketplace:

claude plugin search @litellm

Step 3: Install a Plugin​

Install any plugin from the marketplace:

claude plugin install my-plugin@litellm

Step 4: Verify Installation​

The plugin is now installed and ready to use:

API Reference​

Public Endpoint (No Auth Required)​

GET /claude-code/marketplace.json​

Returns the marketplace catalog for Claude Code discovery.

curl http://localhost:4000/claude-code/marketplace.json

Response:

{
  "name": "litellm",
  "owner": {
    "name": "LiteLLM",
    "email": "support@litellm.ai"
  },
  "plugins": [
    {
      "name": "my-plugin",
      "source": {
        "source": "github",
        "repo": "org/my-plugin"
      },
      "version": "1.0.0",
      "description": "My awesome plugin",
      "category": "productivity",
      "keywords": ["automation", "tools"]
    }
  ]
}

Admin Endpoints (Auth Required)​

POST /claude-code/plugins​

Register a new plugin.

curl -X POST http://localhost:4000/claude-code/plugins \
  -H "Authorization: Bearer sk-..." \
  -H "Content-Type: application/json" \
  -d '{
    "name": "my-plugin",
    "source": {"source": "github", "repo": "org/my-plugin"},
    "version": "1.0.0",
    "description": "My awesome plugin",
    "category": "productivity",
    "keywords": ["automation", "tools"]
  }'

GET /claude-code/plugins​

List all registered plugins.

curl http://localhost:4000/claude-code/plugins \
  -H "Authorization: Bearer sk-..."

POST /claude-code/plugins/{name}/enable​

Enable a plugin.

curl -X POST http://localhost:4000/claude-code/plugins/my-plugin/enable \
  -H "Authorization: Bearer sk-..."

POST /claude-code/plugins/{name}/disable​

Disable a plugin.

curl -X POST http://localhost:4000/claude-code/plugins/my-plugin/disable \
  -H "Authorization: Bearer sk-..."

DELETE /claude-code/plugins/{name}​

Delete a plugin.

curl -X DELETE http://localhost:4000/claude-code/plugins/my-plugin \
  -H "Authorization: Bearer sk-..."

Plugin Source Formats​

{
  "name": "my-plugin",
  "source": {
    "source": "github",
    "repo": "organization/repository"
  }
}

Example: Setting Up an Internal Plugin Marketplace​

1. Create Internal Plugins​

Structure your plugin repository:

my-company-plugin/
├── plugin.json          # Plugin manifest
├── SKILL.md            # Main skill file
├── skills/             # Additional skills
│   └── helper.md
└── README.md

2. Register Plugins via API​

# Register your internal tools plugin
curl -X POST http://localhost:4000/claude-code/plugins \
  -H "Authorization: Bearer $LITELLM_MASTER_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "internal-tools",
    "source": {"source": "github", "repo": "mycompany/internal-tools"},
    "version": "1.0.0",
    "description": "Internal development tools and utilities",
    "author": {"name": "Platform Team", "email": "platform@mycompany.com"},
    "category": "internal",
    "keywords": ["internal", "tools", "utilities"]
  }'

3. Share with Your Team​

Send engineers the marketplace URL:

# One-time setup for each engineer
claude plugin marketplace add http://litellm.internal.company.com/claude-code/marketplace.json

# Install company plugins
claude plugin install internal-tools@litellm

Troubleshooting​

Plugin not appearing in marketplace:

  • Verify the plugin is enabled in the admin UI
  • Check that the plugin has a valid source field

Installation fails:

  • Ensure the git repository is accessible from the engineer's machine
  • For private repos, engineers need appropriate git credentials configured

Database errors:

  • Verify LiteLLM proxy is connected to the database
  • Check proxy logs for detailed error messages