mcpgawk Platform
We emailed you a license key when your seat was issued. This page walks through installing the CLI, setting the key, and running the paid pillars.
Check your status
Paste your license key to confirm it's active right now — before you touch a terminal.
Installs the CLI, saves your license key, and runs a real smoke test — replaces everything in steps 1-3 below. Your key alone unlocks the download: no GitHub account, no Node toolchain, nothing built on your machine.
curl -sSL https://mcp.gawk.dev/install.sh | bash -s -- your-key-from-our-email
Prefer to see each step, or on a platform the script doesn't cover (Windows)? Do it manually below.
The paid pillars (monitor, enforce) ship separately from the free tools. The installer fetches them as a pre-built, checksum-verified package, gated on your licence key — nothing else to set up. (Lost your key? email us and we'll resend it.)
curl -fsSL https://mcp.gawk.dev/install.sh | sh -s -- your-key-from-our-email
This installs mcpgawk, the one binary — the paid pillars become its subcommands and the free scanner is already there. There is also a GitHub fallback route: if the download is ever unavailable, the installer falls back to the private repo, which needs the read-only collaborator invite from our email accepted first. (If you only want the free scanner on its own, that's the separate, public uv tool install --force mcpgawk — no key needed for that one.)
mcpgawk login your-key-from-our-email
Saves the key to ~/.gawk/config (mode 0600) so you don't need to export it or edit a shell profile yourself. For CI, set GAWK_LICENSE_KEY as a secret instead — env var takes priority over a saved key.
mcpgawk enforce status
The first time you run any paid pillar (enforce, monitor) on a machine, it activates your key — this registers that machine as one of your license's seats (up to 3 per key). After that, it's checked automatically before each run, with a 24-hour local cache so you're not making a network call on every single command.
mcpgawk verify is free and needs no key — sandboxed behavioural verification ships with the open-source scanner. A licence adds the capabilities below.
mcpgawk enforce serve ... — the gateway: one endpoint in front of your MCP fleet, per-principal keys and policy, hash-chained audit
mcpgawk monitor run --config . — continuous drift monitoring
mcpgawk build openapi.json — generate an MCP server from an OpenAPI spec (in development)
Run mcpgawk <pillar> --help for each tool's own full usage — mcpgawk passes your arguments straight through, it doesn't reinterpret them.
GAWK_LICENSE_KEY isn't set, or isn't set in the shell/process actually running the command (common in CI: check it's in the job's env, not just your local shell).| Free | Paid | |
|---|---|---|
mcpgawk scan — local token-cost + capability measurement | ✓ | ✓ |
mcpgawk verify — sandboxed reproduction of findings | ✓ | ✓ |
mcpgawk monitor — continuous drift detection | — | ✓ |
mcpgawk enforce — the gateway: a key per agent, policy per call, a hash-chained audit log | — | ✓ |
mcpgawk build — generate an MCP server from an OpenAPI spec | — | in development |
Nothing about the free scanner changes with a paid license — mcpgawk scan runs the same, locally, nothing uploaded, whether or not GAWK_LICENSE_KEY is set.