Overview
muxAI is a self-hosted platform that orchestrates multiple AI agents into collaborative teams. You define agents with specialized roles, give them tools via MCP (Model Context Protocol), and let them work together. A lead agent synthesizes their findings into a structured output. Build a research team, a trading desk, a content pipeline, a code review squad, or anything else where multiple perspectives produce better results than one.How it works
Create agents
Define agents with a role, a system prompt, and the MCP tools they need. Use built-in templates or start from scratch.
Build a team
Assign agents to a lead. The lead orchestrates reporters, each running independently with their own tools and instructions.
Agents collaborate
Agents share findings with each other, note agreements or conflicts, and refine their positions before reporting back.
Example: crypto trade analysis
A trading team with three reporters and a lead:| Agent | Role | Tools |
|---|---|---|
| Technical Analyst | Reads price charts, identifies patterns, support/resistance, indicator readings | Chart analysis MCP |
| News Analyst | Scans headlines, assesses sentiment, flags market-moving events | News feeds, CoinMarketCap MCP |
| Data Analyst | Analyzes Open Interest, Funding Rates, Fear & Greed, on-chain metrics | CoinMarketCap MCP, web search |
| Lead (mux) | Synthesizes all findings into a LONG / SHORT / WAIT decision with entry, targets, and stop loss | Orchestrator MCP |
Architecture
muxAI is a monorepo with two main apps:API
Express backend that manages agents, runs, and results. Persists to PostgreSQL and handles tool orchestration via MCP servers.
Web
Next.js dashboard where you create agents, launch runs, view results, manage MCP servers, and monitor activity in real time.
Tools via MCP
Agents access external data and capabilities through MCP (Model Context Protocol) servers. muxAI ships with built-in servers and supports adding custom ones through the UI:- Built-in servers for news, chart analysis, and team orchestration
- Custom servers added via the MCP Servers page (stdio or HTTP)
- Contractors for routing tasks to non-Claude models (GPT-4o, Grok, etc.) via OpenRouter-compatible APIs
Tech stack
| Layer | Technology |
|---|---|
| Runtime | Node.js 18+ |
| Package manager | pnpm (monorepo with workspaces) |
| API | Express + TypeScript |
| Web | Next.js + React + Tailwind CSS |
| Database | PostgreSQL (embedded PGlite or external) |
| ORM | Prisma |
| AI orchestration | Claude CLI + MCP servers |
| Build system | Turborepo |
What you get
- Multi-agent collaboration with structured team hierarchies and real-time streaming
- Structured outputs captured as JSON from every run
- Full audit trail of every agent run, what each agent found, and how they reached consensus
- MCP tool ecosystem with built-in servers, custom server registration, and contractor support
- Self-hosted with no external dependencies beyond your API keys
- Extensible with new agent roles, MCP tools, and output formats

