Development
Plugin
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.
Plugin Signal59/100Fair
maintained65
capable23
documented98
adopted62
Install
$ npx -y skills add smithery-ai/cli --agent claude-code
Run the curl in your terminal, the rest in Claude Code.
Stats
815
Stars
95
Forks
Maintained
Maintenance
TypeScript
Language
AGPL-3.0
License
2mo ago
Last commit
1y ago
Created
Repo: smithery-ai/cli
What's inside
Skills
2/smithery-ai-cliFind, connect, and use MCP tools and skills via the Smithery CLI. Use when the user searches for new tools or skills, wants to discover integrations, connect to an MCP, install a skill, or wants to interact with an external service (email, Slack, Discord, GitHub, Jira, Notion,/smithery-homepageBuild and edit the Smithery homepage app -- a TanStack Start + shadcn/ui web app at ~/.smithery/homepage that connects to MCP servers through the Smithery Connect API. Use this skill whenever the user wants to create, modify, or add features to the Smithery homepage, build pages
README
1Smithery 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.
File tree
163smithery-ai/cliView on GitHub
.githooks/
pre-push
.github/
ISSUE_TEMPLATE/
1-bug-report.yaml
2-feature-proposal.yaml
pull_request_template.md
workflows/
build.yml
release-please.yml
.gitignore
.release-please-manifest.json
AGENTS.md
biome.jsonc
build.mjs
CHANGELOG.md
CLAUDE.md
CONTRIBUTING.md
knip.json
LICENSE
package.json
pnpm-lock.yaml
README.md
release-please-config.json
scripts/
postinstall.js
skills/
smithery-ai-cli/
SKILL.md
smithery-homepage/
references/
connect-api.md
SKILL.md
src/
__tests__/
index.test.ts
commands/
__tests__/
add-flow.test.ts
deploy.test.ts
fixtures/
mock-servers.ts
format-connection.test.ts
mcp-add-impl.test.ts
mcp-add-source.test.ts
mcp-add-uplink-bundle.test.ts
mcp-add-uplink.test.ts
mcp-api.test.ts
mcp-list-alias.test.ts
mcp-list.test.ts
mcp-source.test.ts
output-connection.test.ts
run.test.ts
tool-call.test.ts
tools-find.test.ts
tools-get.test.ts
trigger-api.test.ts
trigger.test.ts
uplink-target.test.ts
auth/
token.ts
homepage.ts
mcp/
add-flow.ts
add-impl.ts
add-uplink-bundle.ts
add.ts
api.ts
call.ts
connection-status.ts
deploy.ts
format-connection.ts
get.ts
index.ts
install.ts
list.ts
logs.ts
output-connection.ts
parse-json.ts
remove.ts
search.ts
secrets.ts
source.ts
tool-table.ts
tool.ts
uninstall.ts
update.ts
uplink-target.ts
namespace/
create.ts
index.ts
list.ts
show.ts
use.ts
run/
index.ts
stdio-runner.ts
utils.ts
trigger.ts
config/
agents.ts
clients.ts
command-templates.ts
constants.ts
index.ts
lib/
__tests__/
cli-auth.test.ts
client-config-io/
client-config-io.test.ts
clients.test.ts
fixtures/
client-configs.ts
format-transformations.ts
transformations.test.ts
config-loader.test.ts
e2e.test.ts
errors.test.ts
fixtures/
bundle-commands.ts
mcpb/
convert-mcpb-user-config.test.ts
get-bundle-command.test.ts
hydrate-bundle-command.test.ts
mcpb.test.ts
namespace.test.ts
registry.test.ts
skill-install.test.ts
uplink.test.ts
cli-auth.ts
cli-error.ts
client-config-io.ts
config-loader.ts
deploy-payload.ts
dev-server.ts
errors.ts
keychain.ts
lazy-import.ts
logger.ts
mcpb.ts
namespace.ts
registry.ts
skill-install.ts
smithery-client.ts
uplink.ts
runtime/
shttp-bootstrap.ts
stdio-bootstrap.ts
types/
registry.ts
utils/
__tests__/
cli-utils.test.ts
output.test.ts
qualified-name.test.ts
analytics.ts
cli-utils.ts
client.ts
command-prompts.ts
deeplink.ts
install/
__tests__/
fixtures/
args-nested-config-manifest.json
args-nested-user-config.json
configurations.ts
env-nested-config-manifest.json
env-nested-user-config.json
mixed-nested-config-manifest.json
mixed-nested-user-config.json
servers.ts
format-server-config.test.ts
transport.test.ts
user-config.test.ts
prompt-user-config.ts
transport.ts
user-config.ts
output.ts
process-lifecycle.ts
run/
__tests__/
prepare-stdio-connection.test.ts
prepare-stdio-connection.ts
runtime.ts
smithery-settings.ts
spinner.ts
suppress-punycode-warning.ts
tool-schema-cache.ts
test/
fixtures/
auth-server/
src/
index.ts
http-handler-server/
src/
index.ts
stateful-server/
package.json
src/
index.ts
stateless-server/
package.json
src/
index.ts
tsconfig.json
vitest.config.ts
vitest.setup.tsFAQ
smithery-cli is a Claude Code plugin with 2 hand-picked skills for development work, indexed on Flowy. Install it with the command on its page. It includes smithery-ai-cli, smithery-homepage. Its skills do not fire on their own yet. Request auto-invocation to have Flowy route them as you prompt. Free and open source.
- What is 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.
- How do I install smithery-cli?
- Run these in Claude Code: npx -y skills add smithery-ai/cli --agent claude-code. Then prompt normally.
- Does smithery-cli auto-invoke its skills?
- Not yet. It is indexed on Flowy as a plain plugin. Request auto-invocation on its page and Flowy will route its skills for you as you prompt.
- Is smithery-cli free?
- Yes. Flowy is free and open source, with nothing gated. You can read every skill in full before you install.