SuprSend MCP server

Q: How do I add SuprSend MCP to Claude Code?

Run `claude mcp add --env 'SUPRSEND_SERVICE_TOKEN= ' cli -- npx -y suprsend` in your terminal. Add `--scope user` to make it available in every project.

Q: How do I add SuprSend MCP to Cursor?

Open `~/.cursor/mcp.json` and add the server under `mcpServers`, using the Cursor config shown in the install section above.

✓ VerifiedCommit Nov 2, 2026

suprsend/cli · go · MIT

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

Also known as suprsend/cli, cli

stdio Workflow Automation

Install GitHub ↗

Stars: 12
Tools: —
Downloads, 30 days: —
Latest version: 1.0.1
Last commit: Nov 2, 2026
License: MIT

What is SuprSend MCP?

SuprSend manages SuprSend workflows, templates, users, and workspace resources directly from your AI assistant.

Summary generated from the project's README

About SuprSend MCP server

Managing SuprSend communication assets like workflows, templates, and schemas is possible directly through an AI assistant. Developers can use this hosted MCP server to interact with workspace resources including events, categories, and translations. It allows for the administration of complex notification logic without leaving the chat interface of clients like Claude or Gemini.

Users connect to the service via a hosted transport, which is compatible with Claude Code and the Gemini CLI. The server provides tools to list, get, pull, push, and commit various resources against a local working directory. It also supports syncing assets between different workspaces by using a local directory as intermediate storage. This setup is ideal for engineers who need to manage multi-environment profiles across public cloud or staging setups while maintaining typed code generation for languages like TypeScript, Python, and Go.

What you can do with it

1Synchronize workspace assetsMove templates and workflows from one workspace to another using a local directory.
2Generate typed codeCreate typed code for your event or workflow JSON Schemas in multiple programming languages.
3Handle multiple environmentsSwitch between different account credentials and base URLs for staging or production.

Written from the project's README. Every use case is checked against a quote from it.

How to install SuprSend MCP

Formats verified 10 Nov 2026Add to Cursor Add to Goose

Claude CodeCursorVS CodeVS Code CLIClaude DesktopCodexCodex config.tomlGemini CLIGemini settings.json

$ claude mcp add --env 'SUPRSEND_SERVICE_TOKEN=<YOUR_SUPRSEND_SERVICE_TOKEN>' cli -- npx -y suprsend

~/.cursor/mcp.json

{
  "mcpServers": {
    "cli": {
      "command": "npx",
      "args": [
        "-y",
        "suprsend"
      ],
      "env": {
        "SUPRSEND_SERVICE_TOKEN": "<YOUR_SUPRSEND_SERVICE_TOKEN>"
      }
    }
  }
}

.vscode/mcp.json

{
  "servers": {
    "cli": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "suprsend"
      ],
      "env": {
        "SUPRSEND_SERVICE_TOKEN": "<YOUR_SUPRSEND_SERVICE_TOKEN>"
      }
    }
  }
}

$ code --add-mcp '{"name":"cli","type":"stdio","command":"npx","args":["-y","suprsend"],"env":{"SUPRSEND_SERVICE_TOKEN":"<YOUR_SUPRSEND_SERVICE_TOKEN>"}}'

claude_desktop_config.json

{
  "mcpServers": {
    "cli": {
      "command": "npx",
      "args": [
        "-y",
        "suprsend"
      ],
      "env": {
        "SUPRSEND_SERVICE_TOKEN": "<YOUR_SUPRSEND_SERVICE_TOKEN>"
      }
    }
  }
}

$ codex mcp add cli --env 'SUPRSEND_SERVICE_TOKEN=<YOUR_SUPRSEND_SERVICE_TOKEN>' -- npx -y suprsend

~/.codex/config.toml

[mcp_servers.cli]
command = "npx"
args = ["-y", "suprsend"]

[mcp_servers.cli.env]
SUPRSEND_SERVICE_TOKEN = "<YOUR_SUPRSEND_SERVICE_TOKEN>"

$ gemini mcp add -s user -e 'SUPRSEND_SERVICE_TOKEN=<YOUR_SUPRSEND_SERVICE_TOKEN>' cli npx -- -y suprsend

~/.gemini/settings.json

