Skip to main content
skill CX Codex

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

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add arcadeai-labs/smithery-cli --skill smithery-ai-cli -a claude-code
Open on GitHub

What 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-code

2Manually: put the files in place

~/.claude/skills/smithery-ai-cli/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/smithery-ai-cli/

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.

Similar skills

All skills for Agent setup: memory, context, orchestration →

More in the catalog

Project sponsors

Companies that keep this analytics open