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

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.