How do I install the MCP CLI skill?

Run npx skillmds@latest add tomevault-io/mcp-cli in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is MCP CLI safe to use?

This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with MCP CLI?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is MCP CLI free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published MCP CLI?

tomevault-io (@tomevault-io) published this skill. Their other Agent Skills are listed on their SkillMD profile.

MCP CLI by tomevault-io — Agent Skill

Name: MCP CLI
Author: tomevault-io

File contents

MCP-CLI

Access MCP servers through the command line. MCP enables interaction with external systems like GitHub, filesystems, databases, and APIs.

Commands

Command	Output
`mcp-cli`	List all servers and tools
`mcp-cli info <server>`	Show server tools and parameters
`mcp-cli info <server> <tool>`	Get tool JSON schema
`mcp-cli grep "<pattern>"`	Search tools by name
`mcp-cli call <server> <tool>`	Call tool (reads JSON from stdin if no args)
`mcp-cli call <server> <tool> '<json>'`	Call tool with arguments

Both formats work: <server> <tool> or <server>/<tool>

Workflow

Discover: mcp-cli → see available servers
Explore: mcp-cli info <server> → see tools with parameters
Inspect: mcp-cli info <server> <tool> → get full JSON schema
Execute: mcp-cli call <server> <tool> '<json>' → run with arguments

Examples

# List all servers
mcp-cli

# With descriptions
mcp-cli -d

# See server tools
mcp-cli info filesystem

# Get tool schema (both formats work)
mcp-cli info filesystem read_file
mcp-cli info filesystem/read_file

# Call tool
mcp-cli call filesystem read_file '{"path": "./README.md"}'

# Pipe from stdin (no '-' needed!)
cat args.json | mcp-cli call filesystem read_file

# Search for tools
mcp-cli grep "*file*"

# Extract text from result
mcp-cli call filesystem read_file '{"path": "./file"}' | jq -r '.content[0].text'

Advanced Chaining

# Chain: search files → read first match
mcp-cli call filesystem search_files '{"path": ".", "pattern": "*.md"}' \
  | jq -r '.content[0].text | split("\n")[0]' \
  | xargs -I {} mcp-cli call filesystem read_file '{"path": "{}"}'

# Loop: process multiple files
mcp-cli call filesystem list_directory '{"path": "./src"}' \
  | jq -r '.content[0].text | split("\n")[]' \
  | while read f; do mcp-cli call filesystem read_file "{\"path\": \"$f\"}"; done

# Conditional: check before reading
mcp-cli call filesystem list_directory '{"path": "."}' \
  | jq -e '.content[0].text | contains("README")' \
  && mcp-cli call filesystem read_file '{"path": "./README.md"}'

# Multi-server aggregation
{
  mcp-cli call github search_repositories '{"query": "mcp", "per_page": 3}'
  mcp-cli call filesystem list_directory '{"path": "."}'
} | jq -s '.'

# Save to file
mcp-cli call github get_file_contents '{"owner": "x", "repo": "y", "path": "z"}' \
  | jq -r '.content[0].text' > output.txt

jq tips: -r raw output, -e exit 1 if false, -s slurp multiple inputs

Options

Flag	Purpose
`-d`	Include descriptions
`-c <path>`	Specify config file

Common Errors

Wrong Command	Error	Fix
`mcp-cli server tool`	AMBIGUOUS_COMMAND	Use `call server tool` or `info server tool`
`mcp-cli run server tool`	UNKNOWN_SUBCOMMAND	Use `call` instead of `run`
`mcp-cli list`	UNKNOWN_SUBCOMMAND	Use `info` instead of `list`
`mcp-cli call server`	MISSING_ARGUMENT	Add tool name
`mcp-cli call server tool {bad}`	INVALID_JSON	Use valid JSON with quotes

Exit Codes

0: Success
1: Client error (bad args, missing config)
2: Server error (tool failed)
3: Network error

Converted and distributed by TomeVault — claim your Tome and manage your conversions.

