SuprSend MCP Server
io.github.suprsend/cli
Manage SuprSend workflows, templates, and workspace resources from your AI assistant.
What this kind of tool is for
- Draft, send, or triage messages and email from inside your agent.
- Pipe notifications from a build or alert into your team channel automatically.
- Summarize a busy channel thread into the handful of points that matter.
How to compare servers like this
- Channel coverage:
- Check the specific app (email, chat, notifications) and whether it reads as well as writes.
- Scope of access:
- Messages are sensitive; review what the tool can see before connecting an account.
- Rate behavior:
- Bulk-sending tools should respect provider limits — avoid anything that floods.
- Maintenance signal:
- APIs in this space change often; recent updates are a strong signal.
This page carries your copy-paste config: pick your MCP client in the install section on this page and use the copy button.
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.
SUPRSEND_SERVICE_TOKENrequiredsecretSuprSend service token. Create one in the SuprSend dashboard under Developers → API Keys.
SUPRSEND_BASE_URLBase API URL. Only set for BYOC / self-hosted SuprSend instances.
SUPRSEND_MGMNT_URLManagement API URL. Only set for BYOC / self-hosted SuprSend instances.
{
"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 workspaceworkflow— List, get, pull, and push workflows in your workspaceschema— List, get, pull, and push event and workflow JSON schemasevent— List, get, pull, and push event definitionscategory— List, get, pull, and push notification categoriestranslation— List, get, pull, and push translations for templates and workflowsworkspace— List, get, pull, and push workspace configurationsync— Pull assets from one workspace and push to another, with optional local directory as intermediate storagegenerate-types— Generate typed payload code in Go, TypeScript, Python, Java, Kotlin, Swift, or Dart from event and workflow JSON schemasprofile— 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
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.
Yes, SuprSend CLI is open-source under the MIT License. You need a SuprSend account and API credentials to use it.
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.
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.).
Yes, `suprsend generate-types` emits typed code in Go, TypeScript, Python, Java, Kotlin, Swift, or Dart from your event and workflow JSON schemas.
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 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.
Related MCP servers
Shared live rooms for AI agents to chat, vote, run OKRs, hand off to humans - join, don't rebuild.

io.github.synapbus/synapbus
MCP-native agent-to-agent messaging hub with channels, DMs, and semantic search

Manto — 馒头新闻
Publish, search, and promote time-sensitive news and messages through a public remote MCP server.

TDA Discord Reader
Discord channel operations for AI agents. Fetch, search, mentions, post. 4 tools.

Find Research Papers
Search open-source research papers across arXiv, OpenAlex, Crossref, PubMed, Semantic Scholar.
GA4 MCP server for AI agents: real-time query exploration, schema discovery, and metric aggregation.
