▸ UNDER THE HOOD — THE WHOLE SYSTEM, END TO END

The architecture
of a world that
builds itself.

A net-new Gemini + ADK + MCP multi-agent organisation — rendered into a place you walk through. Here's every layer, from the sentence you speak to the tools it connects.

◆ Gemini = diamond ◆ ADK = emerald ◆ MCP = gold ⛏ Vanilla Minecraft

THE BLUEPRINT

One socket, two brains,
a world that extends itself.

Two processes talk over one WebSocket. The org grows itself by calling MCP tools — the load-bearing trick. Solid = built today · dashed = roadmap.

Omo Mission Control System architecture — a world that builds itself for autonomous AI teams. MCP · every tool + the self-extension surface ADK · the multi-agent organisation Gemini · the brain of every agent 1 YOU — inside an ordinary (vanilla) Minecraft world Speak a goal “Check our ad spend… keep watch.” /revise <prompt> steer the live dashboard Tap-to-approve veto any outward action Push-to-talk (V) voice → whisper.cpp → chat 2 THE WORLD — Java 21 · the only code that touches Minecraft Omo client-mod · Fabric CinemaScreen — fullscreen live web dashboards (GPU-blit) voice capture · in-world terminal screens client-mod/src/.../terminal/ Paper plugin · Bukkit live parametric builds — block-by-block · villager spawn + pathing HQ island · cinema screens · tap-to-approve UI plugin/.../bridge/IncomingHandler.java 3 THE ORCHESTRATOR — Node / TypeScript runtime · single event loop WS Bridge :8765 Paper ⇄ runtime auth · broadcast() server.ts AgentManager brain select by room: Hermes · Claude · ADK approvals · metrics WorldStore ★ the live ORG GRAPH functions + consults worldStore.ts Dashboard server :8088 /dash/:id live boards + Society View dashboardServer.ts omo-tools MCP ★ :8090 World API + Meta Ads describe/add/build/ staff/assign/consult AdkAgent (bridge) ADK SSE ⇄ in-world reasoning→screens, say, transcript, approvals World Architect Gemini designs each building → build_ops worldArchitect.ts HTTP · Terminal 8766/67 control + face API terminal multiplex http.ts · terminalServer 4 THE ORGANISATION — ADK service · Python · adk api_server Chief of Staff (Gemini) ★ :8000 ADK coordinator — reasons, then DELEGATES sub_agents=[Growth, Comms] · transfer_to_agent extends the org via the World API (MCP) omo-agent/omo/agent.py gemini-flash-latest Growth (Gemini) REAL Meta Ads ROAS · spend · CTR Comms (Gemini) drafts — gated onboarding · outreach Specialist ×N hired on demand adopts any role tools = McpToolset(StreamableHTTP) → omo-tools · one reusable specialist app makes the org extensible to ANY function 5 THE OUTSIDE WORLD — every tool over MCP · Gemini is the brain Meta Ads Graph API LIVE — real campaigns + insights reached via the runtime's MCP Gemini API LIVE — brain of every agent + the world architect Google Workspace MCP ROADMAP — Gmail / Drive Google's own MCP server Stripe MCP ROADMAP — payments worlds-as-businesses talk · /revise · approve 1 WebSocket :8765 (bridge) 2 HTTP /dash/:id → CinemaScreen 8 HTTP /run_sse · live cognition 3 MCP · World API (self-extension) ★ 4 build_ops — room rises live 5 + world_staff → a specialist walks in (6) Graph API · live data 7 model API · brain MCP (roadmap) The self-extension loop You state intent — the org declares the function it needs and the world materialises it. No human pre-wires a thing: world_describe → world_add_function → world_build → world_staff → world_assign ( + world_consult: agents ask each other ) Gemini — the brain ADK / runtime MCP — connect + extend Human-in-the-loop Roadmap (dashed) Minecraft / Java Generated from the codebase · solid = built today · dashed = roadmap · omo-mc Gemini reasons · ADK orchestrates · MCP connects — including the org's own growth.

A live schematic, generated straight from the codebase.

⬇ Download SVG ⬇ Download PNG

FIVE LAYERS

From the sentence you speak
to the outside world.

01

YOU — in Minecraft

An ordinary vanilla world. Speak a goal, talk to any agent, steer with /revise, and veto any outward action with one tap. Push-to-talk (V) routes your voice straight to the agents.

the spatial interface
02

THE WORLD — Java 21

The Paper plugin + Omo client-mod are the only code that touches Minecraft: live block-by-block builds, villager spawning & pathing, fullscreen dashboard screens, and the tap-to-approve UI.

plugin/ · client-mod/
03

THE ORCHESTRATOR — Node / TS

One event loop: the WS bridge, the brain-selecting AgentManager, the AdkAgent SSE bridge, the WorldStore org-graph, the live dashboard server, the Gemini world-architect, and the omo-tools MCP server that hosts the World API.

runtime/src/
04

THE ORGANISATION — ADK · Python

A real multi-agent system: a Gemini Chief of Staff that delegates to Growth & Comms and hires new specialists on demand. Served by adk api_server; tools arrive over MCP.

omo-agent/
05

THE OUTSIDE WORLD — over MCP

Every tool reaches the agents the same way — over MCP. Real Meta Ads data is live today; Gemini is the brain of every agent. Google Workspace & Stripe MCP are the roadmap.

Meta Ads · Gemini · (Workspace · Stripe)

THE NOVELTY — SELF-EXTENSION

You never wire a thing.
You state intent.

The org declares the function it needs and the world materialises it — every step is just an MCP tool call:

1 · world_describe▸2 · world_add_function▸3 · world_build▸4 · world_staff▸5 · world_assign

★ Plus world_consult — staffed functions ask each other instead of guessing, so the org behaves like a team, not a star of lone workers.

THE THREE ORES THAT POWER OMO

Gemini · ADK · MCP —
each one load-bearing.

◆ GEMINI

the diamond brain

gemini-flash-latest runs the Chief of Staff, every specialist, and the architect that designs each building.

◆ ADK

the emerald org

An LlmAgent coordinator whose sub_agents delegate via transfer_to_agent, streamed token-by-token over /run_sse.

◆ MCP

the golden wires

A Streamable-HTTP server exposes real tools and the World API — so the org grows itself by calling an MCP tool, not by shipping code.

HONEST STATUS

Built today vs roadmap.

Live today — the full ask → build → staff → live-dashboard → revise loop; real Meta Ads data over MCP; Gemini as every agent's brain; the World API self-extension surface; agent-to-agent world_consult.

Roadmap — Google Workspace MCP (Gmail/Drive) and Stripe MCP (worlds-as-businesses), drawn dashed in the schematic.

built & live roadmap MCP Gemini human-in-the-loop
⛏ Run it locally ◀ Back to home