{"id":27990909,"url":"https://github.com/vessl-ai/mcpctl","last_synced_at":"2025-10-08T08:50:06.570Z","repository":{"id":289568006,"uuid":"962309259","full_name":"vessl-ai/mcpctl","owner":"vessl-ai","description":"mcpctl - mcpctl tool orchestrator","archived":false,"fork":false,"pushed_at":"2025-09-09T01:10:21.000Z","size":1377,"stargazers_count":39,"open_issues_count":0,"forks_count":6,"subscribers_count":4,"default_branch":"main","last_synced_at":"2025-09-10T20:21:33.962Z","etag":null,"topics":["cli","config","infrastructure","mcp","nodejs","orchestration","secrets","typescript"],"latest_commit_sha":null,"homepage":"https://mcpctl.dev","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/vessl-ai.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"docs/contributing.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-04-08T00:59:46.000Z","updated_at":"2025-09-09T01:10:24.000Z","dependencies_parsed_at":"2025-04-24T00:20:29.930Z","dependency_job_id":"0ce2c55c-6de2-4763-93d2-18f83cf5a97a","html_url":"https://github.com/vessl-ai/mcpctl","commit_stats":null,"previous_names":["vessl-ai/mcpctl"],"tags_count":8,"template":false,"template_full_name":null,"purl":"pkg:github/vessl-ai/mcpctl","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vessl-ai%2Fmcpctl","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vessl-ai%2Fmcpctl/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vessl-ai%2Fmcpctl/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vessl-ai%2Fmcpctl/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/vessl-ai","download_url":"https://codeload.github.com/vessl-ai/mcpctl/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vessl-ai%2Fmcpctl/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":278916437,"owners_count":26068090,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-10-08T02:00:06.501Z","response_time":56,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["cli","config","infrastructure","mcp","nodejs","orchestration","secrets","typescript"],"created_at":"2025-05-08T16:52:13.024Z","updated_at":"2025-10-08T08:50:06.564Z","avatar_url":"https://github.com/vessl-ai.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# MCPCTL - The MCP Execution Control Tool\n\n[![npm version](https://img.shields.io/npm/v/@vessl-ai/mcpctl.svg?style=flat-square)](https://www.npmjs.com/package/@vessl-ai/mcpctl)\n[![npm downloads](https://img.shields.io/npm/dm/@vessl-ai/mcpctl.svg?style=flat-square)](https://www.npmjs.com/package/@vessl-ai/mcpctl)\n[![GitHub release](https://img.shields.io/github/v/release/vessl-ai/mcpctl?style=flat-square)](https://github.com/vessl-ai/mcpctl/releases)\n\nMCPCTL is the CLI for managing Model Context Protocol (MCP) servers, secrets, profiles, and the control plane. Fast, reliable, and built for automation.\n\n## Install\n\n```bash\nnpm install -g @vessl-ai/mcpctl\n# or\nyarn global add @vessl-ai/mcpctl\n# or\npnpm install -g @vessl-ai/mcpctl\n```\n\n## Documentation\n\n- [Core Concepts](docs/core-concepts.md)\n- [CLI Reference](docs/cli-reference.md)\n- [Architecture](docs/architecture.md)\n- [Development Guide](docs/development.md)\n- [Installation Guide](docs/installation.md)\n- [Contributing Guide](docs/contributing.md)\n\n## Usage\n\n```bash\nmcpctl \u003ccommand\u003e [subcommand] [options]\n```\n\n## Commands\n\n### Server Management\n\n```bash\nmcpctl server start -f \u003cspec.json\u003e [--profile \u003cname\u003e]\nmcpctl server stop \u003cserver-name\u003e\nmcpctl server restart \u003cserver-name\u003e\nmcpctl server status \u003cserver-name\u003e\nmcpctl server list\nmcpctl server remove \u003cserver-name\u003e\n```\n\n### Secret Management\n\n```bash\nmcpctl secret add \u003cname\u003e --value \u003cvalue\u003e [--source \u003cvault|keychain|env\u003e]\nmcpctl secret get \u003cname\u003e [--source \u003cvault|keychain|env\u003e]\nmcpctl secret list [--source \u003cvault|keychain|env\u003e]\nmcpctl secret remove \u003cname\u003e [--source \u003cvault|keychain|env\u003e]\n```\n\n### Profile Management\n\n```bash\nmcpctl profile create \u003cname\u003e [--description \u003ctext\u003e] [--copy-from \u003cname\u003e]\nmcpctl profile delete \u003cname\u003e\nmcpctl profile list\nmcpctl profile use \u003cname\u003e\nmcpctl profile read \u003cname\u003e\nmcpctl profile env set \u003ckey\u003e \u003cvalue\u003e [--profile \u003cname\u003e]\nmcpctl profile env get \u003ckey\u003e [--profile \u003cname\u003e]\nmcpctl profile env list [--profile \u003cname\u003e]\nmcpctl profile env delete \u003ckey\u003e [--profile \u003cname\u003e]\n```\n\n### Toolset Management\n\n```bash\nmcpctl toolset save \u003cname\u003e --client \u003cclient\u003e [--description \u003cdesc\u003e]\n# Save the current client config's toolset (servers) as a named toolset file. Optionally add a description.\n\nmcpctl toolset load \u003cname\u003e --client \u003cclient\u003e\n# Load a saved toolset into the current client config. Prompts to save the current config before loading.\n\nmcpctl toolset list [--client \u003cclient\u003e]\n# List all saved toolsets for the given client (or all clients).\n```\n\n### Control Plane Management\n\n```bash\nmcpctl control-plane start\nmcpctl control-plane stop\nmcpctl control-plane restart\nmcpctl control-plane status\nmcpctl control-plane logs\n```\n\n### Log Management\n\n```bash\nmcpctl log server \u003cserver-name\u003e [--limit \u003cnumber\u003e]\nmcpctl log control-plane [--limit \u003cnumber\u003e]\n```\n\n## Configuration\n\nAll configuration, profiles, and secrets are stored in `~/.mcpctl` by default.\nSet `DEBUG=true` for verbose logging.\n\n## License\n\nMIT License. See [LICENSE](LICENSE) for details.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvessl-ai%2Fmcpctl","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fvessl-ai%2Fmcpctl","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvessl-ai%2Fmcpctl/lists"}