MCPStack

uv add mcpstack

Using pip:

pip install mcpstack

Install pre-commit hooks

Via UV:

uv run pre-commit install

Via pip:

pre-commit install

> [!NOTE] > MCPStack is the orchestrator — it comes with core utilities and validated tools. > All MCPStack MCP tools are auto-registered via their [project.entry-points."mcpstack.tools"]. > As such, simply add the tool(s) of interest via UV or pip, and it/they will be auto-registered.

🖥️ CLI Workflow

You can manage and run your MCP pipelines directly from the CLI with the mcpstack command. Every command is run with uv run mcpstack (or just mcpstack if installed globally).

Help

Display all available CLI options, from utilities to building your pipeline, run with --help.

Utilities

List all validated tools available in your environment via list-tools and the presets via list-presets. A preset is an already configured pipeline that you can run in one command line rather than building it from scratch. Useful for experiments reproduction.

Your First Pipeline

Create a pipeline from scratch with more than one MCPs in it! pipeline --new/to-pipeline .

MCP Tool Configuration

You can configure yoru MCP tools before adding it to your pipelines. tools configure then pipeline --tool-config ....

Run Pipeline In Claude

As soon as you have built your pipeline, you can run it via many ways. One is within a LLM environment like Claude Desktop. build --pipeline --config-type — Open Claude Desktop now!

Run W/ FastMCP

You can also run your pipeline with FastMCP, allowing you to connect to various LLMs avenues.

Many Other CLIs Options

More options are available, such as search for MCP tools or presets via a prompt query, run with presets, search for MCP tools help commands via tools --help, and more.

⚙️ Programmatic Workflow

For those wanted to integrate MCPStack into their Python workflow, or simply prefer to play with programmatic pathways, MCPStack provides a Python API to build and run pipelines, very similarly; with chaining-based methods for an intuitive and smooth programmatic API exp.

Your First Pipeline

Build your first pipeline programmatically by stacking MCP tools together via with_tool(.) or with_tools(...) methods. Of course, you can configure each tool before adding through with_tool(.).

With Presets

You can also use presets to build your pipeline, which is a pre-configured pipeline that you can run in one line of code rather than stacking with_tool(...) methods. Great for experiments reproduction.

Build, Save, & Run!

Once a pipeline's r eady, you can build, save and run it via many ways. build(.) preps your pipeline, validate & prepare it for running. Save(.) pipeline to a file, and run(.) via FastMCP.

Many Other APIs

More chaining methods are available, such as with_config(...) to configure the whole MNCPStack instance, with_tools(...) which suppresses the need to call with_tool(...) multiple times, etc.

Create Your Tool

You can also create your own MCP tool with the mcpstack-tool-builder CLI, which will generate a skeleton for you to fill in.

That means, creating the actions your MCP tool will allow LLMs to perform, and a CLI to initialise it, configure it, and run it. More in the documentation.

🔐 License

MIT — see [LICENSE](LICENSE).

Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: MCP-Pipeline
• Source: MCP-Pipeline/MCPStack
• License: MIT
• Homepage: https://mcpstack.readthedocs.io/en/latest/

Install and usage instructions live in the source repository linked above.