MCPCTL - The MCP Execution Control Tool

MCPCTL is the CLI for managing Model Context Protocol (MCP) servers, secrets, profiles, and the control plane. Fast, reliable, and built for automation.

Install

npm install -g @vessl-ai/mcpctl
# or
yarn global add @vessl-ai/mcpctl
# or
pnpm install -g @vessl-ai/mcpctl

Documentation

• Core Concepts
• CLI Reference
• Architecture
• Development Guide
• Installation Guide
• Contributing Guide

Usage

mcpctl <command> [subcommand] [options]

Commands

Server Management

mcpctl server start -f <spec.json> [--profile <name>]
mcpctl server stop <server-name>
mcpctl server restart <server-name>
mcpctl server status <server-name>
mcpctl server list
mcpctl server remove <server-name>

Secret Management

mcpctl secret add <name> --value <value> [--source <vault|keychain|env>]
mcpctl secret get <name> [--source <vault|keychain|env>]
mcpctl secret list [--source <vault|keychain|env>]
mcpctl secret remove <name> [--source <vault|keychain|env>]

Profile Management

mcpctl profile create <name> [--description <text>] [--copy-from <name>]
mcpctl profile delete <name>
mcpctl profile list
mcpctl profile use <name>
mcpctl profile read <name>
mcpctl profile env set <key> <value> [--profile <name>]
mcpctl profile env get <key> [--profile <name>]
mcpctl profile env list [--profile <name>]
mcpctl profile env delete <key> [--profile <name>]

Control Plane Management

mcpctl control-plane start
mcpctl control-plane stop
mcpctl control-plane restart
mcpctl control-plane status
mcpctl control-plane logs

Log Management

mcpctl log server <server-name> [--limit <number>]
mcpctl log control-plane [--limit <number>]

Configuration

All configuration, profiles, and secrets are stored in ~/.mcpctl by default. Set DEBUG=true for verbose logging.

License

MIT License. See LICENSE for details.