
Connects your Claude workflow to Signadot's ephemeral environment platform, letting you spin up isolated sandboxes for testing microservices and route traffic from your local machine into shared Kubernetes clusters. You can create and manage sandboxes, configure routing rules, and introspect running environments without leaving your MCP client. Reach for this when you're developing against a complex service mesh and need to test changes in isolation before merging, or when you want to debug production traffic patterns locally. The CLI wraps Signadot's Go SDK and uses libconnect for the routing mechanics, so you get the full platform API exposed through MCP tools.
This is the source repository for the Signadot command-line interface.
Please see the CLI reference for installation and usage instructions.
To file an issue, please use our community issue tracker.
NOTE: Starting next release, and hence in the main branch, this repository has a dependency on a private repository, and hence building or running from source will not work. Previous releases should continue to work.
To install the CLI, run:
curl -sSLf https://raw.githubusercontent.com/signadot/cli/main/scripts/install.sh | sh
By default, the script will install the latest version at /usr/local/bin/signadot. The target version can be selected by setting the SIGNADOT_CLI_VERSION variable, while you can specify the install directory with SIGNADOT_CLI_PATH.
To build the CLI from source, such as to test changes, you'll need Go 1.27.1+.
The main package is in cmd/signadot:
go build ./cmd/signadot
To release the CLI, you can use the release Github action.
Push a new tag that matches the format v[0-9]+.[0-9]+.[0-9]
and it will push new release artifacts and update brew.
After the GitHub release artifacts are live, publish the MCP server entry
manually. goreleaser does not yet support the fileSha256 integrity field
required by the MCP registry for mcpb packages.
Prerequisites:
mcp-publisherread:org scope
(create one here),
owned by an Owner of the signadot org. Since
registry#1383
the registry grants the io.github.signadot/* namespace only to org Owners,
and the interactive mcp-publisher login github device flow cannot read org
roles — logging in with a PAT is what makes org publishing work../scripts/gen-mcp-server-json.sh <version> # e.g. v1.8.0 — writes server.json
MCP_GITHUB_TOKEN=<pat-with-read:org> mcp-publisher login github
mcp-publisher publish server.json
The script writes the v-prefixed tag (e.g. v1.8.0) as the version in
server.json. Don't hand-edit it to the bare form — the registry treats
1.4.0 and v1.4.0 as distinct versions, and mixing the two has created
duplicate entries in the past.
This covers the official MCP registry only. For getting the MCP server listed in other directories (Claude Desktop extensions, Docker MCP Catalog, and others), see docs/mcp-distribution.md.
The CLI is built on top of the Go SDK.
The CLI is built using libconnect.
SIGNADOT_API_KEY*secretSignadot API Key