smithery-ai-cli — Claude Code skill: what it does, how to install
smithery-ai-cli teaches the agent to connect and execute MCP tools through the Smithery CLI. Useful when integrating external services like GitHub or Slack.
AGPL-3.0 1,652 installs ★ 848 updated 2026-05-31
npx skills add arcadeai-labs/smithery-cli --skill smithery-ai-cli -a claude-codeWhat smithery-ai-cli does
The skill instructs agents on managing MCP servers through the Smithery CLI. It covers locating servers and organizing environments inside namespaces. Tool calls follow strict JSON schemas. Sessions run as managed connections with automatic OAuth token refresh.
Access tokens can be restricted using JSON policy constraints. Method filtering relies on the experimental rpcReqMatch setting. Piped shell output switches to JSONL automatically.
The smithery CLI must be installed globally beforehand. Running smithery auth login demands browser approval. Initial setup requires a human in the loop.
What it helps with
- discover and connect remote MCP servers
- execute external service tools using JSON schemas
- restrict agent permissions with scoped token policies
- isolate project environments using namespaces
Example prompts for the agent
- Search for a GitHub MCP server using smithery and list its tools.
- Create a new smithery namespace called my-app-prod and switch to it.
- Generate a scoped smithery service token with read-only policy for one hour.
How to install smithery-ai-cli
1Skills CLI (Vercel)
npx skills add arcadeai-labs/smithery-cli --skill smithery-ai-cli -a claude-code2Manually: put the files in place
~/.claude/skills/smithery-ai-cli/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/smithery-ai-cli/
1Skills CLI (Vercel)
npx skills add arcadeai-labs/smithery-cli --skill smithery-ai-cli -a codex2Manually: put the files in place
.agents/skills/smithery-ai-cli/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add arcadeai-labs/smithery-cli --skill smithery-ai-cli -a cursor2Manually: put the files in place
.cursor/skills/smithery-ai-cli/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install arcadeai-labs/smithery-cli skills/smithery-ai-cli2Manually: put the files in place
.github/skills/smithery-ai-cli/SKILL.md1Skills CLI (Vercel)
npx skills add arcadeai-labs/smithery-cli --skill smithery-ai-cli -a gemini-cli2Platform CLI
gemini skills install https://github.com/arcadeai-labs/smithery-cli --path skills/smithery-ai-cliManually: put the files in place
.devin/skills/smithery-ai-cli/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add arcadeai-labs/smithery-cli --skill smithery-ai-cli -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about smithery-ai-cli
How do I install smithery-ai-cli in Claude Code?
Run npx skills add arcadeai-labs/smithery-cli --skill smithery-ai-cli -a claude-code. The skill file will be placed in ~/.claude/skills/smithery-ai-cli/SKILL.md.
What does the smithery-ai-cli skill do?
It guides the assistant through discovering, authenticating, and running tools from the Smithery registry without manually editing MCP config files.
What should I do if a connection status shows auth_required?
This status indicates that OAuth verification is needed. The user must open the provided authorization URL in a browser to grant access before retrying the call.