ContextForge

ContextForge is the observability and operator hub for ContextUnity. It replaces the former ContextView and ContextWorkshop services with one Starlette dashboard process and one standalone FastMCP process.

Trace Observability

Search execution traces, inspect graph steps, and review tool calls persisted through ContextBrain.

Brain Admin

Browse tenants, memory layers, episodes, knowledge nodes, analytics summaries, and filter metadata through Brain Admin gRPC.

Agent Store

Manage dashboard-local agent records and hierarchy views backed by Forge’s local AgentStore.

MCP Tools

Use observability, docs, ingestion, and devtools from Cursor or other MCP clients.

Processes

ContextForge runs as two separate processes:

# Starlette dashboard on 127.0.0.1:8300 by default
uv run --package contextunity-forge python -m contextunity.forge

# MCP stdio transport
uv run --package contextunity-forge python -m contextunity.forge mcp

# MCP HTTP/SSE transport on 127.0.0.1:8301 by default
uv run --package contextunity-forge python -m contextunity.forge mcp --http

Architecture

Forge does not query Brain’s database directly. Dashboard and MCP observability tools call Brain Admin RPCs through BrainAdminClient; dashboard-local agent records live in Forge’s local SQLite AgentStore.

Dashboard Views

View	URL	Description
Overview	/	KPIs, service status, trace and memory summaries
Traces	/traces/	Searchable execution trace list
Trace Detail	/traces/{trace_id}/	Step-by-step trace inspection
Agents	/agents/	Dashboard-local agent record list
Agent Detail	/agents/{pk}/	Agent metadata, activity, and related traces
Agent Hierarchy	/agents/hierarchy/	Hierarchy view built from trace and agent relationships
Events	/events/	Event search
Event Detail	/events/{event_id}/	Single event view
Memory	/memory/	Memory layer statistics
Memory Events	/memory/events/	Episodic event search
Grid Preferences	/grid/preferences/	GridViewSpec preference persistence API
Charts	/api/chart-data/	Dashboard chart data API

MCP Tool Surface

Forge MCP registers:

• Observability tools: search_traces, get_trace_details, list_tenants, get_filter_options, get_analytics_summary, get_system_analytics, get_cells, get_memory_layer_stats, search_episodes.
• DevTools: run_ruff, run_tests, list_services, get_service_structure, get_service_fulldoc.
• Docs tools: search_docs, get_doc, list_docs, doc_stats.
• Ingestion tools: refresh_docs, check_staleness, cleanup_stale.

HTTP/SSE MCP binds loopback by default and requires CU_FORGE_MCP_BEARER unless FORGE_MCP_INSECURE=1 is explicitly set for a controlled environment.