---
slug: "smithery-cli-arcadeai-labs"
source_type: "readme"
source_url: "https://cdn.jsdelivr.net/gh/arcadeai-labs/smithery-cli@main/README.md"
repo: "https://github.com/arcadeai-labs/smithery-cli"
source_file: "README.md"
branch: "main"
---
# Smithery CLI [![NPM Version](https://img.shields.io/npm/v/smithery)](https://www.npmjs.com/package/smithery) [![NPM Downloads](https://img.shields.io/npm/dt/smithery)](https://www.npmjs.com/package/smithery)

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@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 skills on the [Smithery Skills Registry](https://smithery.ai/skills) and
install them with the upstream installer:

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

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

## Examples

```bash
# 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

```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.