Tool List

All tools listed here are also available in Agent on the dashboard.

Documentation

Tool	Description
`documentation.search`	Search SuprSend docs for a topic or example
`documentation.fetch`	Fetch the full content of a documentation page by URI

Users

Tool	Description	API
`users.get`	Get a user’s profile, channel addresses, and properties	Fetch User
`users.upsert`	Create or update a user	Create / Update User
`users.get_preferences`	Get a user’s preferences across categories and channels	Full Preference
`users.update_preferences`	Update a user’s preference for a specific category	Update Category
`users.update_channel_preference`	Update global channel-level restrictions for a user	Update Channel
`users.get_list_subscriptions`	Get all lists a user belongs to	Fetch Subscriptions
`users.get_objects_subscriptions`	Get all objects a user is subscribed to	Fetch Object Subscriptions

Tenants

Tool	Description	API
`tenants.get`	Get a tenant’s configuration, branding, and properties	Get Tenant
`tenants.get_all`	List all tenants in the workspace	List Tenants
`tenants.upsert`	Create or update a tenant	Create / Update Tenant
`tenants.get_preferences`	Get a tenant’s default preferences across all categories	Get Tenant Preferences
`tenants.update_preferences`	Update a tenant’s preference overrides for a category	Update Tenant Preference

Objects

Tool	Description	API
`objects.get`	Get an object’s profile, channels, and subscriber count	Fetch Object
`objects.upsert`	Create or update an object	Create / Update Object
`objects.get_preferences`	Get an object’s preferences across categories and channels	Full Preference
`objects.update_preferences`	Update an object’s preference for a specific category	Update Category
`objects.update_channel_preference`	Update global channel-level restrictions for an object	Update Channel

Workflows

Tool	Description	API
`workflows.list`	List all workflows in the workspace	List Workflows
`workflows.get`	Get a workflow’s configuration, steps, and metadata	Get Workflow
`workflows.create`	Create a new workflow with channels, steps, and routing	Create / Update Workflow
`workflows.update`	Update an existing workflow’s configuration	Create / Update Workflow
`workflows.trigger`	Trigger a workflow for one or more recipients	Trigger Workflow

Scoping tool access

By default, the MCP server exposes all tools. Use --tools to restrict access - useful for production workspaces where you want read-only or limited scope. The flag accepts a comma-separated list of tool identifiers. Use * as a wildcard for all tools in a category.

{
  "mcpServers": {
    "suprsend": {
      "command": "suprsend",
      "args": [
        "start-mcp-server",
        "--tools", "users.get,users.upsert,tenants.*"
      ],
      "env": {
        "SUPRSEND_SERVICE_TOKEN": "your_service_token_here"
      }
    }
  }
}

Pattern	What it allows
`users.*`	All user tools
`users.get`	Only the get user tool
`tenants.,workflows.`	All tenant and workflow tools

MCP Overview

How the MCP server works and what you can do with it.

Prompt Cheatsheet

Copy-paste prompts for common tasks.

Build with AI

MCP

Agent Skills

Agent SDK

Documentation

Users

Tenants

Objects

Workflows

Scoping tool access

MCP Overview

Prompt Cheatsheet

​Documentation

​Users

​Tenants

​Objects

​Workflows

​Scoping tool access

MCP Overview

Prompt Cheatsheet

Documentation

Users

Tenants

Objects

Workflows

Scoping tool access