CLI Reference

Complete command reference for mcpx.

Tool Calling

mcpx <server> <tool> [flags]

Call an MCP tool.

mcpx serena search_symbol --name "Auth"
mcpx serena find_file --file_mask "*.go" --relative_path "."

Flags are auto-generated from the tool's MCP schema. Use --help to see them.

mcpx <server> <tool> --help

Show help for a specific tool, including all flags with types, required status, descriptions, and defaults.

mcpx serena search_symbol --help

mcpx <server> <tool> --stdin

Read tool arguments from stdin as a JSON object. CLI flags are merged on top (flags win on conflict).

echo '{"name": "Auth", "include_body": true}' | mcpx serena find_symbol --stdin

# Merge: stdin provides body, flag overrides name_path
echo '{"body":"..."}' | mcpx serena replace_symbol_body --stdin --name_path Foo

@file syntax

Any string flag accepts @/path to read its value from a file, or @-/- to read from stdin:

mcpx serena replace_symbol_body --body @/tmp/handler.go --name_path HandleAuth
cat handler.go | mcpx serena replace_symbol_body --body @- --name_path HandleAuth

--pick <path>

Extract a value from JSON output without jq. Supports dot-separated paths and array indices.

mcpx serena find_symbol --name_path_pattern "User*" --pick 0.name
# → UserAuth

--timeout <duration>

Override the default call timeout for a single invocation. Uses Go duration format.

mcpx serena search_for_pattern --substring_pattern "TODO" --timeout 60s

mcpx <server> --help

Show all tools available on a server. If the server supports prompts or resources, they are listed too.

mcpx serena --help

---

Server Info

mcpx <server> info

Show server metadata and capabilities: server name, version, protocol version, and a checklist of supported MCP primitives.

mcpx serena info
# serena
#
# Server:   FastMCP 1.23.0
# Protocol: 2025-06-18
#
# Capabilities:
#   [x] Tools
#   [x] Prompts
#   [x] Resources
#   [ ] Logging

mcpx serena info --json

---

Prompts

MCP servers can expose prompt templates that generate structured messages.

mcpx <server> prompt list

List all available prompts.

mcpx everything prompt list

mcpx <server> prompt <name> --help

Show a prompt's arguments with required markers.

mcpx everything prompt args-prompt --help

mcpx <server> prompt <name> [--arg value ...]

Get a prompt with arguments. Required arguments are validated before the request is sent.

mcpx everything prompt simple-prompt
# [user]: This is a simple prompt without arguments.

mcpx everything prompt args-prompt --city "Tokyo"
# [user]: What's weather in Tokyo?

---

Resources

MCP servers can expose resources — static content or dynamic URI templates.

mcpx <server> resource list

List all resources and resource templates.

mcpx everything resource list

mcpx <server> resource read <uri>

Read a resource by URI. Text resources are printed directly; binary resources show [binary: mime, N bytes].

mcpx everything resource read "demo://resource/static/document/architecture.md"

---

Discovery

mcpx list

List all configured servers.

mcpx list
#   serena              uvx (daemon)
#   sequential-thinking npx

mcpx list <server>

List tools for a specific server.

mcpx list serena

mcpx list <server> -v

List tools with all their flags — full discovery in one call.

mcpx list serena -v

mcpx ping <server>

Health check a server. Connects, lists tools, reports latency.

mcpx ping serena
# serena: ok (21 tools, 47ms)

mcpx ping serena --json
# {"server":"serena","status":"ok","tools":21,"ms":47}

Exit code 3 on failure.

---

Configuration

mcpx init

Import servers from .mcp.json (Claude Code format) into .mcpx/config.yml.

mcpx init

mcpx configure

Auto-generate tool documentation for CLAUDE.md from MCP server schemas. Scans configured servers and writes per-server reference files.

mcpx configure
# Scanning MCP servers...
#   → serena: 21 tools found
# Generating documentation...
#   ✓ SERENA.md written (21 tools)
#   ✓ MCPX.md updated

---

Secrets

mcpx secret set <name> <value>

Store a secret in the OS keychain.

mcpx secret set github_token ghp_abc123

mcpx secret list

List stored secret names.

mcpx secret list

mcpx secret remove <name>

Remove a secret. Aliases: rm, delete.

mcpx secret remove github_token

---

Daemon Management

mcpx daemon status

Show running daemons.

mcpx daemon status
#   serena  running  /tmp/mcpx-serena-501.sock

mcpx daemon stop <server>

Stop a specific daemon.

mcpx daemon stop serena

mcpx daemon stop-all

Stop all running daemons.

mcpx daemon stop-all

---

Utility

mcpx version

Print the mcpx version.

mcpx completion <shell>

Generate shell completion script. Supported: bash, zsh, fish, powershell.

---

Global Flags

These flags work with any command:

Flag	Description
--json	Output raw JSON
--quiet	Suppress all output
--dry-run	Show what would execute without running
--pick <path>	Extract a JSON field from output (v1.1)
--timeout <dur>	Per-call timeout override (v1.1)