---name: mcp-clidescription: Interface for MCP (Model Context Protocol) servers via CLI. Use when you need to interact with external tools, APIs, or data sources through MCP servers. Use when this capability is needed.---# MCP-CLIAccess MCP servers through the command line. MCP enables interaction with external systems like GitHub, filesystems, databases, and APIs.## Commands| Command | Output || --------------------------------------- | -------------------------------------------- || `mcp-cli` | List all servers and tools || `mcp-cli info <server>` | Show server tools and parameters || `mcp-cli info <server> <tool>` | Get tool JSON schema || `mcp-cli grep "<pattern>"` | Search tools by name || `mcp-cli call <server> <tool>` | Call tool (reads JSON from stdin if no args) || `mcp-cli call <server> <tool> '<json>'` | Call tool with arguments |**Both formats work:** `<server> <tool>` or `<server>/<tool>`## Workflow1. **Discover**: `mcp-cli` → see available servers2. **Explore**: `mcp-cli info <server>` → see tools with parameters3. **Inspect**: `mcp-cli info <server> <tool>` → get full JSON schema4. **Execute**: `mcp-cli call <server> <tool> '<json>'` → run with arguments## Examples```bash# List all serversmcp-cli# With descriptionsmcp-cli -d# See server toolsmcp-cli info filesystem# Get tool schema (both formats work)mcp-cli info filesystem read_filemcp-cli info filesystem/read_file# Call toolmcp-cli call filesystem read_file '{"path": "./README.md"}'# Pipe from stdin (no '-' needed!)cat args.json | mcp-cli call filesystem read_file# Search for toolsmcp-cli grep "*file*"# Extract text from resultmcp-cli call filesystem read_file '{"path": "./file"}' | jq -r '.content[0].text'```## Advanced Chaining```bash# Chain: search files → read first matchmcp-cli call filesystem search_files '{"path": ".", "pattern": "*.md"}' \ | jq -r '.content[0].text | split("\n")[0]' \ | xargs -I {} mcp-cli call filesystem read_file '{"path": "{}"}'# Loop: process multiple filesmcp-cli call filesystem list_directory '{"path": "./src"}' \ | jq -r '.content[0].text | split("\n")[]' \ | while read f; do mcp-cli call filesystem read_file "{\"path\": \"$f\"}"; done# Conditional: check before readingmcp-cli call filesystem list_directory '{"path": "."}' \ | jq -e '.content[0].text | contains("README")' \ && mcp-cli call filesystem read_file '{"path": "./README.md"}'# Multi-server aggregation{ mcp-cli call github search_repositories '{"query": "mcp", "per_page": 3}' mcp-cli call filesystem list_directory '{"path": "."}'} | jq -s '.'# Save to filemcp-cli call github get_file_contents '{"owner": "x", "repo": "y", "path": "z"}' \ | jq -r '.content[0].text' > output.txt```**jq tips:** `-r` raw output, `-e` exit 1 if false, `-s` slurp multiple inputs## Options| Flag | Purpose || ----------- | -------------------- || `-d` | Include descriptions || `-c <path>` | Specify config file |## Common Errors| Wrong Command | Error | Fix || -------------------------------- | ------------------ | -------------------------------------------- || `mcp-cli server tool` | AMBIGUOUS_COMMAND | Use `call server tool` or `info server tool` || `mcp-cli run server tool` | UNKNOWN_SUBCOMMAND | Use `call` instead of `run` || `mcp-cli list` | UNKNOWN_SUBCOMMAND | Use `info` instead of `list` || `mcp-cli call server` | MISSING_ARGUMENT | Add tool name || `mcp-cli call server tool {bad}` | INVALID_JSON | Use valid JSON with quotes |## Exit Codes- `0`: Success- `1`: Client error (bad args, missing config)- `2`: Server error (tool failed)- `3`: Network error---> Converted and distributed by [TomeVault](https://tomevault.io/claim/jmreicha) — claim your Tome and manage your conversions.

Frequently asked questions

MCP CLI