Bring Matrix
to OpenAI Agents SDK
Learn how to connect Matrix/Element to OpenAI Agents SDK 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 OpenAI Agents SDK?
The OpenAI Agents SDK auto-discovers all 19 tools from Matrix/Element through native MCP integration. Build agents with built-in guardrails, tracing, and handoff patterns. chain multiple agents where one queries Matrix/Element, another analyzes results, and a third generates reports, all orchestrated through Vinkius.
- —
Native MCP integration via
MCPServerSse, pass the URL and the SDK auto-discovers all tools with full type safety - —
Built-in guardrails, tracing, and handoff patterns let you build production-grade agents without reinventing safety infrastructure
- —
Lightweight and composable: chain multiple agents and MCP servers in a single pipeline with minimal boilerplate
- —
First-party OpenAI support ensures optimal compatibility with GPT models for tool calling and structured output
Matrix/Element in OpenAI Agents SDK
Matrix/Element and 4,000+ other MCP servers. One platform. One governance layer.
Teams that connect Matrix/Element to OpenAI Agents SDK 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 OpenAI Agents SDK
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 OpenAI Agents SDK 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 OpenAI Agents SDK
Every tool call from OpenAI Agents SDK 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 the OpenAI Agents SDK connect to MCP?
Use MCPServerSse(url=...) to create a server connection. The SDK auto-discovers all tools and makes them available to your agent with full type information.
Can I use multiple MCP servers in one agent?
Yes. Pass a list of MCPServerSse instances to the agent constructor. The agent can use tools from all connected servers within a single run.
Does the SDK support streaming responses?
Yes. The SDK supports SSE and Streamable HTTP transports, both of which work natively with Vinkius.
MCPServerStreamableHttp not found
Ensure you have the latest version: pip install --upgrade openai-agents
Agent not calling tools
Make sure your prompt explicitly references the task the tools can help with.
Explore More MCP Servers
View all →
Contentstack
10 toolsManage headless CMS via Contentstack — list and create entries, audit content types, handle media assets, and publish to environments directly from any AI agent.
Kavak
14 toolsBrowse, inspect, finance, and reserve certified used cars from Kavak — Mexico's largest online used car platform — directly from any AI agent.
Keap
11 toolsManage CRM contacts, marketing campaigns, and sales automation via Keap.
Dataiku DSS
14 toolsManage data science via Dataiku — list projects and datasets, track pipeline jobs, run automation scenarios, and monitor ML models directly from any AI agent.