Smithery CLI connects your agents to thousands of skills and MCP servers directly from the command line. To get started, simply run npx skills add smithery/cli.
Installation
npm install -g @smithery/cli@latest
Requires Node.js 20+.
Commands
MCP Servers
smithery mcp search [term] # Search the Smithery registry smithery mcp add <url> # Add an MCP server connection smithery mcp list # List your connections smithery mcp remove <ids...> # Remove connections
Tools
Interact with tools from MCP servers connected via smithery mcp.
smithery tool list [connection] # List tools from your connected MCP servers smithery tool find [query] # Search tools by name or intent smithery tool get <connection> <tool> # Show full details for one tool smithery tool call <connection> <tool> [args] # Call a tool
Skills
Browse and install skills from the Smithery Skills Registry.
smithery skill search [query] # Search skills smithery skill add <skill> --agent <name> # Add a skill smithery skill upvote <skill> # Upvote a skill smithery skill downvote <skill> # Downvote a skill # Reviews smithery skill review list <skill> # List reviews smithery skill review add <skill> --up -b "text" # Add review + vote smithery skill review remove <skill> # Remove your review smithery skill review upvote <skill> <review-id> # Upvote a review smithery skill review downvote <skill> <review-id> # Downvote a review
Auth
smithery auth login # Login with Smithery (OAuth) smithery auth logout # Log out smithery auth whoami # Check current user smithery auth token # Mint a service token smithery auth token --policy '<json>' # Mint a restricted token
Namespaces
smithery namespace list # List your namespaces smithery namespace use <name> # Set current namespace
Publishing
smithery mcp publish <url> -n <org/server> # Publish an MCP server URL
Examples
# Search and connect to an MCP server smithery mcp search "github" smithery mcp add https://server.smithery.ai/github --id github # Find and call tools from your connected MCP servers smithery tool find "create issue" smithery tool call github create_issue '{"title":"Bug fix","body":"..."}' # Browse and install skills smithery skill search "frontend" --json --page 2 smithery skill add anthropics/frontend-design --agent claude-code # Publish your MCP server URL smithery mcp publish "https://my-mcp-server.com" -n myorg/my-server
Development
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.