The Open Model Context Protocol (MCP) Registry, Marketplace & Security Directory
MCPShelf is an open-source, decentralized registry and web marketplace for Model Context Protocol (MCP) servers. Hosted live at mcp.ritualdev.in, it mirrors the official Model Context Protocol registry while providing instant fuzzy search, 1-click install snippets, verified security audit scores, community ratings, and a self-serve creator boosting platform.
- β‘ 419+ Synchronized MCP Servers: Fully synchronized with
registry.modelcontextprotocol.ionightly via automated GitHub Actions. - π‘οΈ Security Audit Scores & Trust Engine: Independent trust ratings (0-10) assessing supply-chain vulnerabilities, permission checks, and sandbox compatibility.
- π±οΈ 1-Click Install Formats: Instant copy-paste JSON configurations for:
- Anthropic Claude Desktop (
claude_desktop_config.json) - Cursor IDE (
~/.cursor/mcp.json) - Windsurf (
~/.codeium/windsurf/mcp_config.json) - Zed Editor (
~/.config/zed/settings.json) - Terminal / CLI (
npx -y ...,uvx ...)
- Anthropic Claude Desktop (
- π Creator Self-Serve Boosting ("LinkedIn / X Promoted Spots"):
- Transparent promoted placements with
rel="sponsored"compliance. - Self-serve checkout powered by Dodo Payments & Stripe (via
@ritualdev-lab/mcp-monetize). - Tiers: Category Spotlight ($19/mo), Homepage Hero ($49/mo), and Enterprise Partner ($99/mo).
- Transparent promoted placements with
- π€ AEO / GEO & AI Search Native: Machine discovery manifests (
/llms.txt,/sitemap.xml,/robots.txt) optimized for AI search engines like Perplexity, ChatGPT, and Claude.
Install the AgentShield security firewall into Claude Desktop:
{
"mcpServers": {
"agentshield": {
"command": "npx",
"args": ["-y", "@ritualdev-lab/agentshield"]
}
}
}Or install DBShield database guardrail into Cursor:
{
"mcpServers": {
"dbshield": {
"command": "npx",
"args": ["-y", "@ritualdev-lab/dbshield"],
"env": {
"DBSHIELD_DIALECT": "sqlite"
}
}
}
}To promote your MCP server to thousands of AI developers building with Claude and Cursor:
| Tier | Price | Placement & Visibility Perks |
|---|---|---|
| π Category Spotlight | $19 / mo | β’ Pinned to top 3 slots in its category β’ Transparent "Promoted" badge β’ 2x search relevance multiplier |
| β‘ Homepage Hero Boost | $49 / mo | β’ Featured in the Homepage Hero Spotlight Grid β’ Highlighted card across all search queries β’ Featured in weekly newsletter to 5,000+ AI developers |
| π‘οΈ Enterprise Verified Partner | $99 / mo | β’ Gold Verification Shield checkmark β’ Dedicated Security Audit report badge β’ Featured in curated Enterprise AI Agent stack |
Visit mcp.ritualdev.in/boost.html to activate instant boosting.
MCPShelf includes an automated webhook fulfillment engine for instant, self-serve boosting upon checkout:
- Webhook Endpoint:
POST https://mcp.ritualdev.in/api/v1/webhooks/dodo - Supported Events:
payment.succeeded: Automatically activates server placement boost indata/sponsors.json.subscription.active/subscription.renewed: Enforces recurring monthly boost visibility.subscription.cancelled/payment.refunded: Deactivates boost immediately upon cancellation.
- Enterprise Security:
- Fail Closed: Strictly rejects unverified webhooks if
DODO_WEBHOOK_SECRETis unset. - Cryptographic HMAC-SHA256: Validates header signatures with constant-time equality checks (
timingSafeEqual). - Replay Attack Protection: Deduplicates events by event ID and rejects stale timestamps (>300s).
- Atomic File Persistence: Updates
data/sponsors.jsonvia atomic rename to eliminate race conditions.
- Fail Closed: Strictly rejects unverified webhooks if
Stay ahead of the Model Context Protocol ecosystem with the curated Weekly AI Agent Digest, delivered every Friday morning to 5,200+ engineers building autonomous agents:
- Web Portal & Newsletter: mcp.ritualdev.in/digest.html
- RSS 2.0 Feed (with 1200x630 preview card enclosures):
https://mcp.ritualdev.in/feed.xml - JSON Feed 1.1 (Agent-ready machine consumable feed):
https://mcp.ritualdev.in/feed.json - Programmatic Feed API:
GET https://mcp.ritualdev.in/api/v1/digest - Subscriber Ingestion API:
POST https://mcp.ritualdev.in/api/v1/subscribe
# Subscribe programmatically to the weekly digest
curl -X POST https://mcp.ritualdev.in/api/v1/subscribe \
-H "Content-Type: application/json" \
-d '{"email": "developer@example.com", "source": "terminal"}'MCPShelf is available directly via npm:
# Launch interactive keyboard-driven terminal explorer (TUI)
npx @ritualdev-lab/mcpshelf explore
# Instant search across all 419+ MCP servers
npx @ritualdev-lab/mcpshelf search <query>
# Generate 1-click install snippets for Claude, Cursor, Windsurf, or Zed
npx @ritualdev-lab/mcpshelf install <server-id> [--client=claude|cursor|windsurf|zed|terminal]
# Run trust & security compliance audit
npx @ritualdev-lab/mcpshelf audit <server-id>You can connect the MCPShelf registry directly into Claude Desktop or Cursor so your AI assistant can discover and install MCP servers on the fly:
{
"mcpServers": {
"mcpshelf": {
"command": "npx",
"args": ["-y", "@ritualdev-lab/mcpshelf-mcp"]
}
}
}pip install mcpshelf
# Search servers via Python CLI
mcpshelf search database
# Run local MCP server over stdio
python -m mcpshelf.serverDevelopers and agent frameworks can programmatically submit MCP servers and developer tools to both MCPShelf and DevShelf using the unified ingestion API or CLI.
# Submit to MCPShelf
npx @ritualdev-lab/mcpshelf submit ./server.json --target=mcpshelf
# Submit to DevShelf
npx @ritualdev-lab/mcpshelf submit ./tool.json --target=devshelfcurl -X POST https://mcp.ritualdev.in/api/v1/submit \
-H "Content-Type: application/json" \
-H "Authorization: Bearer <OPTIONAL_API_KEY>" \
-d '{
"target": "mcpshelf",
"server": {
"id": "io.github.example/my-server",
"name": "My MCP Server",
"description": "Enterprise database and cache proxy",
"category": "databases",
"homepage": "https://example.com",
"packages": [
{ "registry": "npm", "name": "my-mcp-server", "version": "1.0.0" }
],
"remotes": [
{ "type": "git", "url": "https://github.com/example/my-server" }
]
}
}'To route mcp.ritualdev.in to MCPShelf on GitHub Pages:
- Log in to your Cloudflare Dashboard and select domain
ritualdev.in. - Go to DNS > Records > Add Record:
- Type:
CNAME - Name:
mcp - Target:
ritualdev-lab.github.io - Proxy Status: DNS Only (Gray Cloud) or Proxied (Orange Cloud).
- Type:
- If using Proxied (Orange Cloud):
- Ensure SSL/TLS Encryption Mode is set to Full or Full (Strict) to avoid SSL redirect loops with GitHub Pages.
- GitHub Pages is already pre-configured with
mcp.ritualdev.inand SSL certificate approval.
- Node.js >= 20.0.0
- npm / pnpm
# Clone the repository
git clone https://github.com/RitualDev-Lab/MCPShelf.git
cd MCPShelf
# Install dependencies
npm install
# Synchronize latest servers from official MCP registry
npm run sync
# Build static site and SEO manifests
npm run build:site
npm run build:seo
# Run automated integrity test suite
npm test
# Preview locally at http://localhost:3000
npm run devMCPShelf is open-source software licensed under the Apache-2.0 License. Maintained by RitualDev Lab.