# mcpc-mcp-client

The mcpc-mcp-client skill guides agents through mcpc for MCP connections, tool calls, saved sessions, OAuth login, and JSON output in shell workflows.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 189 installs · ★ 9 repo stars
- Author: reason-machines
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/reason-machines/mcp-skills/tree/HEAD/skills/mcpc-mcp-client/SKILL.md
- Updated: 2026-10-09
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/mcpc-mcp-client

## What it does

The skill covers `mcpc`, a command-line client for the Model Context Protocol. It shows how to open connections to remote or local MCP servers, keep several named sessions, inspect available tools, resources, and prompts, and manage asynchronous tasks.

It also documents OAuth 2.1 profiles, cross-session search, and the `--json` mode used with `jq`, `xargs`, or shell scripts. Local servers can be referenced through Claude Desktop-style configuration files such as `~/.vscode/mcp.json:filesystem`.

Install the client with npm or Bun, then check it with `mcpc --version`. On a headless Linux setup that uses the keychain, `libsecret-1-0`, `gnome-keyring`, and `dbus-run-session` are required. That dependency matters before testing OAuth flows there.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add reason-machines/mcp-skills --skill mcpc-mcp-client -a claude-code
```

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

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add reason-machines/mcp-skills --skill mcpc-mcp-client -a codex
```

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

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add reason-machines/mcp-skills --skill mcpc-mcp-client -a cursor
```

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install reason-machines/mcp-skills skills/mcpc-mcp-client
```

2. **Manually: put the files in place**
- File: `.github/skills/mcpc-mcp-client/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add reason-machines/mcp-skills --skill mcpc-mcp-client -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/reason-machines/mcp-skills --path skills/mcpc-mcp-client
```

### Windsurf (Devin Desktop)

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

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add reason-machines/mcp-skills --skill mcpc-mcp-client -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/reason-machines/mcp-skills/tree/HEAD/skills/mcpc-mcp-client/SKILL.md

## When to use it
- connect a local MCP server from a config file
- keep multiple MCP connections in named sessions
- search for tools across active sessions
- call an MCP tool from a shell pipeline
- read tool results as JSON

## Example prompts
- Connect to `mcp.apify.com` as `@apify` with `mcpc connect mcp.apify.com @apify`.
- Search the `@apify` session for web-scraping tools with `mcpc @apify grep "web scraping"`.
- Call `search-actors` for `crawler` and pipe its JSON response into `jq`.

## Similar
- [mcpc](https://affpapa.org/en/nevibecode/skills/mcpc.md) — skill · 986 installs
- [shellscript-coder](https://affpapa.org/en/nevibecode/skills/shellscript-coder.md) — skill · ★ 869 repo stars
- [gws-shared](https://affpapa.org/en/nevibecode/skills/gws-shared.md) — skill · 69100 installs
- [client-smoke](https://affpapa.org/en/nevibecode/skills/client-smoke.md) — skill · ★ 92149 repo stars
- [dx-org-trial-expiration-check](https://affpapa.org/en/nevibecode/skills/dx-org-trial-expiration-check.md) — skill · 3300 installs
- [sui-client](https://affpapa.org/en/nevibecode/skills/sui-client.md) — skill · 403 installs

From the same set: [reason-machines/mcp-skills](https://affpapa.org/en/nevibecode/by/reason-machines/mcp-skills.md) — 98 cards

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