Skip to main content

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

1

Create agents

Define agents with a role, a system prompt, and the MCP tools they need. Use built-in templates or start from scratch.
2

Build a team

Assign agents to a lead. The lead orchestrates reporters, each running independently with their own tools and instructions.
3

Agents collaborate

Agents share findings with each other, note agreements or conflicts, and refine their positions before reporting back.
4

Lead synthesizes

The lead agent collects all reports and produces a structured output, a decision, summary, recommendation, or whatever your use case requires.

Example: crypto trade analysis

A trading team with three reporters and a lead:
AgentRoleTools
Technical AnalystReads price charts, identifies patterns, support/resistance, indicator readingsChart analysis MCP
News AnalystScans headlines, assesses sentiment, flags market-moving eventsNews feeds, CoinMarketCap MCP
Data AnalystAnalyzes Open Interest, Funding Rates, Fear & Greed, on-chain metricsCoinMarketCap MCP, web search
Lead (mux)Synthesizes all findings into a LONG / SHORT / WAIT decision with entry, targets, and stop lossOrchestrator MCP
This is just one configuration. You can create teams for any domain by changing the agents, prompts, and tools.

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

LayerTechnology
RuntimeNode.js 18+
Package managerpnpm (monorepo with workspaces)
APIExpress + TypeScript
WebNext.js + React + Tailwind CSS
DatabasePostgreSQL (embedded PGlite or external)
ORMPrisma
AI orchestrationClaude CLI + MCP servers
Build systemTurborepo

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