withmcp
Launcher that manages MCP servers and enables selected servers for AI agents.
Tested on Linux
Use it
Linux x86_64
download prebuilt musl binary tarball from GitHub releases v0.1.0
curl -L -o /tmp/withmcp.tar.gz https://github.com/lava/withmcp/releases/download/v0.1.0/withmcp-v0.1.0-x86_64-unknown-linux-musl.tar.gz && mkdir -p ~/.local/bin && tar xzf /tmp/withmcp.tar.gz -C /tmpinstall binary to ~/.local/bin
install -m 755 /tmp/withmcp-v0.1.0-x86_64-unknown-linux-musl/withmcp ~/.local/bin/withmcp
Where the README and reality differ
- README: withmcp docs # reference for agents
What worked: binary 0.1.0 reports 'error: unsupported harness docs' – docs subcommand not present, use --help instead
Check that it works
withmcp --versionThe output should contain “withmcp 0.1.0”.
First thing to try
mkdir -p /tmp/withmcp-test && cat > /tmp/withmcp-test/setup.sh <<'EOS'
export WITHMCP_CONFIG_DIR=/tmp/withmcp-config
mkdir -p $WITHMCP_CONFIG_DIR/profiles
cat > $WITHMCP_CONFIG_DIR/profiles/default.toml <<'TOML'
[servers.linear]
url = "https://mcp.linear.app/mcp"
[servers.github]
url = "https://api.githubcopilot.com/mcp/"
[groups.webdev]
servers = ["github", "playwright"]
[servers.playwright]
command = "npx"
args = ["@playwright/mcp@latest"]
TOML
cat $WITHMCP_CONFIG_DIR/profiles/default.toml
EOS
chmod +x /tmp/withmcp-test/setup.sh
bash /tmp/withmcp-test/setup.sh && echo SETUP_OKWITHMCP_CONFIG_DIR=/tmp/withmcp-config withmcp listRun withmcp list to see the MCP servers in your configuration and whether each is enabled.
What it does
- Manage a system-wide collection of MCP serversTested
How to use it
- Define your servers and groups in
profiles/default.tomlinside the withmcp config directory. - Run
withmcp listto see each server and whether it is enabled.
- Define your servers and groups in
- Turn individual servers or groups on and offTested
How to use it
- Put
+before a group name to enable all its servers, as inwithmcp +webdev which claude.
- Put
- Run a one-off session with a server enabledTested
How to use it
- Put
+and the server name before the command, as inwithmcp +linear which claude.
- Put
How far pickfit got
Linux x86_64
- Installs
- Starts
- 3 of 3 features work
- Works offline
Good for
- launch claude with linear MCP enabled
- permanently enable a configured server
- launch agent with a separate work profile
How pickfit tested it
Each run starts from a clean machine and follows the steps above. How pickfit verifies
Linux x86_64
Its main function works
- Replayed from scratch
- Works offline
- Checked on 1 Nov 2026
- Version 0.1.0
Differences the test machine hit
- README: cargo install --git https://github.com/lava/withmcp
In the test: box has no Rust toolchain; used prebuilt binary withmcp-v0.1.0-x86_64-unknown-linux-musl.tar.gz from GitHub releases