# smithery-ai-cli

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.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 1652 installs · ★ 848 repo stars
- Author: arcadeai-labs
- License: AGPL-3.0 · policy=link-only · description only; the file stays with the author
- Source: https://github.com/arcadeai-labs/smithery-cli/tree/HEAD/skills/smithery-ai-cli/SKILL.md
- Updated: 2026-05-31
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/smithery-ai-cli

## What it 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.

## Requirements
- Works with: GitHub, Jira, Notion

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add arcadeai-labs/smithery-cli --skill smithery-ai-cli -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/smithery-ai-cli/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/smithery-ai-cli/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add arcadeai-labs/smithery-cli --skill smithery-ai-cli -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/smithery-ai-cli/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add arcadeai-labs/smithery-cli --skill smithery-ai-cli -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/smithery-ai-cli/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install arcadeai-labs/smithery-cli skills/smithery-ai-cli
```

2. **Manually: put the files in place**
- File: `.github/skills/smithery-ai-cli/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add arcadeai-labs/smithery-cli --skill smithery-ai-cli -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/arcadeai-labs/smithery-cli --path skills/smithery-ai-cli
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/smithery-ai-cli/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add arcadeai-labs/smithery-cli --skill smithery-ai-cli -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/arcadeai-labs/smithery-cli/tree/HEAD/skills/smithery-ai-cli/SKILL.md

## When to use it
- 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
- 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.

## Similar
- [Smithery](https://affpapa.org/en/nevibecode/mcp/smithery.md) — MCP server · 690 installs
- [composio](https://affpapa.org/en/nevibecode/skills/composio.md) — skill · 9200 installs
- [connect-apps](https://affpapa.org/en/nevibecode/plugins/connect-apps.md) — plugin · ★ 2003 repo stars
- [leanspec](https://affpapa.org/en/nevibecode/skills/leanspec.md) — skill · 1100 installs
- [mcp](https://affpapa.org/en/nevibecode/mcp/waystation-ai-mcp.md) — MCP server · ★ 66 repo stars
- [Lockstep](https://affpapa.org/en/nevibecode/mcp/lockstep.md) — MCP server · ★ 12 repo stars

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
