Smithery CLI  

CLI for discovering, installing, and using MCP servers and skills via Smithery. Connect your agents to thousands of skills and MCP servers from the Smithery registry.

Installation

``bash
npm install -g @smithery/cli@latest
`
Requires Node.js 20+.

Commands

$3

`bash
smithery install # Install a server to an AI client
smithery uninstall # Remove a server
smithery list # List installed servers
smithery search [term] # Search the Smithery registry
smithery inspect # Interactive server testing
smithery run # Run an MCP bundle locally
`

Options: --client to skip client selection, --config to provide configuration.

$3

Browse and install skills from the Smithery Skills Registry.

`bash
smithery skills search [query] # Search skills
smithery skills install --agent # Install a skill
smithery skills upvote # Upvote a skill
smithery skills downvote # Downvote a skill

Reviews


smithery skills review list # List reviews
smithery skills review add --up -b "text" # Add review + vote
smithery skills review remove # Remove your review
smithery skills review upvote # Upvote a review
smithery skills review downvote # Downvote a review
`

$3

Discover public namespaces on Smithery.

`bash
smithery namespace search [query] # Search public namespaces (requires login)
`

Options: --limit , --has-skills, --has-servers.

$3

Manage cloud-hosted MCP servers via Smithery Connect.

`bash


Namespace context (auto-created on first use)

smithery namespace list # List your namespaces
smithery namespace use # Set current namespace
smithery namespace show # Show current namespace

Server connections

smithery connect add # Add MCP server (--name for display name)
smithery connect list # List connected servers
smithery connect remove # Remove a connection

Tools

smithery connect tools [server] # List tools (all or for specific server)
smithery connect search # Fuzzy search tools by intent
smithery connect call [args] # Call a tool (format: server/tool-name)
`

$3

`bash
smithery login # Login with Smithery (OAuth)
smithery dev [entry] # Dev server with hot-reload and tunnel
smithery build [entry] # Build for production
smithery playground # Open interactive testing UI
`

Examples

`bash


Install a server locally

smithery install exa --client cursor

Browse and install skills

smithery skills search "frontend" --json --page 2 # Paginated results
smithery skills search --namespace anthropics --json # Filter by namespace
smithery skills install anthropics/frontend-design --agent claude-code

Review and vote on skills

smithery skills review list anthropics/frontend-design
smithery skills review add anthropics/frontend-design --up -b "Great for Tailwind components, follows accessibility best practices"
smithery skills review upvote anthropics/frontend-design 550e8400-e29b-41d4-a716-446655440000
smithery skills upvote anthropics/frontend-design

Discover namespaces

smithery namespace search --has-skills # Find namespaces with skills

Cloud MCP workflow (works with any MCP server URL)

smithery connect add https://server.smithery.ai/github # Or any MCP server
smithery connect search "create issue"
smithery connect call github/create_issue '{"title":"Bug fix","body":"..."}'

Development

smithery dev server.ts --port 3000
smithery build --out dist/server.cjs
`

Development

`bash
git clone https://github.com/smithery-ai/cli
cd cli && pnpm install && pnpm run build
npx . --help
``

Contributing

Contributions welcome! Please submit a Pull Request.