SuprSend CLI

SuprSend CLI is a command-line interface tool for interacting with the SuprSend API, written in Go. It also doubles as an MCP server so AI agents (Claude, Cursor, Gemini, etc.) can drive your workspace through the same set of operations.

What you can do with it

• Manage workspace resources — template, workflow, schema, event, category, translation, workspace. Each supports list, get, pull, push, commit against your local working directory.

• Sync between workspaces — suprsend sync pulls assets from one workspace and pushes to another, with an optional local directory as intermediate storage.

• Generate typed payload code — suprsend generate-types emits typed code in Go, TypeScript, Python, Java, Kotlin, Swift, or Dart from your event / workflow JSON Schemas.

• Run as an MCP server — suprsend start-mcp-server exposes tools over stdio/SSE/HTTP. Installable directly from the MCP Registry (npx -y suprsend start-mcp-server), or wire it into Claude Code / Cursor / Gemini CLI manually.

• Multi-account / multi-environment profiles — suprsend profile add|modify|list|use|remove stores per-account credentials and base URLs, so the same CLI works against public cloud, BYOC, staging, pre-prod, etc.

Full command reference: docs.suprsend.com/reference/cli-intro. Or run suprsend --help for the command tree.

Related MCP server: OneSignal MCP Server

Installation

npm / npx

Run without installing:

npx suprsend --help

Or install globally:

npm i -g suprsend
suprsend --help

Works on macOS, Linux, and Windows (x64 and arm64). Requires Node.js ≥ 18 (for npx).

Homebrew

You can install SuprSend CLI using Homebrew:

brew tap suprsend/tap
brew install --cask suprsend

Binary Releases

Pre-compiled binaries for various platforms are available on the Releases page.

Building from Source

To build SuprSend CLI from source, follow these steps:

1. Ensure you have Go installed on your system (version 1.25 or later — see go.mod).

2. Clone the repository:

   git clone https://github.com/suprsend/cli.git
   cd cli/cmd/suprsend

3. Build the binary:

   go build -o suprsend

4. The binary will be created in the current directory. You can move it to a location in your PATH for easy access:

   sudo mv suprsend /usr/local/bin/

Now you can use the suprsend command from anywhere in your terminal.

Usage

After installation, you can use the CLI by running the suprsend command. For example:

suprsend --help

Documentation

Please refer to documentation here OR if you want to access the cobra generated docs those are here

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

Generating build artifacts locally

make build compiles the embedded type-morph Deno binary (requires Deno), then generates CLI documentation in docs/ and AI skills in skills/.

make build

A CI check on PRs to main verifies that docs/ and skills/ are up to date. Run make build and commit the output before opening a PR.

Removing local build artifacts

make clean

License

This project is licensed under the MIT License - see the LICENSE file for details.