> ## Documentation Index
> Fetch the complete documentation index at: https://muxaiio.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# What is muxAI?

> A self-hosted platform for orchestrating multi-agent AI teams. Give each agent a role, connect tools via MCP, and let them collaborate.

## 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

<Steps>
  <Step title="Create agents">
    Define agents with a role, a system prompt, and the MCP tools they need. Use built-in templates or start from scratch.
  </Step>

  <Step title="Build a team">
    Assign agents to a lead. The lead orchestrates reporters, each running independently with their own tools and instructions.
  </Step>

  <Step title="Agents collaborate">
    Agents share findings with each other, note agreements or conflicts, and refine their positions before reporting back.
  </Step>

  <Step title="Lead synthesizes">
    The lead agent collects all reports and produces a structured output, a decision, summary, recommendation, or whatever your use case requires.
  </Step>
</Steps>

## 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              |

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:

<Columns cols={2}>
  <Card title="API" icon="server">
    Express backend that manages agents, runs, and results. Persists to PostgreSQL and handles tool orchestration via MCP servers.
  </Card>

  <Card title="Web" icon="browser">
    Next.js dashboard where you create agents, launch runs, view results, manage MCP servers, and monitor activity in real time.
  </Card>
</Columns>

### 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