cli

# Smithery CLI [](https://www.npmjs.com/package/@smithery/cli) [](https://www.npmjs.com/package/@smithery/cli) 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 ```bash npm install -g @smithery/cli@latest ``` Requires Node.js 20+. ## Commands ### MCP Servers ```bash 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`. ```bash 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](https://smithery.ai/skills). ```bash 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 ```bash 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 ```bash smithery namespace list # List your namespaces smithery namespace use <name> # Set current namespace ``` ### Publishing ```bash smithery mcp publish <url> -n <org/server> # Publish an MCP server URL ``` ## Examples ```bash # 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 ```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.