npm suprsendstdioMITupdated 1mo ago
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 can you do with SuprSend?
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 supportslist,get,pull,push,commitagainst your local working directory. - Sync between workspaces —
suprsend syncpulls assets from one workspace and pushes to another, with an optional local directory as intermediate storage. - Generate typed payload code —
suprsend generate-typesemits 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-serverexposes 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|removestores 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.
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:
-
Ensure you have Go installed on your system (version 1.25 or later — see
go.mod). -
Clone the repository:
git clone https://github.com/suprsend/cli.git cd cli/cmd/suprsend -
Build the binary:
go build -o suprsend -
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.
Install
Add SuprSend to your client. Pick the one you use.
claude mcp add suprsend -- npx -y suprsendcodex mcp add suprsend -- npx -y suprsendamp mcp add suprsend -- npx -y suprsend{
"mcpServers": {
"suprsend": {
"command": "npx",
"args": [
"-y",
"suprsend"
]
}
}
}Add to `claude_desktop_config.json`, then restart Claude Desktop.
{
"mcpServers": {
"suprsend": {
"command": "npx",
"args": [
"-y",
"suprsend"
]
}
}
}Add to `~/.cursor/mcp.json`, or `.cursor/mcp.json` for a single project.
code --add-mcp '{"name":"suprsend","command":"npx","args":["-y","suprsend"]}'Or add the block manually to `.vscode/mcp.json` under `servers`.
{
"mcpServers": {
"suprsend": {
"command": "npx",
"args": [
"-y",
"suprsend"
]
}
}
}Add to `~/.codeium/windsurf/mcp_config.json`.
{
"mcpServers": {
"suprsend": {
"command": "npx",
"args": [
"-y",
"suprsend"
]
}
}
}Add to `cline_mcp_settings.json` via the MCP Servers panel.
{
"mcpServers": {
"suprsend": {
"command": "npx",
"args": [
"-y",
"suprsend"
]
}
}
}Add to `~/.gemini/settings.json`.
{
"mcpServers": {
"suprsend": {
"type": "local",
"command": "npx",
"args": [
"-y",
"suprsend"
],
"tools": [
"*"
]
}
}
}Add to `~/.copilot/mcp-config.json`, or run `/mcp add` inside the CLI.
{
"context_servers": {
"suprsend": {
"command": {
"path": "npx",
"args": [
"-y",
"suprsend"
]
}
}
}
}Add to your Zed `settings.json`.
npx -y suprsendRun `goose configure`, choose **Add Extension → Command-line Extension**, and paste this command.
Score
39 / 100
Incomplete
- Documentation18/25
- Maintenance22/25
- Trust16/20
- Capability0/15
- Install experience12/15
- Documents what it does and how to connect
- Has a resolvable package or endpoint
- Exposes at least one tool, prompt or resource
- README has substantive content
- Includes a code example
- Documents its configuration
- Mentions credentials or security posture
- Last commit 40 days ago
- Has a release history
- Repository is not archived
- Licensed MIT
- Namespace verified in the official MCP registry
- Claimed by its owner
- Published under an organisation
- 0 tool(s) documented
- Provides prompt templates
- Provides resources
- 12 documented install method(s)
- Published to a package registry
- Offers a hosted endpoint — no local install
Version history
| Versions | Published |
|---|---|
| 1.0.1Latest | Jul 10, 2026 |
| 1.0.0 | May 21, 2026 |
| 0.2.24 | Apr 29, 2026 |