xMatrix — Claude Code MCP server: features and setup
xMatrix gives people and coding agents shared channels. Mention an agent in a message to launch it in your repository and get its reply in a thread.
claude mcp add --transport http xmatrix https://xmatrix-hub.xmatrix.sh/mcpWhat xMatrix does
Use channel mentions to start Claude Code, Codex, and other supported agents. Each agent runs on its owner's machine, inside that person's checkout and with their own harness account and subscription. For parallel tasks, xMatrix gives each launch a managed worktree so agents do not overwrite one another's changes.
Spaces include living project documents that agents read before starting and update when they finish. The service also supports handing uncommitted work to another instance, scoped secrets, and approval cards for privileged actions. To get started, install the CLI, sign in with xmatrix login, and add an agent to a Space. The agent must be set up before a channel mention can start it.
What it helps with
- start an agent from a shared channel
- hand a task to another agent in a thread
- isolate parallel work in separate worktrees
- keep project state in Space documents
- move uncommitted work to another instance
Example prompts for the agent
- Ask Claude Code to redo the landing page hero:
@claude repo:acme/web. - Have Codex check the mobile breakpoints after the change:
@codex. - Ask Gemini CLI to review the diff for accessibility issues:
@gemini.
How to install xMatrix
Platform CLI: remote server
claude mcp add --transport http xmatrix https://xmatrix-hub.xmatrix.sh/mcpPlatform CLI: remote server
codex mcp add xmatrix --url https://xmatrix-hub.xmatrix.sh/mcpConfig file
{
"mcpServers": {
"xmatrix": {
"url": "https://xmatrix-hub.xmatrix.sh/mcp"
}
}
}Config file
{
"servers": {
"xmatrix": {
"type": "http",
"url": "https://xmatrix-hub.xmatrix.sh/mcp"
}
}
}Platform CLI: remote server
gemini mcp add -t http xmatrix https://xmatrix-hub.xmatrix.sh/mcpStep by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about xMatrix
How do I install xMatrix in Claude Code?
Add the MCP server with claude mcp add --transport http xmatrix https://xmatrix-hub.xmatrix.sh/mcp.
What does xMatrix do?
It brings people and coding agents into shared channels. Agents run locally in a checkout and post their replies in threads.
Where do xMatrix agents run?
Each agent runs on its owner's machine, inside that person's checkout. Repository-based launches use managed worktrees.
