-
released this
2026-09-18 13:11:17 +02:00 | 0 commits to main since this release[4.0.0] - 2026-09-18
Breaking changes
/mcp listnow shows the all-server overview previously displayed by bare/mcp status./mcp status <server>requires exactly one server name; missing or extra arguments show usage. The existing/mcp <server>shortcut remains available; use/mcp status listfor a server namedlist.
Changed
- Help menus, documentation, and error hints now advertise bare
/mcp installand/mcp uninstallfor usage and examples, without requiring help flags. - The README is organized around installing, using, inspecting, and removing servers, with a command reference, update instructions, and troubleshooting.
Added
/mcp uninstall [options] <name>removes one server configuration using the same local/project/user scopes as install. Other entries and unknown JSON fields are preserved; missing entries and malformed files are left untouched.- Install and uninstall share scope resolution and serialized, atomic configuration writes. Removal requires
/reload-extto take effect and retains OAuth credentials, tool caches, and installed server packages.
Migration
- Replace bare
/mcp statuswith/mcp list; continue using/mcp status <name>for one server. - Remove test or unused server entries with
/mcp uninstall <name>, selecting--scope projector--scope userwhen appropriate, then run/reload-ext. - Already configured servers and OAuth credentials need no migration or reinstall. Only the extension needs updating.
Downloads
Prebuilt binaries for Linux amd64, Linux arm64, and Apple Silicon macOS. Download your archive and
checksums.txt, verify SHA-256 before extracting into a new directory, then runzot ext install /path/to/extracted-directory. macOS binaries are unsigned and not notarized. Archives include the executable, manifest, task-oriented README, changelog, and MIT license.Built locally from tag
v4.0.0(commit823459434945d5258b2193ed5aaa2b859110cd09) with GoReleaser v2.18.2 and Go 1.25.10 after the Forgejo runner failed withguest command transport failed. Existing unit tests, race checks, and vet passed. Archive checksums/manifests and the macOS binary version handshake were verified.Downloads
-
Source code (ZIP)
1 download
-
Source code (TAR.GZ)
1 download
-
released this
2026-09-18 11:08:56 +02:00 | 1 commits to main since this release[3.0.0] - 2026-09-18
Breaking changes
- Removed
/mcp setupand its template commands, including/mcp setup templatesand/mcp setup add. Server installation is now generic:/mcp install [options] <name> <commandOrUrl> [args...]. Supply an executable or URL rather than a preset name. - The install command defaults to
--scope local(<cwd>/.zot/mcp.json). Use--scope projectfor<cwd>/.mcp.jsonor--scope userfor$ZOT_HOME/mcp.json; scopes use zot's existing locations, not Claude's private configuration store.
Added
- Core
claude mcp add-style options:-t/--transport(stdio,http,sse), repeatable-e/--envfor stdio, repeatable-H/--headerfor HTTP/SSE, and-s/--scope.httpmaps to Streamable HTTP;--globaland--projectremain scope aliases. - Quoted values, backslash escapes, empty arguments, and
--forwarding for subprocess arguments. Environment references are saved literally and resolved when configuration loads; installation performs no shell expansion or execution. - Atomic, private configuration writes (mode 0600 on Unix), preserving other server entries and unknown JSON fields, including top-level fields. Duplicate names in the destination file are rejected rather than overwritten.
- Configuration-only installation: no downloads, subprocess launches, or network requests during
/mcp install. Run/reload-extafterward to load the configuration and discover tools.
Command reference
- Bare
/mcpshows help;/mcp statusshows last-known server states, not a live health check. - OAuth installation flags (
--client-id,--client-secret,--callback-port) are not supported. Use/mcp auth <name>after reload for browser authorization, or configure advanced OAuth settings inmcp.json.
Migration
Replace:
/mcp setup add grepwith:
/mcp install --scope user -t http grep https://mcp.grep.app/ /reload-extThe explicit user scope retains the old setup command's global destination. For other former templates, provide the server command or URL explicitly; use
--before executables with flags.Already configured servers need no reinstall. Existing configuration files and OAuth credentials are unchanged by this upgrade. Do not run install again for entries already present in the target file.
Downloads
Prebuilt binaries: Linux amd64, Linux arm64, and Apple Silicon macOS. Download the archive for your platform and
checksums.txt, verify its SHA-256, then extract into a new directory and runzot ext install /path/to/extracted-directory. macOS binaries are unsigned and not notarized. Each archive includes the binary, executable manifest, README, changelog, and MIT license.Artifacts were built locally from tag
v3.0.0(commitdafc722e3f9e90c5d3895199b1ae8d8e558d30af) with GoReleaser v2.18.2 and Go 1.25.10 after the Forgejo runner failed with a guest-command transport error. Unit tests, race tests, vet, archive checksums/manifests, and a macOS binary handshake passed.Downloads
-
Source code (ZIP)
1 download
-
Source code (TAR.GZ)
1 download
- Removed