# mcp-client

The mcp-client skill links Claude Code to any MCP server and pulls in tool schemas on demand instead of loading them all at once.

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

## What it does

This skill acts as a generic bridge to MCP servers such as Zapier, GitHub, filesystem or Sequential Thinking. Rather than dumping every tool definition into context the moment a server connects, it fetches the schema for a tool only when that tool gets called, which keeps token usage down on servers with many actions.

The underlying script, `mcp_client.py`, exposes three commands: `servers` lists configured connections, `tools <server_name>` prints a server's tool schemas, and `call <server> <tool> '{"arg":"value"}'` runs an actual call. Server details (a URL and key, or a launch command for local servers) live in `mcp-config.json`, and the script picks the transport based on that entry: a `url` paired with `api_key` means Bearer auth, while `command` plus `args` means a local stdio server like Sequential Thinking.

Running it requires the `mcp` and `fastmcp` Python packages, and connecting to Zapier specifically needs an API key, which the skill will ask for if the config doesn't already have one.

## Requirements
- Works with: GitHub, Zapier

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add coleam00/second-brain-skills --skill mcp-client -a claude-code
```

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

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add coleam00/second-brain-skills --skill mcp-client -a codex
```

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

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add coleam00/second-brain-skills --skill mcp-client -a cursor
```

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install coleam00/second-brain-skills .claude/skills/mcp-client
```

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

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add coleam00/second-brain-skills --skill mcp-client -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/coleam00/second-brain-skills --path .claude/skills/mcp-client
```

### Windsurf (Devin Desktop)

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

### 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/coleam00/second-brain-skills/tree/HEAD/.claude/skills/mcp-client/SKILL.md

## When to use it
- reach an external MCP server without flooding context with tool definitions
- list configured MCP servers and their available tools
- call a specific MCP tool with arguments
- set up Zapier access through an API key
- break a task into steps using Sequential Thinking

## Example prompts
- Show me the configured MCP servers
- List the tools on the zapier server
- Call sequentialthinking on the sequential-thinking server with an opening thought about splitting this task into five steps

## Similar
- [workflows-doctor](https://affpapa.org/en/nevibecode/skills/workflows-doctor.md) — skill · 577 installs
- [workflows-list](https://affpapa.org/en/nevibecode/skills/workflows-list.md) — skill · 500 installs
- [build-connector](https://affpapa.org/en/nevibecode/skills/build-connector.md) — skill · 382 installs
- [zapier-workflows](https://affpapa.org/en/nevibecode/skills/zapier-workflows.md) — skill · 129 installs
- [granola-webhooks-events](https://affpapa.org/en/nevibecode/skills/granola-webhooks-events.md) — skill · 1 install
- [gtm-engineering](https://affpapa.org/en/nevibecode/skills/tech-leads-club-gtm-engineering.md) — skill · ★ 7191 repo stars

From the same set: [coleam00/second-brain-skills](https://affpapa.org/en/nevibecode/by/coleam00/second-brain-skills.md) — 33 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
