Direxio Local MCP
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Direxio Local MCP search for rooms matching 'design'"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Direxio Local MCP
Local MCP server for Direxio chat workflows.
Install
npm install -g @direxio/local-mcpFor local testing before publishing the package:
npm install -g /home/adam/direxio/direxio-mcpRelated MCP server: Teams Messenger MCP App
Configuration
Set:
export DIREXIO_DOMAIN="https://example.com"
export DIREXIO_AGENT_TOKEN="<agent token>"DIREXIO_DOMAIN must be the service origin. Do not include /_p2p or /_matrix.
The server uses only DIREXIO_AGENT_TOKEN. It does not request, store, or expose Matrix access tokens.
MCP Server Command
direxio-mcpExample MCP client configuration:
{
"mcpServers": {
"direxio": {
"command": "direxio-mcp",
"env": {
"DIREXIO_DOMAIN": "https://example.com",
"DIREXIO_AGENT_TOKEN": "<agent token>"
}
}
}
}Tools
search_rooms- search or list contacts, groups, and channels.send_message- send a plain text ordinary message byroom_id.list_messages- read ordinary messages byroom_idand optionalfrom_ts/to_ts.list_channel_posts- read channel posts by channelroom_id.list_post_comments- read comments for a channelpost_id.comment_channel_post- publish a plain text comment to an existing channel post.
All tool results are concise JSON text.
Development
If Node.js is not on PATH in WSL/Linux, use a reusable user-local install:
export PATH="/home/adam/.local/node/bin:$PATH"Then run:
npm test
npm run typecheck
npm run build
npm pack --dry-runLocal Docker E2E Tests
The normal unit suite does not require a Direxio backend:
npm testAfter the backend implements the six mcp.* actions, run the local Docker e2e harness with:
export DIREXIO_E2E=1
export DIREXIO_DOMAIN="https://localhost:8448"
export DIREXIO_AGENT_TOKEN="<agent token>"
npm run test:e2e:localFor self-signed local Docker certificates, run with NODE_TLS_REJECT_UNAUTHORIZED=0.
With only DIREXIO_DOMAIN and DIREXIO_AGENT_TOKEN, the e2e suite smoke-tests search_rooms. Set these optional fixture IDs to exercise the remaining tools:
export DIREXIO_E2E_ROOM_ID="!room:dendrite-a:8448"
export DIREXIO_E2E_CHANNEL_ROOM_ID="!channel:dendrite-a:8448"
export DIREXIO_E2E_POST_ID="post_123"DIREXIO_E2E_ROOM_ID enables send_message and list_messages. DIREXIO_E2E_CHANNEL_ROOM_ID enables list_channel_posts. DIREXIO_E2E_POST_ID enables list_post_comments and comment_channel_post.
MCP SDK Package
The initial plan referenced @modelcontextprotocol/server. npm currently publishes that package only as 2.0.0-alpha.2. This package uses the stable official @modelcontextprotocol/sdk package instead, with imports from @modelcontextprotocol/sdk/server/mcp.js and @modelcontextprotocol/sdk/server/stdio.js.
Available Tools
6 toolscomment_channel_postC
Publish a plain text comment to an existing Direxio channel post.
Inputs: msg (required), post_id (required).
list_channel_postsC
List channel posts by channel room_id and optional Unix millisecond time range.
Inputs: room_id (required), limit, to_ts, from_ts.
list_messagesC
List ordinary room messages by room_id and optional Unix millisecond time range.
Inputs: room_id (required), limit, to_ts, from_ts.
list_post_commentsB
List comments for a channel post by post_id and optional Unix millisecond time range.
Inputs: post_id (required), limit, to_ts, from_ts.
search_roomsB
Search or list Direxio contacts, groups, and channels. Use returned room_id with message tools.
Inputs: type, limit, query.
send_messageB
Send a plain text message to a Direxio private chat, group, or channel room.
Inputs: msg (required), room_id (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 6 tools
Each tool has a clearly distinct purpose: posting comments, listing posts, listing messages, listing comments, searching rooms, and sending messages. No overlap or ambiguity.
All tool names follow a consistent verb_noun pattern in snake_case, e.g., comment_channel_post, list_channel_posts, send_message. The convention is uniform.
With 6 tools, the set is well-scoped for a messaging server covering rooms, messages, channels, and posts. Each tool earns its place without being excessive.
The tool set allows reading and writing messages and comments, but lacks essential operations like creating channel posts, editing, or deleting content. This is a significant gap that could cause agent failures.
Maintenance
Related MCP Connectors
Agent-to-agent messaging: directory, public lobby, DMs, channels, search. Stateless MCP + REST.
MCP server for Sendbird — chat users, channels, members, and messages from your AI client.
The official Planning Center MCP server for interacting with your ministry's data.
Discover MCP servers and A2A agents; verify, message, post, follow, react, and receive webhooks.
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceA Model Context Protocol server that bridges Microsoft Teams and MCP-compatible clients, enabling chat integration, message handling, and advanced search capabilities without REST API endpoints.1-
- FlicenseNot gradedqualityDmaintenanceA Model Context Protocol server that bridges Microsoft Teams with MCP-compatible clients (LLMs, agentic frameworks, CLI), enabling chat integration, message search, and event streaming without traditional REST API endpoints.-
- AlicenseNot gradedqualityBmaintenanceMCP server for a local-first messaging workspace that integrates Google Messages, WhatsApp, and Signal. It enables reading, sending, searching messages, and managing conversations through MCP tools.73-
- AlicenseNot gradedqualityBmaintenanceA standalone MCP tool server that exposes Matrix chat operations as callable tools, enabling messaging, room management, user management, and ID resolution for MCP-compatible clients.125 npmMIT