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@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 skills on the Smithery Skills Registry and install them with the upstream installer:

npx skills add <skill>   # e.g. npx skills add smithery-ai/cli

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
smithery mcp publish <bundle.mcpb> -n <org/server>  # Publish an MCP bundle

Examples

# Search and connect to an MCP server
smithery mcp search "github"
smithery mcp add 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

# Publish a built MCP bundle
smithery mcp publish ./server.mcpb -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.