Skip to main content
Courier’s MCP is in beta, meaning the API is subject to change as we gather feedback.
LLMs can make mistakes. Always verify values before using output.

​
API Keys

To use Courier MCP, you’ll need an api_key. Generate an API Key for MCP here.

​
Installation

  • Cursor
  • Claude Code
  • Claude Desktop
  • Windsurf
  • VSCode
  • OpenAI API

​
Quick install:

Install MCP Server
Install MCP Server

​
Advanced install:

In Cursor, go to:
  1. Cursor > Cursor Settings > Tools & Integrations > MCP Tools > New MCP Server
  2. Add the following to your mcp.json
{
  "mcpServers": {
    "courier": {
      "url": "https://mcp.courier.com",
      "headers": {
        "api_key": "XXXX"
      }
    }
  }
}
Pro Tip: Courier MCP works best when Agent mode is on.

​
Available Tools

The Courier MCP Server provides access to many Courier APIs and installation guides:
Tool IDDescription
send_message📤 Send a message using title and body (no template)
send_message_template📤 Send a message using a predefined template
send_message_to_list📤 Send a message to a list with Courier using title and body (no template)
send_message_to_list_template📤 Send a message to a list with Courier using a template
get_user_profile_by_id👤 Get a user profile by their ID
create_or_merge_user👤 Create or merge a user profile by user ID
get_user_list_subscriptions👤 Get the list subscriptions for a user by their ID
subscribe_user_to_lists👤 Subscribe a user to one or more lists
delete_user_list_subscriptions👤 Delete all list subscriptions for a user by their ID
list_lists📋 Returns all of the lists, with the ability to filter based on a pattern.
get_list📋 Returns a list based on the list ID provided.
get_list_subscribers📋 Get the list’s subscriptions.
create_list📋 Upsert a list by list ID.
subscribe_user_to_list📋 Subscribe a user to an existing list (creates the list if it does not exist).
unsubscribe_user_from_list📋 Delete a subscription to a list by list ID and user ID.
get_audience👥 Get an audience by its ID
list_audience_members👥 List members of an audience by its ID
list_audiences👥 List all audiences associated with the authorization token
issue_token🔐 Generate a JWT authentication token for Courier
list_user_tokens🔑 List all tokens for a given user
get_user_token🔑 Get a specific token for a given user
create_or_replace_user_token🔑 Create or replace a specific token for a given user
invoke_automation_template⚡ Invoke an automation run from an automation template
create_brand🎨 Create a new brand
get_brand🎨 Fetch a specific brand by brand ID
list_brands🎨 Get the list of brands
list_messages💬 Fetch the statuses of messages you’ve previously sent
get_message💬 Fetch the status of a message you’ve previously sent
get_message_content💬 Fetch the rendered content of a message you’ve previously sent
list_notifications🔔 List notifications with optional filtering
get_notification_content🔔 Get the content of a notification by its ID
get_notification_draft_content🔔 Get the draft content of a notification by its ID
get_environment_config⚙️ Get the current MCP configuration values
courier_installation_guide📚 Installation guides for various Courier SDKs