Bring Matrix
to Windsurf
Learn how to connect Matrix/Element to Windsurf and start using 19 AI agent tools in minutes. Fully managed, enterprise secure, and ready to use without writing a single line of code.
GDPR Free for SubscribersCompatible with every major AI agent and IDE
Gemini
What is the Matrix/Element MCP Server?
Connect your Matrix account to any AI agent and take full control of your decentralized communications through natural conversation.
What you can do
- Room Management — Create, join, knock, or leave rooms using simple commands like
create_roomandjoin_room. - Messaging & Events — Send messages or custom events to any room with transaction tracking via
send_message. - State Synchronization — Use
sync_clientto fetch the latest state from the homeserver and stay updated on all conversations. - User Discovery — Search the global user directory using
search_user_directoryto find and connect with others. - Account Control — Manage your profile, change passwords, or handle account registration and deactivation.
- Encryption & Keys — Handle cryptographic keys (
upload_keys,query_keys) for secure, end-to-end encrypted communication.
How it works
- Subscribe to this server
- Provide your Matrix Homeserver URL and Access Token
- Start orchestrating your chats from Claude, Cursor, or any MCP-compatible client
Who is this for?
- DevOps Engineers — automate alert rooms and incident response directly from the terminal.
- Privacy Advocates — maintain secure, decentralized communication without leaving your AI workflow.
- Community Managers — manage room states and user interactions across large Matrix networks.
Built-in capabilities (19)
Change the account password
Claim E2EE keys from the homeserver
Create a new Matrix room
Deactivate the current Matrix account
Download media from the homeserver
Get state events for a room
Join a Matrix room by ID or alias
Knock on a Matrix room to request access
Leave a Matrix room
Log in to a Matrix account
Log out of the current Matrix account
Query E2EE keys from the homeserver
Register a new Matrix account
Search the user directory
Send a message or event to a Matrix room
Set state events for a room
Synchronize client state with the homeserver
Upload E2EE keys to the homeserver
Upload media to the homeserver
Why Windsurf?
Windsurf's Cascade agent chains multiple Matrix/Element tool calls autonomously. query data, analyze results, and generate code in a single agentic session. Paste Vinkius Edge URL, reload, and all 19 tools are immediately available. Real-time tool feedback appears inline, so you see API responses directly in your editor.
- —
Windsurf's Cascade agent autonomously chains multiple tool calls in sequence, solving complex multi-step tasks without manual intervention
- —
Purpose-built for agentic workflows. Cascade understands context across your entire codebase and integrates MCP tools natively
- —
JSON-based configuration means zero code changes: paste a URL, reload, and all 19 tools are immediately available
- —
Real-time tool feedback is displayed inline, so you see API responses directly in your editor without switching contexts
Matrix/Element in Windsurf
Matrix/Element and 4,000+ other MCP servers. One platform. One governance layer.
Teams that connect Matrix/Element to Windsurf through Vinkius don't need to source, host, or maintain individual MCP servers. Every tool call runs inside a hardened runtime with credential isolation, DLP, and a signed audit chain.
Raw MCP | Vinkius | |
|---|---|---|
| Server catalog | Find and host yourself | 4,000+ managed |
| Infrastructure | Self-hosted | Sandboxed V8 isolates |
| Credential handling | Plaintext in config | Vault + runtime injection |
| Data loss prevention | None | Configurable DLP policies |
| Kill switch | None | Global instant shutdown |
| Financial circuit breakers | None | Per-server limits + alerts |
| Audit trail | None | Ed25519 signed logs |
| SIEM log streaming | None | Splunk, Datadog, Webhook |
| Honeytokens | None | Canary alerts on leak |
| Custom domains | Not applicable | DNS challenge verified |
| GDPR compliance | Manual effort | Automated purge + export |
Why teams choose Vinkius for Matrix/Element in Windsurf
The Matrix/Element MCP Server runs on Vinkius-managed infrastructure inside AWS — a purpose-built runtime with per-request V8 isolates, Ed25519 signed audit chains, and sub-40ms cold starts. All 19 tools execute in hardened sandboxes optimized for native MCP execution.
Your AI agents in Windsurf only access the data you authorize, with DLP that blocks sensitive information from ever reaching the model, kill switch for instant shutdown, and up to 60% token savings. Enterprise-grade infrastructure, zero maintenance.
* Every MCP server runs on Vinkius-managed infrastructure inside AWS - a purpose-built runtime with per-request V8 isolates, Ed25519 signed audit chains, and sub-40ms cold starts optimized for native MCP execution. See our infrastructure
How Vinkius secures
Matrix/Element for Windsurf
Every tool call from Windsurf to the Matrix/Element MCP Server is protected by DLP redaction, cryptographic audit chains, V8 sandbox isolation, kill switch, and financial circuit breakers.
Frequently asked questions
How do I see the latest messages in my rooms?
Use the sync_client tool. It synchronizes your local state with the homeserver, retrieving all new events, messages, and room state changes since your last sync.
Can I search for people on other Matrix servers?
Yes, the search_user_directory tool allows you to search the directory available to your homeserver, helping you find users by their display name or Matrix ID.
Is it possible to manage room settings like the topic or name?
Absolutely. Use set_room_state to update room metadata. You can change the room name, topic, or other state events by providing the correct event_type and body.
How does Windsurf discover MCP tools?
Windsurf reads the mcp_config.json file on startup and connects to each configured server via Streamable HTTP. Tools are listed in the MCP panel and available to Cascade automatically.
Can Cascade chain multiple MCP tool calls?
Yes. Cascade is an agentic system. it can plan and execute multi-step workflows, calling several tools in sequence to accomplish complex tasks without manual prompting between steps.
Does Windsurf support multiple MCP servers?
Yes. Add as many servers as needed in mcp_config.json. Each server's tools appear in the MCP panel and Cascade can use tools from different servers in a single flow.
Server not connecting
Check Settings → MCP for the server status. Try toggling it off and on.
Explore More MCP Servers
View all →
Descript
8 toolsEquip your AI agent with direct access to Descript — manage projects, export transcripts, and retrieve media assets without opening the video editor.
Baidu Analytics / 百度统计
8 toolsChina's leading web analytics platform — audit traffic, track visitors, and query site metrics via AI.
Fly.io Alternative
13 toolsManage edge compute infrastructure via Fly.io — list apps, control machines (VMs), manage volumes and certificates from any AI agent.
HCL AppScan
10 toolsManage security scans and vulnerabilities with HCL AppScan — track issues and audit applications via AI.