{
  "mcpServers": {
    "cli": {
      "command": "npx",
      "args": [
        "-y",
        "suprsend"
      ],
      "env": {
        "SUPRSEND_SERVICE_TOKEN": "<YOUR_SUPRSEND_SERVICE_TOKEN>"
      }
    }
  }
}

Set 3 environment variables before starting the server (below).Setup guides:Claude Code Cursor VS Code Claude Desktop

Configuration

SUPRSEND_SERVICE_TOKENRequiredSecret
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.

Name	Description
SUPRSEND_SERVICE_TOKEN	SuprSend service token. Create one in the SuprSend dashboard under Developers → API Keys.	RequiredSecret
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.

Automated checks

Ran Nov 12, 2026Full report →

100/100

Passed our automated checks. That is not a security audit: read the code and give the server the narrowest access it needs. How checks work

Show this score in your README

Source repository linked and reachablePass
Open source license (OSI)Pass
Commit or release in the last yearPass
Package name not close to a popular packagePass
Remote endpoint uses HTTPSNot checked
Destructive tools are labelledNot checked
No hidden instructions to the modelPass
No critical advisory in the package or its dependenciesPass

README

View on GitHub

SuprSend CLI

SuprSend CLI is a command-line interface tool for interacting with the SuprSend API, written in Go. To connect AI agents (Claude, Cursor, VS Code, Gemini, etc.) to SuprSend, use the hosted SuprSend MCP server instead of the CLI.

What you can do with it

Manage workspace resources — template, workflow, schema, event, category, translation, workspace. Most support list, get, pull, push and commit against your local working directory (event has no commit, category has no get, and workspace only has list).
Sync between workspaces — suprsend sync pulls assets from one workspace and pushes and commits them in another (changes go live in the destination), using a local directory (default ./suprsend) 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.
MCP server (deprecated) — suprsend start-mcp-server still works but is deprecated. Use the hosted MCP server at https://mcp.suprsend.com/mcp (for Claude Code: claude mcp add --transport http suprsend https://mcp.suprsend.com/mcp), or the suprsend/claude-plugin and suprsend/agent-plugin plugins. Gemini CLI: add "suprsend": {"httpUrl": "https://mcp.suprsend.com/mcp"} under mcpServers in ~/.gemini/settings.json, then run /mcp auth suprsend (the Gemini CLI extension is retired). Keep using start-mcp-server only if you need service-token auth or a self-hosted (BYOC) instance.
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.27.3 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. Both are generated from the command definitions, so edit the command help text rather than the generated files.

Run the unit tests (after make build, which creates the embedded binary the packages compile against) with:

go test ./...

Removing local build artifacts

make clean

License

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

Read full README

SuprSend MCP questions

How do I add SuprSend MCP to Claude Code?

Run claude mcp add --env 'SUPRSEND_SERVICE_TOKEN=<YOUR_SUPRSEND_SERVICE_TOKEN>' cli -- npx -y suprsend in your terminal. Add --scope user to make it available in every project.

How do I add SuprSend MCP to Cursor?

Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.

How can I connect AI agents like Claude or Gemini to SuprSend?

You should use the hosted SuprSend MCP server instead of the CLI to connect AI agents.

Can I sync assets between different SuprSend workspaces?

Yes, the sync command pulls assets from one workspace and pushes them to another using a local directory as intermediate storage.

Does the SuprSend CLI support multiple environments?

Yes, it uses profiles to store credentials and base URLs for public cloud, BYOC, staging, and pre-prod environments.

Facts

Nov 14, 2026

Stars: 12
Downloads, 30 days: —
Latest version: 1.0.1
Last commit: Nov 2, 2026
License: MIT
Transport: stdio
Package: suprsend

suprsend ↗

Community publisher

Published by an independent maintainer.

Alternatives

Works with

Claude Code Cursor VS Code Claude Desktop Codex Gemini CLI Windsurf Devin

Badge for your README

Show your HostedMCP checks score. The badge links readers to install instructions for every client.

