Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/davidpastorvicente/mcpx-cli/llms.txt

Use this file to discover all available pages before exploring further.

MCPX is a Node.js CLI tool distributed as an npm package. There are two supported installation paths: installing directly from the GitHub repository (recommended — no local checkout required), or cloning the repository first and linking it globally. Both approaches produce the same mcpx binary on your PATH.

​
Requirements

RequirementMinimum version
Node.js>= 20.0.0
npmBundled with Node.js
Operating systemmacOS, Linux, Windows
MCPX uses ES module syntax and top-level await, which are only available in Node.js 20 and later. If you attempt to run it on an older version you will see a syntax error. Run node --version before installing.
This is the simplest option. npm downloads, builds, and installs MCPX in one step — no local checkout required. The repository defines a prepare script that compiles TypeScript to dist/ during installation.
1

Check your Node.js version

Confirm you are running Node.js 20 or later before proceeding.
node --version
# v20.x.x or higher required
2

Install globally from GitHub

Run the following command. npm fetches the repository, runs the prepare build script, and places mcpx on your PATH.
npm install -g github:davidpastorvicente/mcpx-cli
3

Verify the installation

Confirm the binary is available and check the installed version.
mcpx --version
# 2.0.1

​
Install from a local clone

Use this approach if you want to inspect or modify the source before installing.
1

Clone the repository

git clone https://github.com/davidpastorvicente/mcpx-cli.git
cd mcpx-cli
2

Install dependencies and build

The npm install step also runs the prepare script which compiles TypeScript into dist/. You must do this before linking — the global install needs the compiled output to be present.
npm install
Because npm links the local checkout in this install mode, the dist/ directory must exist before the global link is created. Running npm install triggers the prepare script automatically, so you do not need to run npm run build separately.
3

Link the package globally

npm install -g .
4

Verify the installation

mcpx --version
# 2.0.1

​
Both methods at a glance

node --version          # confirm >= 20
npm install -g github:davidpastorvicente/mcpx-cli
mcpx --version

​
Next steps

Once MCPX is installed, head to the Quickstart to run the interactive wizard and generate your first set of provider configs.

Build docs developers (and LLMs) love

Get started for freeTalk to us