How to Use the Courier MCP in CrewAI

Q: How do I assign the Courier MCP tools to a specific agent in CrewAI?

When you define your agent, use the toolfilter option in your MCPServerHTTP setup. This lets you expose the Courier tools only to your designated "Communications Agent," not the entire crew.

Q: How does a CrewAI agent get a list of available Courier templates before sending?

The agent with the tools can call listtemplates. It gets back the names and IDs of all notification templates in your Courier workspace, which it can then use in the sendnotification tool.

Q: Can I see who is in my Courier workspace using CrewAI?

Yes. An agent with the tools can call listusers to get a list of all registered users and their roles in your Courier account. This is useful for crews that perform administrative tasks.

Give your CrewAI agents a voice. Add a Communications Specialist to your team to send alerts and report on message delivery via MCP.

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 CrewAI

Create your Vinkius account to connect Courier to CrewAI 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 CrewAI

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Designate a Communications Agent

Don't give every agent the keys to your notification system. Add this MCP server to a single agent in your crew and give it the role of "Communications Specialist." Now, other agents can delegate notification tasks to it, keeping roles clean and focused. For example, your "Data Analyst Agent" can finish a report and then simply task the Comms Agent to `send_notification` to the stakeholders. The specialist handles the entire interaction with Courier, so your other agents don't have to.

Build a Crew That Watches and Alerts

This is where multi-agent systems shine. Pair a monitoring agent with your new communications agent. When your "Sentry Agent" detects an API outage, it tasks the "Comms Agent" to look up the on-call engineer with `get_user_profile`. Then, the Comms Agent uses `send_notification` to send a high-priority alert to their phone via SMS. Your CrewAI team can now handle incident response from detection to notification, all by itself. This is what an autonomous MCP Server workflow is supposed to look like.

Collaborative, Automated Reporting

Task a "Reporting Agent" to analyze notification effectiveness. This agent can ask the "Comms Agent" to run `list_messages` for a specific campaign or timeframe, filtering by status. The crew collaborates on the results. The Comms Agent acts as the data source, fetching raw delivery and open statuses from Courier. The Reporting Agent then takes that data, summarizes it into a clean report, and tasks the Comms Agent to send it to the marketing team.

Setup guide

Set up Courier MCP in CrewAI

Prerequisites

Python 3.10+ installed
crewai package (pip install crewai)
Active Vinkius subscription with a valid endpoint token

1

Install CrewAI
Run pip install crewai to install the framework. MCP support is built-in via the mcps parameter.
2

Add the MCP URL to your agent
Pass your Vinkius endpoint directly to the mcps list. Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com. CrewAI handles tool discovery and caching automatically.
3

Kick off your crew
Create a Crew with your agent and tasks. Call crew.kickoff() — the agent will automatically invoke Courier tools as needed.

crew.py

from crewai import Agent, Task, Crew

agent = Agent(
    role="Courier Analyst",
    goal="Access and analyze Courier data via MCP.",
    backstory="Expert analyst with direct Courier access.",
    mcps=[
        "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    ],
)

task = Task(
    description="List recent Courier transactions",
    agent=agent,
    expected_output="A summary of recent activity",
)

crew = Crew(agents=[agent], tasks=[task])
result = crew.kickoff()
print(result)

Get your connection token →

Prerequisites

Python 3.10+ installed
crewai + crewai-tools packages
Active Vinkius subscription with a valid endpoint token

1

Install dependencies
Run pip install crewai crewai-tools. The MCPServerAdapter handles lifecycle management and tool conversion.
2

Connect with MCPServerAdapter
Use MCPServerAdapter as a context manager with SseServerParameters pointing to your Vinkius endpoint. The adapter automatically manages connection lifecycle.
3

Assign tools and run
Pass the returned mcp_tools to your agent's tools parameter. The adapter converts MCP tools to native BaseTool objects compatible with all CrewAI agents.

crew.py

from crewai import Agent, Task, Crew
from crewai_tools import MCPServerAdapter
from mcp import SseServerParameters

server_params = SseServerParameters(
    url="https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
)

with MCPServerAdapter(server_params) as mcp_tools:
    agent = Agent(
        role="Courier Analyst",
        goal="Access and analyze Courier data via MCP.",
        backstory="Expert analyst with direct Courier access.",
        tools=mcp_tools,
    )

    task = Task(
        description="List recent Courier transactions",
        agent=agent,
        expected_output="A summary of recent activity",
    )

    crew = Crew(agents=[agent], tasks=[task])
    result = crew.kickoff()
    print(result)

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 CrewAI

When you define your agent, use the `tool_filter` option in your `MCPServerHTTP` setup. This lets you expose the Courier tools only to your designated "Communications Agent," not the entire crew.

Yes, and that's the right way to use it. A "Researcher Agent" can find information and then delegate the task of sending a notification to a "Communications Agent" that has the Courier tools loaded.

The agent with the tools can call `list_templates`. It gets back the names and IDs of all notification templates in your Courier workspace, which it can then use in the `send_notification` tool.

Yes. An agent with the tools can call `list_users` to get a list of all registered users and their roles in your Courier account. This is useful for crews that perform administrative tasks.

Your CrewAI agents communicate with Courier through this MCP server, which runs in a zero-trust, ephemeral environment. It only has access to notification metadata and user profiles from Courier. Your credentials stay secure, and each agent's request is stateless and isolated.

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