[![HostedMCP checks](https://api.hostedmcp.org/v1/badge/server/suprsend/cli.svg)](https://hostedmcp.org/servers/suprsend/cli/checks)

Maintainer?

Claim this listing to edit it and add the HostedMCP badge to your README.

Claim listing

Before you install

Servers run with the permissions you give them. Use the narrowest token or database role that does the job.

SuprSend MCP server

✓ VerifiedCommit Nov 2, 2026

suprsend/cli · go · MIT

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

Also known as suprsend/cli, cli

stdio Workflow Automation

Install GitHub ↗

Stars: 12
Tools: —
Downloads, 30 days: —
Latest version: 1.0.1
Last commit: Nov 2, 2026
License: MIT

What is SuprSend MCP?

SuprSend manages SuprSend workflows, templates, users, and workspace resources directly from your AI assistant.

Summary generated from the project's README

About SuprSend MCP server

What you can do with it

1Synchronize workspace assetsMove templates and workflows from one workspace to another using a local directory.
2Generate typed codeCreate typed code for your event or workflow JSON Schemas in multiple programming languages.
3Handle multiple environmentsSwitch between different account credentials and base URLs for staging or production.

Written from the project's README. Every use case is checked against a quote from it.

How to install SuprSend MCP

Formats verified 10 Nov 2026Add to Cursor Add to Goose

Claude CodeCursorVS CodeVS Code CLIClaude DesktopCodexCodex config.tomlGemini CLIGemini settings.json

$ claude mcp add --env 'SUPRSEND_SERVICE_TOKEN=<YOUR_SUPRSEND_SERVICE_TOKEN>' cli -- npx -y suprsend

~/.cursor/mcp.json

{
  "mcpServers": {
    "cli": {
      "command": "npx",
      "args": [
        "-y",
        "suprsend"
      ],
      "env": {
        "SUPRSEND_SERVICE_TOKEN": "<YOUR_SUPRSEND_SERVICE_TOKEN>"
      }
    }
  }
}

.vscode/mcp.json

{
  "servers": {
    "cli": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "suprsend"
      ],
      "env": {
        "SUPRSEND_SERVICE_TOKEN": "<YOUR_SUPRSEND_SERVICE_TOKEN>"
      }
    }
  }
}

$ code --add-mcp '{"name":"cli","type":"stdio","command":"npx","args":["-y","suprsend"],"env":{"SUPRSEND_SERVICE_TOKEN":"<YOUR_SUPRSEND_SERVICE_TOKEN>"}}'

claude_desktop_config.json

{
  "mcpServers": {
    "cli": {
      "command": "npx",
      "args": [
        "-y",
        "suprsend"
      ],
      "env": {
        "SUPRSEND_SERVICE_TOKEN": "<YOUR_SUPRSEND_SERVICE_TOKEN>"
      }
    }
  }
}

$ codex mcp add cli --env 'SUPRSEND_SERVICE_TOKEN=<YOUR_SUPRSEND_SERVICE_TOKEN>' -- npx -y suprsend

~/.codex/config.toml

[mcp_servers.cli]
command = "npx"
args = ["-y", "suprsend"]

[mcp_servers.cli.env]
SUPRSEND_SERVICE_TOKEN = "<YOUR_SUPRSEND_SERVICE_TOKEN>"

$ gemini mcp add -s user -e 'SUPRSEND_SERVICE_TOKEN=<YOUR_SUPRSEND_SERVICE_TOKEN>' cli npx -- -y suprsend

~/.gemini/settings.json

{
  "mcpServers": {
    "cli": {
      "command": "npx",
      "args": [
        "-y",
        "suprsend"
      ],
      "env": {
        "SUPRSEND_SERVICE_TOKEN": "<YOUR_SUPRSEND_SERVICE_TOKEN>"
      }
    }
  }
}

Set 3 environment variables before starting the server (below).Setup guides:Claude Code Cursor VS Code Claude Desktop

Configuration

SUPRSEND_SERVICE_TOKENRequiredSecret
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.

Name	Description
SUPRSEND_SERVICE_TOKEN	SuprSend service token. Create one in the SuprSend dashboard under Developers → API Keys.	RequiredSecret
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.

Automated checks

Ran Nov 12, 2026Full report →

100/100

Passed our automated checks. That is not a security audit: read the code and give the server the narrowest access it needs. How checks work

Show this score in your README

Source repository linked and reachablePass
Open source license (OSI)Pass
Commit or release in the last yearPass
Package name not close to a popular packagePass
Remote endpoint uses HTTPSNot checked
Destructive tools are labelledNot checked
No hidden instructions to the modelPass
No critical advisory in the package or its dependenciesPass

README

View on GitHub

SuprSend CLI

What you can do with it

