How to Use the Mattermost MCP in Windsurf

Q: How does Windsurf connect to my Mattermost server?

Add the configuration block to your Windsurf mcpconfig.json file. Windsurf auto-discovers the 12 Mattermost tools, letting Cascade call them instantly when you prompt it to investigate or post to your chat.

Get Windsurf to manage your Mattermost channels, map team structures, and post updates without writing a single line of API glue code.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Mattermost MCP to Windsurf

Create your Vinkius account to connect Mattermost to Windsurf 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 Mattermost with Windsurf

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Auto-map team structures directly in Windsurf

The `list_teams` tool lets Windsurf inspect your entire Mattermost workspace setup to find active groups. Once Windsurf knows the layout, it runs `list_team_channels` and `get_team_details` to map out who is working where in Mattermost. You don't have to point Windsurf to specific Mattermost IDs. Windsurf resolves these Mattermost channel dependencies on its own. Cascade chains these queries to build an internal map of your Mattermost teams so it can contextually drop files, code, or alerts exactly where your engineers actually hang out.

Chain incident alerts using this MCP Server

This MCP Server exposes `post_message` and `list_channel_posts` so Windsurf can monitor Mattermost chat threads and drop replies. When a build breaks, Windsurf doesn't just sit there; it reads the error and posts the log to Mattermost. If the target Mattermost channel doesn't exist yet, Windsurf invokes `create_new_channel` to spin up an incident room. It then pulls the Mattermost team list via `list_server_users` to suggest who Windsurf should pull into the triage loop.

Audit webhook setups and configurations

The `list_incoming_webhooks` and `get_server_config` tools give Windsurf direct visibility into how your Mattermost chat infrastructure is wired. Windsurf uses this data to verify that your automated Mattermost alerts are pointing to active endpoints. Instead of digging through your Mattermost browser settings, you ask Windsurf to verify your integrations. Windsurf checks the configuration, compares it against active Mattermost channels, and reports back with exact fixes if a webhook points to a deleted room.

Setup guide

Set up Mattermost MCP in Windsurf

Prerequisites

Windsurf IDE installed (macOS, Windows, or Linux)
Active Vinkius subscription with a valid endpoint token

1

Open MCP configuration

Click the Cascade assistant icon in the sidebar, then click the hammer icon (🔨) at the top of the panel. Select "Configure" to open ~/.codeium/windsurf/mcp_config.json.
2

Add the Mattermost 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

Refresh MCPs

Go back to the hammer icon (🔨) in Cascade and click "Refresh". Windsurf will detect the new server. No full restart is needed — the connection is hot-reloaded.
4

Verify in Cascade

Start a new Cascade conversation and ask something like "Show my Mattermost payment history." If connected, Cascade will call the Mattermost tools directly. You will see a green dot next to the server name in the MCP panel.

mcp_config.json

{
  "mcpServers": {
    "mattermost-mcp": {
      "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 Mattermost. 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 Mattermost 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 Mattermost MCP in Windsurf

Add the configuration block to your Windsurf `mcp_config.json` file. Windsurf auto-discovers the 12 Mattermost tools, letting Cascade call them instantly when you prompt it to investigate or post to your chat.

Yes, that is exactly how Windsurf uses this MCP Server. If you tell Cascade to notify the team about a database lag, it will run `test_server_ping`, find the channel with `list_team_channels`, and execute `post_message` in sequence on Mattermost.

Your Mattermost personal access token dictates what Windsurf can do. If your token lacks admin rights, tools like `list_system_roles` or `get_server_config` will fail gracefully, keeping your workspace secure.

Yes. You define your Mattermost host URL inside the Windsurf configuration file. Whether your server runs on port 8065 or behind a custom reverse proxy, the client connects directly via standard API protocols.

They stay entirely within your local setup and your self-hosted Mattermost server. This MCP Server runs inside a secure local sandbox, meaning your channel histories, user profiles, and config data are never sent to Windsurf's or other third-party servers.

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