Skip to content

Registry Management

The registry is your personal catalog of MCP servers and skills. Add once, use in any project.

Adding MCPs

Register MCP servers from different sources:

crux mcp add filesystem --npx @modelcontextprotocol/server-filesystem
crux mcp add github --npx @modelcontextprotocol/server-github

crux mcp add my-tool --uvx my-mcp-package

crux mcp add wikijs --github jaalbin24/wikijs-mcp-server

GitHub sources are cloned to ~/.crux/mcps/. If the MCP needs a build step:

crux mcp add wikijs --github jaalbin24/wikijs-mcp-server --build-cmd "npm install && npm run build"

crux mcp add my-local-mcp --local /path/to/mcp-server

Adding with Authentication

If the MCP requires API keys, declare them with --keychain:

crux mcp add wikijs --github jaalbin24/wikijs-mcp-server --keychain WIKIJS_API_KEY

This tells Crux that wikijs expects the WIKIJS_API_KEY environment variable. The actual value is stored separately via crux mcp auth.

Adding with Tags

Organize your MCPs with tags:

crux mcp add filesystem --npx @modelcontextprotocol/server-filesystem --tags "core,filesystem"

Adding Skills

crux skill add my-skill --local /path/to/skill
crux skill add shared-skill --github user/skill-repo

Listing the Registry

# List everything
crux mcp list

# JSON output (for scripts)
crux mcp list --json

# Filter by type
crux mcp list --type mcp
crux mcp list --type skill

Searching the Official Registry

Search the official MCP Registry at registry.modelcontextprotocol.io:

crux mcp search github
crux mcp search "file system"
crux mcp search slack --limit 5

Results include suggested crux mcp add commands you can copy-paste.

Upgrading Sources

Update GitHub-cloned MCPs to their latest version:

# Upgrade all cloned sources
crux mcp upgrade

# Upgrade specific MCPs
crux mcp upgrade wikijs github

# Preview without making changes
crux mcp upgrade --dry-run

Removing Entries

crux mcp remove wikijs
crux skill remove my-skill

Warning

Removing an MCP from the registry doesn't remove it from projects that reference it. Run crux project sync in those projects afterward.