Matrix/Element MCP Server for Mastra AIGive Mastra AI instant access to 19 tools to Change Password, Claim Keys, Create Room, and more
GDPR Free for SubscribersMastra AI is a TypeScript-native agent framework built for modern web stacks. Connect Matrix/Element through Vinkius and Mastra agents discover all tools automatically. type-safe, streaming-ready, and deployable anywhere Node.js runs.
Ask AI about this MCP Server for Mastra AI
The Matrix/Element MCP Server for Mastra AI is a standout in the Communication Messaging category — giving your AI agent 19 tools to work with, ready to go from day one.
Vinkius delivers Streamable HTTP and SSE to any MCP client
Geminiimport { Agent } from "@mastra/core/agent";
import { createMCPClient } from "@mastra/mcp";
import { openai } from "@ai-sdk/openai";
async function main() {
// Your Vinkius token. get it at cloud.vinkius.com
const mcpClient = await createMCPClient({
servers: {
"matrixelement": {
url: "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp",
},
},
});
const tools = await mcpClient.getTools();
const agent = new Agent({
name: "Matrix/Element Agent",
instructions:
"You help users interact with Matrix/Element " +
"using 19 tools.",
model: openai("gpt-4o"),
tools,
});
const result = await agent.generate(
"What can I do with Matrix/Element?"
);
console.log(result.text);
}
main();
* 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
About Matrix/Element MCP Server
Connect your Matrix account to any AI agent and take full control of your decentralized communications through natural conversation.
Mastra's agent abstraction provides a clean separation between LLM logic and Matrix/Element tool infrastructure. Connect 19 tools through Vinkius and use Mastra's built-in workflow engine to chain tool calls with conditional logic, retries, and parallel execution. deployable to any Node.js host in one command.
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.
The Matrix/Element MCP Server exposes 19 tools through the Vinkius. Connect it to Mastra AI in under two minutes — credentials fully managed, no infrastructure to provision, no vendor lock-in. Your configuration, your data, your control.
All 19 Matrix/Element tools available for Mastra AI
When Mastra AI connects to Matrix/Element through Vinkius, your AI agent gets direct access to every tool listed below — spanning matrix, element, chat, and more. Every call runs in a secure, isolated environment with full audit visibility. Beyond a simple connection, you get real-time monitoring of agent activity, enterprise governance, and optimized token usage.
Change password on Matrix/Element
Change the account password
Claim keys on Matrix/Element
Claim E2EE keys from the homeserver
Create room on Matrix/Element
Create a new Matrix room
Deactivate account on Matrix/Element
Deactivate the current Matrix account
Download media on Matrix/Element
Download media from the homeserver
Get room state on Matrix/Element
Get state events for a room
Join room on Matrix/Element
Join a Matrix room by ID or alias
Knock room on Matrix/Element
Knock on a Matrix room to request access
Leave room on Matrix/Element
Leave a Matrix room
Login account on Matrix/Element
Log in to a Matrix account
Logout account on Matrix/Element
Log out of the current Matrix account
Query keys on Matrix/Element
Query E2EE keys from the homeserver
Register account on Matrix/Element
Register a new Matrix account
Search user directory on Matrix/Element
Search the user directory
Send message on Matrix/Element
Send a message or event to a Matrix room
Set room state on Matrix/Element
Set state events for a room
Sync client on Matrix/Element
Synchronize client state with the homeserver
Upload keys on Matrix/Element
Upload E2EE keys to the homeserver
Upload media on Matrix/Element
Upload media to the homeserver
Connect Matrix/Element to Mastra AI via MCP
Follow these steps to wire Matrix/Element into Mastra AI. The entire setup takes under two minutes — your credentials stay safe behind Vinkius.
Install dependencies
npm install @mastra/core @mastra/mcp @ai-sdk/openaiReplace the token
[YOUR_TOKEN_HERE] with your Vinkius tokenRun the agent
agent.ts and run with npx tsx agent.tsExplore tools
Why Use Mastra AI with the Matrix/Element MCP Server
Mastra AI provides unique advantages when paired with Matrix/Element through the Model Context Protocol.
Mastra's agent abstraction provides a clean separation between LLM logic and tool infrastructure. add Matrix/Element without touching business code
Built-in workflow engine chains MCP tool calls with conditional logic, retries, and parallel execution for complex automation
TypeScript-native: full type inference for every Matrix/Element tool response with IDE autocomplete and compile-time checks
One-command deployment to any Node.js host. Vercel, Railway, Fly.io, or your own infrastructure
Matrix/Element + Mastra AI Use Cases
Practical scenarios where Mastra AI combined with the Matrix/Element MCP Server delivers measurable value.
Automated workflows: build multi-step agents that query Matrix/Element, process results, and trigger downstream actions in a typed pipeline
SaaS integrations: embed Matrix/Element as a first-class tool in your product's AI features with Mastra's clean agent API
Background jobs: schedule Mastra agents to query Matrix/Element on a cron and store results in your database automatically
Multi-agent systems: create specialist agents that collaborate using Matrix/Element tools alongside other MCP servers
Example Prompts for Matrix/Element in Mastra AI
Ready-to-use prompts you can give your Mastra AI agent to start working with Matrix/Element immediately.
"Sync my Matrix client to see if I have any new notifications."
"Send a message to room !abc:matrix.org saying 'The deployment is complete'."
"Search the user directory for 'bob'."
Troubleshooting Matrix/Element MCP Server with Mastra AI
Common issues when connecting Matrix/Element to Mastra AI through Vinkius, and how to resolve them.
createMCPClient not exported
npm install @mastra/mcpMatrix/Element + Mastra AI FAQ
Common questions about integrating Matrix/Element MCP Server with Mastra AI.
How does Mastra AI connect to MCP servers?
MCPClient with the server URL and pass it to your agent. Mastra discovers all tools and makes them available with full TypeScript types.Can Mastra agents use tools from multiple servers?
Does Mastra support workflow orchestration?
Explore More MCP Servers
View all →
Railz
12 toolsFinancial data integration platform — connect accounting, banking, and commerce data via AI.
ContentGroove
8 toolsEquip your AI agent to automatically generate video highlights, splice long-form clips, and manage video projects natively with ContentGroove.
Focus NFe
5 toolsEmit, consult, cancel and download XML for NFS-e and NF-e via Focus NFe API.
Bling ERP
18 toolsConnect Bling ERP via AI — manage inventory, process orders, issue Brazilian tax documents (NF-e), and track accounts directly from your agent.