How to Use the Courier MCP in Claude Code

Q: How do I connect my Courier account to Claude Code?

Run claude mcp add --transport http courier -- in your terminal. Claude Code adds the server to your /.claude.json config file, and the tools are available immediately.

Q: How do I check the delivery status of a Courier message using Claude Code?

Use the getmessagehistory tool with the message ID. You can pipe the JSON output to jq to extract the specific event you're looking for, like 'DELIVERED'.

Q: Can I get a list of all my users in Courier via the command line?

Yes, the listusers tool will output a JSON array of all users in your workspace. You can pipe this to other commands for filtering or processing.

Run your Courier operations from the command line. Let Claude Code send notifications, check delivery logs, and manage users in your shell scripts.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Courier MCP to Claude Code

Create your Vinkius account to connect Courier to Claude Code and route execution through our secure gateway. The platform manages server hosting, runtime updates, and security layers. Configuration requires no manual server provisioning.

GDPR Free for Subscribers

Setup Courier with Claude Code

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Automate Notifications in CI/CD

Add a step to your deployment script that notifies your team on Slack. Just tell Claude Code to use the `send_notification` tool with the right template. It runs headlessly, making it a perfect fit for any pipeline. After a deployment, you can have a follow-up job that verifies critical notifications were delivered. A simple script can call `get_message_history` for the deployment message ID and fail the build if it doesn't see a `DELIVERED` event.

Pipe Courier Data to Other Tools

This MCP Server turns your Courier account into a command-line utility. You can pipe the output of `list_messages` directly into `jq` to parse the JSON or `grep` to find a specific recipient. It's just standard streams. Need a quick report on who's subscribed to a list? Run `list_subscription_lists` to get an ID, then pipe it into a script that calls `get_user_profile` for each member. You can build powerful shell one-liners without writing any real code.

Build Custom Monitoring Scripts

Set up a cron job that runs every five minutes to check on your system. You can have Claude Code use `list_messages` with a filter to look for any messages that have failed to send in the last few minutes. If it finds anything, it can immediately use `send_notification` to alert an on-call engineer via PagerDuty or SMS. This lets you build a simple, effective monitoring system for your notification infrastructure using basic shell scripting.

Setup guide

Set up Courier MCP in Claude Code

Prerequisites

Claude Code CLI installed (npm install -g @anthropic-ai/claude-code)
Active Vinkius subscription with a valid endpoint token

1

Run the add command

Open your terminal and run the command shown on the right. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com. Use --scope user to make it available across all projects.
2

Verify the connection

Start a Claude Code session and type /mcp to list connected servers. You should see courier-mcp with a green status indicator.
3

Start using tools

Ask Claude Code something like "Check my latest Courier transactions." It will automatically discover and invoke the available Courier tools.

Terminal

claude mcp add --transport http courier-mcp https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp

Get your connection token →

Prerequisites

Claude Code CLI installed
Active Vinkius subscription with a valid endpoint token

1

Open the config file

Create or edit .mcp.json in your project root for project-level scope, or ~/.claude.json for user-level scope.
2

Add the Courier MCP

Paste the JSON snippet shown on the right into the mcpServers object. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Restart Claude Code

Start a new Claude Code session. Type /mcp to confirm the server is connected. The tools will be automatically available in your conversation.

.mcp.json

{
  "mcpServers": {
    "courier-mcp": {
      "type": "url",
      "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    }
  }
}

Get your connection token →

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Courier. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect Courier now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about Courier MCP in Claude Code

Run `claude mcp add --transport http courier -- ` in your terminal. Claude Code adds the server to your `~/.claude.json` config file, and the tools are available immediately.

Yes, that's a primary use case. Since Claude Code is a CLI, you can install it in your workflow YAML, configure the MCP Server, and use `send_notification` as a step in your job.

Use the `get_message_history` tool with the message ID. You can pipe the JSON output to `jq` to extract the specific event you're looking for, like `'DELIVERED'`.

Yes, the `list_users` tool will output a JSON array of all users in your workspace. You can pipe this to other commands for filtering or processing.

The server interacts with your Courier workspace's metadata and logs. This includes message delivery events, user profile data such as email addresses, and template details. Each request is handled in a dedicated, ephemeral sandbox on Vinkius.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript