smithery-ai-cli

The Smithery CLI is a powerful command-line interface designed for developers and AI agent architects to discover, connect, and manage Model Context Protocol (MCP) servers and reusable agent skills. It functions as a gateway to an expansive marketplace containing over 100,000 tools, allowing you to integrate specialized services like GitHub, Slack, Discord, Jira, Notion, and various cloud APIs directly into your AI workflows. By providing a unified interface for tool installation and connection management, Smithery simplifies the setup of complex agent environments.

• Discover and search the expansive Smithery registry for specific MCP servers, tools, or integration skills using intuitive CLI commands.

• Manage connection lifecycles, including OAuth authentication, credential storage, and session maintenance for long-lived MCP sessions.

• Organize resources into isolated namespaces to maintain separate configurations for different development, staging, or production environments.

• Inspect tool capabilities, view JSON schemas for inputs and outputs, and execute tool calls directly from the terminal to test functionality.

• Support for piped JSONL output, enabling seamless integration with other Unix-style command-line utilities for data processing and automation.

• Granular security controls through token scoping, allowing you to define specific policies that limit resource access, operations, and request-level method execution (rpcReqMatch).

• Users should authenticate using smithery auth login to enable access to protected services and cloud-hosted MCP servers.

• Use smithery mcp add with service URLs or registry names to initialize new connections, and smithery tool list to explore available methods.

• When building agent-based automations, utilize the token policy engine to restrict permissions, ensuring that AI agents operate within the principle of least privilege.

• The tool supports Node.js 20+ and requires an internet connection for registry searches and remote MCP server communication.

• Connection status monitoring is essential; if a connection enters an auth_required state, the CLI provides a URL for human-in-the-loop authorization to restore session connectivity.