Skip to main content

​
Available Tools

Here’s a complete list of all tools available in the MCP server. You can use these to query documentation, create or update objects, tenants, users, and preferences.
TOOL TYPETOOL NAMETOOL DESCRIPTION
documentationdocumentation.searchSearch across SuprSend documentation for relevant topics or examples.
documentationdocumentation.fetchRetrieve the full content of a specific documentation page by its URI.
objectsobjects.getFetch details for a specific object by ID or key.
objectsobjects.upsertCreate a new object or update an existing one.
objectsobjects.get_subscriptionsView all subscriptions associated with an object.
objectsobjects.upsert_subscriptionsAdd or update subscriptions for an object.
objectsobjects.get_preferencesRetrieve an object’s preferences, optionally filtered by category.
objectsobjects.update_preferencesUpdate category-level preferences for an object.
tenantstenants.getFetch information about a specific tenant.
tenantstenants.upsertCreate a new tenant or update an existing one.
tenantstenants.get_preferencesRetrieve all category preferences for a tenant.
tenantstenants.update_preferencesUpdate category-level preferences for a tenant.
usersusers.getFetch information about a specific user.
usersusers.upsertCreate a new user or update an existing one.
usersusers.get_preferencesRetrieve a user’s preferences, optionally filtered by category.
usersusers.update_preferencesUpdate category-level preferences for a user.

​
Giving scoped access to tools in your MCP setup

By default, the MCP server exposes all tools, but you might not want to grant your AI agent access to everything—especially in production environments. You can control which tools are available by using the --tools flag when starting the MCP server, ensuring your agent only interacts with the resources it actually needs. The --tools flag accepts one or more tool identifiers in the format tool_type.tool. You can also use a wildcard (*) to enable all tools of a type. For example, users.* will allow access to all user-related tools, while users.get_preferences will expose only that single tool. Here’s an example of how to pass tool configuration: 
{
  "suprsend": {
    "command": "suprsend",
    "args": [
      "start-mcp-server",
      "--tools", "users.createUser,tenants.*"
    ],
    "name": "SuprSend MCP Server"
  }
}