Manage workspace resources — template, workflow, schema, event, category, translation, workspace. Most support list, get, pull, push and commit against your local working directory (event has no commit, category has no get, and workspace only has list).
Sync between workspaces — suprsend sync pulls assets from one workspace and pushes and commits them in another (changes go live in the destination), using a local directory (default ./suprsend) 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.
MCP server (deprecated) — suprsend start-mcp-server still works but is deprecated. Use the hosted MCP server at https://mcp.suprsend.com/mcp (for Claude Code: claude mcp add --transport http suprsend https://mcp.suprsend.com/mcp), or the suprsend/claude-plugin and suprsend/agent-plugin plugins. Gemini CLI: add "suprsend": {"httpUrl": "https://mcp.suprsend.com/mcp"} under mcpServers in ~/.gemini/settings.json, then run /mcp auth suprsend (the Gemini CLI extension is retired). Keep using start-mcp-server only if you need service-token auth or a self-hosted (BYOC) instance.
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.27.3 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

Run the unit tests (after make build, which creates the embedded binary the packages compile against) with:

go test ./...

Removing local build artifacts

make clean

License

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

Read full README

SuprSend MCP questions

How do I add SuprSend MCP to Claude Code?

Run claude mcp add --env 'SUPRSEND_SERVICE_TOKEN=<YOUR_SUPRSEND_SERVICE_TOKEN>' cli -- npx -y suprsend in your terminal. Add --scope user to make it available in every project.

How do I add SuprSend MCP to Cursor?

Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.

How can I connect AI agents like Claude or Gemini to SuprSend?

You should use the hosted SuprSend MCP server instead of the CLI to connect AI agents.

Can I sync assets between different SuprSend workspaces?

Yes, the sync command pulls assets from one workspace and pushes them to another using a local directory as intermediate storage.

Does the SuprSend CLI support multiple environments?

Yes, it uses profiles to store credentials and base URLs for public cloud, BYOC, staging, and pre-prod environments.

Facts

Nov 14, 2026

Stars: 12
Downloads, 30 days: —
Latest version: 1.0.1
Last commit: Nov 2, 2026
License: MIT
Transport: stdio
Package: suprsend

suprsend ↗

Community publisher

Published by an independent maintainer.

Alternatives

Works with

Claude Code Cursor VS Code Claude Desktop Codex Gemini CLI Windsurf Devin

Badge for your README

Show your HostedMCP checks score. The badge links readers to install instructions for every client.

[![HostedMCP checks](https://api.hostedmcp.org/v1/badge/server/suprsend/cli.svg)](https://hostedmcp.org/servers/suprsend/cli/checks)

Maintainer?

Claim this listing to edit it and add the HostedMCP badge to your README.

Claim listing

Before you install

Servers run with the permissions you give them. Use the narrowest token or database role that does the job.

SuprSend MCP server

What is SuprSend MCP?

About SuprSend MCP server

What you can do with it

How to install SuprSend MCP

Install SuprSend MCP in Claude Code

Install SuprSend MCP in Cursor

Install SuprSend MCP in VS Code

Install SuprSend MCP in VS Code CLI

Install SuprSend MCP in Claude Desktop

Install SuprSend MCP in Codex

Install SuprSend MCP in Codex config.toml

Install SuprSend MCP in Gemini CLI

Install SuprSend MCP in Gemini settings.json

Configuration

Automated checks

README

SuprSend CLI

What you can do with it

Installation

npm / npx

Homebrew

Binary Releases

Building from Source

Usage

Documentation

Contributing

Generating build artifacts locally

Removing local build artifacts

License

SuprSend MCP questions

SuprSend MCP server

What is SuprSend MCP?

About SuprSend MCP server

What you can do with it

How to install SuprSend MCP

Install SuprSend MCP in Claude Code

Install SuprSend MCP in Cursor

Install SuprSend MCP in VS Code

Install SuprSend MCP in VS Code CLI

Install SuprSend MCP in Claude Desktop

Install SuprSend MCP in Codex

Install SuprSend MCP in Codex config.toml

Install SuprSend MCP in Gemini CLI

Install SuprSend MCP in Gemini settings.json

Configuration

Automated checks

README

SuprSend CLI

What you can do with it

Installation

npm / npx

Homebrew

Binary Releases

Building from Source

Usage

Documentation

Contributing

Generating build artifacts locally

Removing local build artifacts

License

SuprSend MCP questions