Skip to content

Repository files navigation

SuprSend agent plugin

The official SuprSend plugin in the open Agent Plugins format, for VS Code, GitHub Copilot, Cursor, ChatGPT and Codex, Kiro, and the other compatible clients. It connects the agent to the hosted SuprSend MCP server and adds a skill that tells the agent how to use it. The agent can then work with your SuprSend account: users and their preferences, tenants, objects, subscriber lists, workflows, templates, events, and delivery data.

For Claude (web, desktop, mobile, Cowork, and Claude Code), use suprsend/claude-plugin.

What you get

Part What it does
MCP server https://mcp.suprsend.com/mcp, hosted by SuprSend: tools for users, objects, tenants, lists, preferences, events, schemas, workflows, templates, translations, messages, and delivery data (read-only SQL). Nothing runs on your computer.
Skill suprsend: when to use which tool, and to read the detailed SuprSend skill (workflow JSON, template content, SQL tables) from the server, directly or with docs.get_skill, before the agent writes one.

You need no API key: you sign in with your SuprSend account (OAuth). Admins get every tool; members get the read-only tools. The agent sees only the workspaces that your account can open.

Install

Client Install Sign-in to SuprSend
VS Code Command Palette → Chat: Install Plugin From Source → https://github.com/suprsend/agent-plugin. The setting chat.plugins.enabled must be on. VS Code asks you to sign in when the server starts.
GitHub Copilot CLI copilot plugin install suprsend/agent-plugin Copilot CLI 1.0.83 or later. It asks you to sign in on first use.
Codex codex plugin marketplace add suprsend/agent-plugin, then install suprsend codex mcp login suprsend
Cursor Dashboard → Plugins & MCPs → Add Marketplace → Import from Repo → https://github.com/suprsend/agent-plugin Not yet. Cursor signs in only with dynamic client registration, which the SuprSend server does not offer yet.
Kiro Powers → Add Custom Power → Import power from GitHub → https://github.com/suprsend/agent-plugin Not yet by default: Kiro uses dynamic client registration.
Other clients Hermes Agent, OpenClaw, Grok Bot, NanoClaw, OpenHands: see the client's plugin docs. Works when the client supports OAuth with Client ID Metadata Documents.

The SuprSend server signs in clients with Client ID Metadata Documents (CIMD). A client that supports only dynamic client registration cannot sign in yet.

Examples

List my SuprSend workspaces.
Why did user u_42 not get the "order-confirmed" email yesterday?
How many emails did we send per day last week, in production?
Opt user u_42 out of the newsletter category and stop SMS for them.
Make the static list beta-testers exactly the users in this CSV.
Create a workflow that sends the "welcome" email when the event USER_SIGNUP comes in.

Limit the scope

To fix one workspace or a set of tools, add the server with a custom URL instead of the plugin's default:

  • https://mcp.suprsend.com/mcp/staging: only the staging workspace.
  • https://mcp.suprsend.com/mcp?tools=users.*,lists.*: only these tool groups.

Support

License

MIT

About

The official SuprSend plugin in the Agent Plugins format (VS Code, GitHub Copilot, Cursor, ChatGPT and Codex, Kiro): the hosted SuprSend MCP server and a skill.

Topics

Resources

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Used by

Contributors

Languages