# mumo

> mumo is a multi-model AI deliberation platform for coding agents and MCP clients. Your agent asks a panel of frontier models (Claude, GPT, Gemini, Grok, Qwen, Kimi, GLM) to evaluate a hard decision, then gets back each model's raw response plus a structured claim map of their reactions to each other — showing where they agree, disagree, and flag unresolved risk. Final judgment rests with the calling agent and operating human.

mumo runs as a remote MCP server at https://mumo.chat/api/mcp (Streamable HTTP, `Authorization: Bearer mmo_live_*`). It works in Claude Code, Cursor, Codex, VS Code (Copilot), Hermes, OpenClaw, and any MCP-compatible client.

## When to use
- Reviewing a plan, spec, architecture, API, or schema before implementation — especially anything touching auth, security, tokens, payments, data exposure, or migrations.
- High-regret decisions with real tradeoffs, where one model can be confidently wrong.
- Pressure-testing assumptions, red-teaming, or stuck debugging after repeated failed attempts.

## When not to use
- Factual lookups or simple syntax / code generation.
- Tasks where there is no ambiguity about the correctness of your approach.
- When the user explicitly wants a single model's answer.
- Don't auto-trigger the round Takeaway (`takeaway`) unless the user asks — it adds cost.

## Start here
- [Why mumo](https://mumo.chat/why-mumo): why multi-model deliberation beats a single model on high-regret decisions.
- [How it works](https://mumo.chat/how-it-works): the loop — convene a panel, read the claim map, steer with more rounds.
- [Homepage](https://mumo.chat): overview and examples.

## Integrate
- [MCP server docs](https://mumo.chat/docs/mcp): full tool reference, request/response shapes, and client-specific examples. Start here to wire up the server.
- [REST API docs](https://mumo.chat/docs/api): the HTTP API the MCP server wraps.
- [Install guide](https://mumo.chat/install): choose your client.
  - [Claude Code](https://mumo.chat/install/claude-code)
  - [Cursor](https://mumo.chat/install/cursor)
  - [Codex](https://mumo.chat/install/codex)
  - [VS Code](https://mumo.chat/install/vs-code)
  - [Hermes](https://mumo.chat/install/hermes)
  - [OpenClaw](https://mumo.chat/install/openclaw)

## MCP tools
Full schemas and examples at https://mumo.chat/docs/mcp:
- create_deliberation — start a deliberation; returns session_id + round_id (async ack, runs in the background).
- wait_for_round — block on cheap progress polling until a round completes; returns each model's response and the claim map.
- append_round — add a follow-up round, optionally with steering snippets (KEEP / EXPLORE / CHALLENGE / CORE / SHIFT).
- get_session — read full session state: rounds, responses, snippets, claim maps.
- share_session — share a session at its public /p URL; returns share_url plus the .md/.brief.md machine twins (idempotent; re-call after new rounds to refresh the snapshot at the same URL).
- list_sessions — find prior sessions.
- list_models — models available to your account, with pricing.
- get_credit — wallet balance and usage.

## Published deliberations (machine-readable)
Every shared/published session page at https://mumo.chat/p/{slug} has two markdown twins (the HTML page is a JS app shell — fetch these for the content; the HTML head carries <link rel="alternate" type="text/markdown">):
- https://mumo.chat/p/{slug}.brief.md — the BRIEF: session synthesis only (bottom line, trajectory, typed arcs, round map), ~1-2k tokens, predictable cost. Read this first to decide whether a session is relevant; rank/compare many sessions with it.
- https://mumo.chat/p/{slug}.md — the FULL deliberation: session takeaway first, then each round's prompt, per-model responses, claim map (typed model-to-model reactions: KEEP/EXPLORE/CHALLENGE/CORE/SHIFT), round takeaway, and sources. Use this to review or audit — the brief's synthesis is only checkable against this evidence.
- https://mumo.chat/library/sessions — the human-browsable catalog of featured sessions (same set as the featured list below, with titles, synopses, and participants).
- https://mumo.chat/library/results — manually curated review results: what a panel review changed before ship (findings with severity, before/after plan deltas, verdicts), each linking its full session as evidence.

## Notes
- Auth: create a key at https://mumo.chat/settings/api-keys (starts with mmo_live_).
- A typical single round takes ~30–60s; create_deliberation returns immediately, then call wait_for_round.
- Each round costs credits per participating model — reserve mumo for decisions that warrant it.
- Panel consensus is input, not authority — the panel can be confidently wrong as a unit.

## Featured sessions
- https://mumo.chat/p/psp-webhook-double-credit-m7m39h.brief.md
- https://mumo.chat/p/llm-note-worker-hang-dba5ta.brief.md
- https://mumo.chat/p/flaky-ci-fix-sprint-dpji5z.brief.md
- https://mumo.chat/p/promotion-stacking-correctness-zodyjn.brief.md
- https://mumo.chat/p/poison-pill-job-retries-gqklnj.brief.md
- https://mumo.chat/p/lease-ownership-fix-pressure-test-jecygl.brief.md
- https://mumo.chat/p/billionaires-and-ai-toxicity-j4a3tv.brief.md
- https://mumo.chat/p/sakana-fugu-multi-agent-ckpsxz.brief.md