Install mumo in Codex.

Generate your API key

Sign in, create a mumo API key, and copy the value that starts with mmo_live_. Codex reads it from your shell environment, not from a config file — so it never lives in committed code.

Set MUMO_API_KEY for Codex

The plugin's .mcp.json declares bearer_token_env_var: MUMO_API_KEY, which tells Codex to read the token from your environment and send it as the Authorization header on every request to https://mumo.chat/api/mcp.

On macOS, set it for your apps from Terminal so the Codex IDE extension launched from Finder/Dock inherits it (GUI apps don't read your shell profile):

launchctl setenv MUMO_API_KEY mmo_live_YOUR_KEY_HERE

Optional: also add export MUMO_API_KEY=mmo_live_YOUR_KEY_HERE to ~/.zshrc if you want terminal sessions to have the key too.

Add the mumo marketplace

If you don't have the Codex CLI yet, install it from npm — then register the mumo marketplace:

npm i -g @openai/codex
codex plugin marketplace add mumo-chat/mumo-codex

This adds an entry to ~/.codex/config.toml under [marketplaces.mumo]. Adding the marketplace does not auto-enable the plugin — that's the next step.

Install the mumo plugin

Recommended: install from the Codex app. Most users live in the GUI, and the install card is cleaner there.

1. Open the Codex desktop app.
2. In the side nav, click Plugins.
3. Click the publisher dropdown (defaults to Built by OpenAI) and select mumo.
4. On the mumo plugin card under Productivity, click the + button.
5. In the install dialog, click Install mumo.

When the install completes, ~/.codex/config.toml ends up with [plugins."mumo@mumo"] + enabled = true, and the plugin's skill + MCP server are registered. Start a new thread (or restart Codex) so the freshly-installed MCP server attaches.

CLI alternative. If you're working headless or prefer the terminal, the plugin browser is also available inside any Codex CLI session. Start a session with codex, then run /plugins, switch to the mumo marketplace tab, select mumo, press Enter, and choose Install plugin.

Fallback if neither the app nor the CLI plugin browser is enabling mumo on your Codex build: register the MCP server directly. This gives you the seven mumo tools but skips the skill (so the agent loses the deliberation-loop instructions and has to discover the tools on its own):

codex mcp add mumo \
  --url https://mumo.chat/api/mcp \
  --bearer-token-env-var MUMO_API_KEY

Verify with a low-cost call

Before running a real deliberation, smoke-test that auth and tool routing are working. Either:

codex mcp list

…and confirm mumo is listed, or ask Codex in a thread:

Ask mumo to list available models.

That hits list_models(read-only, no credit consumed). If it returns a list of seven providers, you're ready for a real deliberation.

Run your first deliberation

Name mumo explicitly the first time so Codex routes through the panel. The skill will guide the agent through the create→wait→read→snippet loop and teach it to verify the session actually fired.

Ask mumo to compare Postgres and MongoDB for our event store.
Include the constraints from this repo and tell me where the models disagree.

If the agent claims a deliberation succeeded but doesn't produce a UUID-format session ID, the call didn't fire — confirm with list_sessions or check mumo.chat. The skill teaches this discipline; this is the user-facing reminder.