Plugged.in Registry Features

The Plugged.in Registry is a comprehensive system for discovering, sharing, and managing Model Context Protocol (MCP) servers. It provides a unified platform for the MCP ecosystem.

Overview

The registry consists of three main components:

Official Registry

registry.plugged.inCurated and verified MCP servers with GitHub ownership verification

Community Servers

User-submitted servers pending verification with quick sharing capabilities

Local Servers

Private servers for individual use with full customization

Key Features

1. Add Server to Registry

Submit your MCP server to the official registry for global discovery.

Navigate

Go to MCP Servers → Add to Registry

Enter Repository

Enter your GitHub repository URL

Auto-Detection

System automatically detects:

Package type (npm, docker, pypi)
Environment variables
Available transports (STDIO, SSE, Streamable HTTP)

Review

Review and confirm details

Submit

Submit for registry publication

Requirements:

GitHub repository ownership
Valid package.json/Dockerfile/setup.py
Connected GitHub account

2. Community Servers

Share servers with the community before official registry approval. Features:

Quick sharing without verification
Public discovery through search
Can be claimed by repository owners
Automatic migration to registry upon claiming

Process:

Navigate to Search → Add to Community
Fill in server details
Submit for immediate availability

3. Server Claiming

Claim ownership of community servers and publish to official registry.

Process
Benefits

Find your server in community listings
Click “Claim This Server”
Verify GitHub ownership
Server is automatically:
- Published to official registry
- Statistics migrated
- Removed from community

4. Enhanced Search

Search Features

Multi-source search: Registry, Community, or All
Package filters: npm, docker, pypi
Repository filters: GitHub, GitLab, etc.
Sort options: Relevance, Recent, Popular
Real-time results: Instant filtering
Rich metadata: Ratings, installations, descriptions

Search Interface

[Search Box] [Source Dropdown] [Filters]
- Package Registry: npm/docker/pypi
- Repository Source: github.com/gitlab.com
- Sort: relevance/recent

5. Server Statistics

Tracked Metrics:

Installation count
Average rating (1-5 stars)
Number of ratings
Activity logs
Trending status

Statistics automatically migrate when:

Community server is claimed
Server moves between sources
Duplicate servers are consolidated

API Endpoints

Public Search API

GET /api/search

Query the registry without authentication. Parameters:

q - Search query
source - Filter by source (registry/community/all)
package - Filter by package type
repository - Filter by repository source
sort - Sort results (relevance/recent)
limit - Results per page
offset - Pagination offset

Example:

curl "https://plugged.in/api/search?q=database&source=registry&package=npm"

Add to Registry API

POST /api/registry/submit

Submit a server to the registry (requires authentication). Body:

{
  "repository": "https://github.com/username/repo",
  "transport": ["stdio", "sse"],
  "package_type": "npm",
  "environment_variables": ["API_KEY", "DATABASE_URL"]
}

Server Statistics API

GET /api/servers/{uuid}/stats

Get detailed statistics for a specific server. Response:

{
  "installations": 1250,
  "rating": 4.5,
  "ratings_count": 28,
  "trending_rank": 3,
  "last_activity": "2024-01-15T10:30:00Z"
}

Database Schema

Registry Servers Table

CREATE TABLE registry_servers (
    uuid UUID PRIMARY KEY,
    slug TEXT UNIQUE NOT NULL,
    repository_url TEXT NOT NULL,
    package_type TEXT,
    transports TEXT[],
    environment_variables TEXT[],
    claimed_by_user_id UUID,
    is_verified BOOLEAN DEFAULT false,
    installation_count INTEGER DEFAULT 0,
    rating_sum INTEGER DEFAULT 0,
    rating_count INTEGER DEFAULT 0,
    created_at TIMESTAMP DEFAULT NOW(),
    updated_at TIMESTAMP DEFAULT NOW()
);

Community Servers Table

CREATE TABLE community_servers (
    uuid UUID PRIMARY KEY,
    title TEXT NOT NULL,
    description TEXT,
    repository_url TEXT,
    submitted_by_user_id UUID NOT NULL,
    can_be_claimed BOOLEAN DEFAULT true,
    installation_count INTEGER DEFAULT 0,
    created_at TIMESTAMP DEFAULT NOW()
);

Implementation Details

GitHub Verification

The system verifies GitHub ownership through:

OAuth token validation
Repository access check
Collaborator status verification
Organization membership check

Auto-Detection Logic

// Detects npm, docker, or pypi packages
function detectPackageType(repoFiles) {
  if (repoFiles.includes('package.json')) return 'npm';
  if (repoFiles.includes('Dockerfile')) return 'docker';
  if (repoFiles.includes('setup.py')) return 'pypi';
  return 'unknown';
}

// Detects available MCP transports
function detectTransports(packageJson) {
  const transports = [];
  if (packageJson.mcp?.stdio) transports.push('stdio');
  if (packageJson.mcp?.sse) transports.push('sse');
  if (packageJson.mcp?.http) transports.push('http');
  return transports;
}

Statistics Migration

When a server is claimed:

Copy installation_count from community to registry
Migrate user ratings and reviews
Transfer activity logs
Update trending calculations
Remove from community table

Best Practices

For Server Authors

Prepare Repository

Ensure clear README documentation
Add MCP configuration to package.json
Include example usage

Test Locally

Verify server works with MCP clients
Test all advertised features
Check environment variable handling

Submit to Registry

Use the Smart Server Wizard
Provide accurate metadata
Include helpful descriptions

Maintain

Respond to user feedback
Keep dependencies updated
Monitor usage statistics

For Users

Search effectively: Use filters to find specific server types
Check ratings: Review community feedback before installing
Report issues: Help improve servers by reporting problems
Rate servers: Provide feedback to help others

Troubleshooting

Common Issues:

GitHub verification fails: Ensure you’re logged in with the correct account
Auto-detection misses features: Check package.json MCP configuration
Statistics not updating: May take up to 5 minutes to reflect changes

Future Enhancements

Automated testing of submitted servers
Enhanced verification badges
Server categories and tags
Advanced analytics dashboard
API rate limiting tiers

​Plugged.in Registry Features

​Overview

Official Registry

Community Servers

Local Servers

​Key Features

​1. Add Server to Registry

​2. Community Servers

​3. Server Claiming

​4. Enhanced Search

​5. Server Statistics

​API Endpoints

​Public Search API

​Add to Registry API

​Server Statistics API

​Database Schema

​Registry Servers Table

​Community Servers Table

​Implementation Details

​GitHub Verification

​Auto-Detection Logic

​Statistics Migration

​Best Practices

​For Server Authors

​For Users

​Troubleshooting

​Future Enhancements

​Related Documentation

Plugged.in Registry Features

Overview

Key Features

1. Add Server to Registry

2. Community Servers

3. Server Claiming

4. Enhanced Search

5. Server Statistics

API Endpoints

Public Search API

Add to Registry API

Server Statistics API

Database Schema

Registry Servers Table

Community Servers Table

Implementation Details

GitHub Verification

Auto-Detection Logic

Statistics Migration

Best Practices

For Server Authors

For Users

Troubleshooting

Future Enhancements

Related Documentation