MCP Server

Active

MIT

SuprSend MCP Server

io.github.suprsend/cli

Manage SuprSend workflows, templates, and workspace resources from your AI assistant.

What is the SuprSend MCP server?

The SuprSend CLI MCP server is a command-line interface tool for interacting with the SuprSend API that also functions as an MCP server, allowing AI agents like Claude and Cursor to manage workspace resources. It enables operations on templates, workflows, schemas, events, categories, translations, and workspaces, as well as syncing between environments and generating typed payload code.

SuprSend CLI lets you manage your SuprSend workspace—templates, workflows, users, objects, and tenants—directly from your AI assistant. You can list, get, pull, and push resources; sync assets between workspaces; generate typed code in multiple languages from JSON schemas; and run multi-account profiles for different environments. It's useful for automating workspace management, CI/CD integration, and letting Claude or Cursor handle SuprSend operations programmatically.

How to install SuprSend

Copy-paste configuration for popular MCP clients.

transport: stdio

Config generated by PluginBench — verify against the source before use.

Environment / auth

SUPRSEND_SERVICE_TOKEN
required
secret
SuprSend service token. Create one in the SuprSend dashboard under Developers → API Keys.
SUPRSEND_BASE_URL
Base API URL. Only set for BYOC / self-hosted SuprSend instances.
SUPRSEND_MGMNT_URL
Management API URL. Only set for BYOC / self-hosted SuprSend instances.

~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "cli": {
      "command": "npx",
      "args": [
        "-y",
        "suprsend",
        "start-mcp-server",
        "--workflows",
        "all"
      ],
      "env": {
        "SUPRSEND_SERVICE_TOKEN": "<YOUR_SUPRSEND_SERVICE_TOKEN>",
        "SUPRSEND_BASE_URL": "<YOUR_SUPRSEND_BASE_URL>",
        "SUPRSEND_MGMNT_URL": "<YOUR_SUPRSEND_MGMNT_URL>"
      }
    }
  }
}

Tools & capabilities

Tools this server exposes to the agent.

template — List, get, pull, and push notification templates in your workspace
workflow — List, get, pull, and push workflows in your workspace
schema — List, get, pull, and push event and workflow JSON schemas
event — List, get, pull, and push event definitions
category — List, get, pull, and push notification categories
translation — List, get, pull, and push translations for templates and workflows
workspace — List, get, pull, and push workspace configuration
sync — Pull assets from one workspace and push to another, with optional local directory as intermediate storage
generate-types — Generate typed payload code in Go, TypeScript, Python, Java, Kotlin, Swift, or Dart from event and workflow JSON schemas
profile — Manage multi-account and multi-environment profiles for different SuprSend instances

Use cases

Automate notification template and workflow management across multiple SuprSend workspaces
Generate type-safe code in your preferred language from SuprSend event schemas for client integration
Sync notification assets between staging, pre-production, and production environments
Manage SuprSend resources (templates, workflows, events) directly from Claude or Cursor without leaving your editor
Set up CI/CD pipelines to version-control and deploy SuprSend configurations

SuprSend MCP server FAQ

What is the SuprSend CLI MCP server?

It's a command-line tool and MCP server that lets you manage SuprSend workspace resources—templates, workflows, events, schemas, and more—from your AI assistant or terminal. You can list, pull, push, and sync resources across environments.

Is it free?

Yes, SuprSend CLI is open-source under the MIT License. You need a SuprSend account and API credentials to use it.

How do I install it in Cursor or Claude?

Install via npm (`npm i -g suprsend`), Homebrew (`brew install --cask suprsend`), or download a pre-compiled binary. Then run `suprsend start-mcp-server` or use `npx -y suprsend start-mcp-server` directly. Add it to your MCP configuration in Cursor or Claude.

What authentication is required?

You need SuprSend API credentials (workspace key and secret). Store them in a profile using `suprsend profile add`, which supports multiple accounts and environments (public cloud, BYOC, staging, etc.).

Can I generate code from my schemas?

Yes, `suprsend generate-types` emits typed code in Go, TypeScript, Python, Java, Kotlin, Swift, or Dart from your event and workflow JSON schemas.

Can I sync between workspaces?

Yes, `suprsend sync` pulls assets from one workspace and pushes to another, optionally using a local directory as intermediate storage for version control and review.

README (reference)

Source of truth, from the repository.

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.

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.

Related MCP servers

Find Research Papers

Active

Search open-source research papers across arXiv, OpenAlex, Crossref, PubMed, Semantic Scholar.

Python

MIT

View repository →

io.github.surendranb/google-analytics-mcp

Active

GA4 MCP server for AI agents: real-time query exploration, schema discovery, and metric aggregation.

235

Python

MIT

View repository →

ionluz — solar quotes (Brazil)

Active

Solar quotes for Brazilian installers: kWp sizing, own pricing, payback under Law 14.300, PDF.

View repository →

CAPI Gateway

Active

Lightweight API Gateway with REST-to-MCP bridging for LLM agents via Apache Camel and Consul service discovery.

Java

Apache-2.0

View repository →

io.github.surp-renz/sekichi

Knowledge accumulation for AI coding agents. Records decisions, problems, and insights as context.

View repository →

Agent Almanac MCP

Maintained

Search the Agent Almanac catalog of 9,000+ MCP servers from inside any MCP-aware agent.

JavaScript

MIT

View repository →