mcpx

name	mcpx
description	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.

mcpx

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

Commands

Command	Output
mcpx	Show help
mcpx list	List all registry servers
mcpx <server>	Show tools with parameters
mcpx <server>/<tool>	Get tool JSON schema
mcpx <server>/<tool> '<json>'	Call tool with arguments
mcpx daemon start|stop	Manage persistent connections (for stateful servers)

Add -d to include descriptions (e.g., mcpx filesystem -d)

Workflow

1. Discover: mcpx list → see available servers
2. Explore: mcpx <server> → see tools with parameters
3. Inspect: mcpx <server>/<tool> → get full JSON input schema
4. Execute: mcpx <server>/<tool> '<json>' → run with arguments

Examples

# List all registry servers
mcpx list

# Inspect registry metadata before overriding a server
mcpx registry get filesystem

# See all tools with parameters
mcpx time

# With descriptions (more verbose)
mcpx list -d

# Get JSON schema for specific tool
mcpx time/get_current_time

# JSON output for parsing
mcpx filesystem/read_file '{"path":"./README.md"}' --json

# Complex JSON with quotes (use '-' for stdin input)
mcpx server/tool - <<EOF
{"content": "Text with 'quotes' inside"}
EOF

# Or pipe from a file/command
cat args.json | mcpx server/tool -

# Complex Command chaining with xargs and jq
mcpx filesystem/search_files '{"path": "src/", "pattern": "*.ts"}' --json | jq -r '.content[0].text' | head -1 | xargs -I {} sh -c 'mcpx filesystem/read_file "{\"path\": \"{}\"}"'

Options

Flag	Purpose
-j, --json	JSON output for scripting
-d	Include descriptions

Exit Codes

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