https://github.com/vessl-ai/mcpctl
mcpctl - mcpctl tool orchestrator
https://github.com/vessl-ai/mcpctl
cli config infrastructure mcp nodejs orchestration secrets typescript
Last synced: 9 months ago
JSON representation
mcpctl - mcpctl tool orchestrator
- Host: GitHub
- URL: https://github.com/vessl-ai/mcpctl
- Owner: vessl-ai
- License: mit
- Created: 2025-04-08T00:59:46.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2025-09-09T01:10:21.000Z (10 months ago)
- Last Synced: 2025-09-10T20:21:33.962Z (10 months ago)
- Topics: cli, config, infrastructure, mcp, nodejs, orchestration, secrets, typescript
- Language: TypeScript
- Homepage: https://mcpctl.dev
- Size: 1.31 MB
- Stars: 39
- Watchers: 4
- Forks: 6
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Contributing: docs/contributing.md
- License: LICENSE
Awesome Lists containing this project
README
# MCPCTL - The MCP Execution Control Tool
[](https://www.npmjs.com/package/@vessl-ai/mcpctl)
[](https://www.npmjs.com/package/@vessl-ai/mcpctl)
[](https://github.com/vessl-ai/mcpctl/releases)
MCPCTL is the CLI for managing Model Context Protocol (MCP) servers, secrets, profiles, and the control plane. Fast, reliable, and built for automation.
## Install
```bash
npm install -g @vessl-ai/mcpctl
# or
yarn global add @vessl-ai/mcpctl
# or
pnpm install -g @vessl-ai/mcpctl
```
## Documentation
- [Core Concepts](docs/core-concepts.md)
- [CLI Reference](docs/cli-reference.md)
- [Architecture](docs/architecture.md)
- [Development Guide](docs/development.md)
- [Installation Guide](docs/installation.md)
- [Contributing Guide](docs/contributing.md)
## Usage
```bash
mcpctl [subcommand] [options]
```
## Commands
### Server Management
```bash
mcpctl server start -f [--profile ]
mcpctl server stop
mcpctl server restart
mcpctl server status
mcpctl server list
mcpctl server remove
```
### Secret Management
```bash
mcpctl secret add --value [--source ]
mcpctl secret get [--source ]
mcpctl secret list [--source ]
mcpctl secret remove [--source ]
```
### Profile Management
```bash
mcpctl profile create [--description ] [--copy-from ]
mcpctl profile delete
mcpctl profile list
mcpctl profile use
mcpctl profile read
mcpctl profile env set [--profile ]
mcpctl profile env get [--profile ]
mcpctl profile env list [--profile ]
mcpctl profile env delete [--profile ]
```
### Toolset Management
```bash
mcpctl toolset save --client [--description ]
# Save the current client config's toolset (servers) as a named toolset file. Optionally add a description.
mcpctl toolset load --client
# Load a saved toolset into the current client config. Prompts to save the current config before loading.
mcpctl toolset list [--client ]
# List all saved toolsets for the given client (or all clients).
```
### Control Plane Management
```bash
mcpctl control-plane start
mcpctl control-plane stop
mcpctl control-plane restart
mcpctl control-plane status
mcpctl control-plane logs
```
### Log Management
```bash
mcpctl log server [--limit ]
mcpctl log control-plane [--limit ]
```
## Configuration
All configuration, profiles, and secrets are stored in `~/.mcpctl` by default.
Set `DEBUG=true` for verbose logging.
## License
MIT License. See [LICENSE](LICENSE) for details.