AI Agent Architecture | MCP, RAG & Agentic Stack

Workflow Architecture

Real-time path from click to live revenue.

Four runtime lanes orchestrated by the MCI AI Gateway. Every interaction — agent edit, eval, deploy, sale — emits a live event consumed by the workspace, mentors and the public portfolio.

Lane 1

User Layer

01.01

Sign-In & Identity

SSO / email OTP issues a Builder ID + workspace token. Realtime presence joins the cohort channel.

01.02

Track Picker

User selects a build track. Workspace clones template, provisions repo, vector index and sandbox URL.

Lane 2

Workspace Runtime

02.01

Agent / App Studio

Drag-drop canvas streams diff events over WebSocket — every node change re-renders preview in <300ms.

02.02

Live Co-Build Room

CRDT-synced canvas, shared cursors, voice and an AI pair-programmer that watches the diff stream.

02.03

Sandbox Test Console

Run prompts, replay traces, score evals. Token, latency and cost stream live into the side panel.

Lane 3

MCI AI Gateway

03.01

Auth + Key Vault

Routes BYO keys or MCI-managed credits. Per-request signing, scoped tokens, per-team rate limits.

03.02

Model Router & Meter

LiteLLM/Portkey-style fan-out across OpenAI, Claude, Gemini, Groq. Usage events streamed to billing + observability.

03.03

Tools / MCP / Webhooks

Function calls, MCP servers, browser agents and N8N triggers — bi-directional with retry + dead-letter queue.

Lane 4

Deploy & Monetize

04.01

One-Click Deploy

CI builds container, pushes to Vercel/Railway/Modal. Public URL + SSL + analytics provisioned in seconds.

04.02

Live Observability

LangSmith/Helicone hooks stream traces, evals, hallucination scores and revenue back to the dashboard.

04.03

Marketplace & Billing

Publish endpoint, set pricing tier, Stripe subscriptions, revenue share, lead-gen inbox.

04.04

Builder Portfolio

Public profile auto-updates with shipped agents, demos, metrics and team contributions.

Real-Time Channels

Six event streams that keep every surface in sync.

WebSocket presence
Workspace + cohort channels via Supabase Realtime.
CRDT canvas sync
Yjs document per project — multi-user agent editing.
Streaming inference
SSE token stream from gateway → studio preview.
Live trace bus
Eval, latency, token and cost events pushed to dashboard.
Webhook fan-out
Tool calls + N8N triggers with retry + DLQ.
Deploy pipeline events
Build → ship → health checks broadcast to portfolio.

// end-user interaction loop

user.action ─▶ studio.canvas (CRDT)
        │
        ▼
   gateway.route ──▶ model.stream (SSE)
        │                  │
        ├─▶ usage.meter    ├─▶ preview.render
        ├─▶ eval.bus       └─▶ trace.bus
        ▼
   deploy.pipeline ──▶ portfolio.publish
        │                       │
        └─▶ billing.event ──▶ marketplace.live