mka1 is the official command-line interface for the MKA1 API.
Every operation you can call through the REST API is available as a command, with flags, stdin piping, multiple output formats, and an interactive command explorer.
Use it to:
- Script one-off API calls and CI jobs without bringing in an SDK.
- Inspect live data quickly — list responses, download files, search a vector store.
- Prototype request bodies before porting them into the TypeScript, C#, or Python SDK.
Install
Pre-built binaries for every supported platform are served from downloads.mka1.com. The*-latest URLs always redirect to the newest release, so you can bookmark them in scripts and CI.
| Platform | Architecture | Download |
|---|---|---|
| macOS | arm64 (Apple silicon) | mka1_darwin_arm64-latest.tar.gz |
| macOS | x86_64 (Intel) | mka1_darwin_x86_64-latest.tar.gz |
| Linux | x86_64 (Debian/Ubuntu) | mka1_linux_x86_64-latest.deb |
| Linux | x86_64 (RHEL/Fedora) | mka1_linux_x86_64-latest.rpm |
| Windows | x86_64 | mka1_windows_x86_64-latest.zip |
macOS
arm64 for x86_64 on Intel Macs.
Linux
Windows
Downloadmka1_windows_x86_64-latest.zip, extract it, and add the folder containing mka1.exe to your PATH.
Verify the install
Print the CLI version to confirm the binary is on yourPATH:
--help, which prints a description, usage, and the flags that apply:
Enable shell completion
Completions are generated on demand and cover subcommands, flags, and known enum values.Run your first request
Authenticate once, then call any endpoint. The quickest path is to set your key in an environment variable and generate a response:Explore interactively
mka1 explore launches a terminal UI that lets you browse every command group, inspect each command’s flags, and execute it without leaving the shell:
Next steps
- Authenticate the CLI — configure credentials and end-user identity.
- Commands — a tour of the command groups with worked examples.
- Pass request bodies — mix individual flags,
--body, and stdin. - Format and filter output — switch between JSON, YAML, table, and TOON, and transform results with jq.
- Debug and inspect — preview requests with
--dry-run, trace them with--debug, and enable agent mode.