MCP serverio.roadflow/roadflow

Replace (or merge) the Artifacts graph with normalized JSON. Shared edit mode auto-saves to the cloud.

Persist the current Artifacts workspace to the cloud. Returns editUrl and viewUrl under /artifacts/.

Clear the in-memory Artifacts workspace for this MCP session (does not delete cloud graphs or the Plans workspace).

Export the current Artifacts workspace as JSON (serializeState).

Return the current Artifacts workspace as JSON.

Load one shared Artifacts version by relative index (-1 newest). Optional load=true replaces the MCP workspace (does not save).

List shared Artifacts version checkpoints (newest first). Requires a shared edit workspace.

Create an ephemeral in-memory Artifacts graph workspace. Optional seed JSON (serializeState shape: nodes + labels). No cloud id until artifacts_create_shared.

Load a cloud Artifacts graph by edit or view id. View links are read-only.

Return mode, ids, /artifacts/?id= URLs, and node/label counts.

Delete a manual edge by edgeId.

Delete one fact by parameterId + scope/scopeKey + setId.

Delete a parameter and its observations (cascade).

Unbind the Model project from this MCP session. Does not delete MySQL rows.

Read-only computeModel. Does not write MySQL. View ids allowed. Default period is calendar start (not today). periodId and range* are mutually exclusive. Cell cap 2000.

Hydrate records from MySQL. include=summary (default counts), dictionaries, parameters, observations, edges, or all. Prefer model_upsert_observation to change one fact — do not tre

One catalog row plus its observations (facts).

Streams, axes (members), phases, parameter sets, chains, and calendar. Period members may be derived from calendar.

Manual lineage edges only (SOURCE/FLOW/INTERFACE). FORMULA edges are derived from formulas on load — not stored.

List facts. Filter by parameterId, setId, evidenceStatus. Sets are a column (Base/Downside/Upside), not an axis.

List parameter catalog rows. Optional filters: streamId, role, layer, primaryOwner.

Create a Model project in MySQL (parameter register). Allocates a view id (mv-…) when omitted and returns viewUrl. Optional seed: title, calendar, streams, axes, phases, parameterS

Bind this MCP session to an existing Model project (edit or view id). View ids are read-only.

Update title, calendar, viewId, streams, axes, phases, parameterSets, and/or chains. Send If-Match via rev. Replaces each provided dictionary in full.

Counts, rev, and /model/?id= URLs for the bound project (or pass id).

Create or patch a manual SOURCE, FLOW, or INTERFACE edge. FORMULA is rejected.

Create or replace one fact (parameterId + scope + setId). Example: Base P2 facility MW. Do not write CALC-computed values; only IN facts or CALC overrides (valueOverride). Pass rev

Create or replace many facts (cap 400). Same body shape as model_upsert_observation. Rejects CALC outputs unless valueOverride. continueOnError returns per-row errors; otherwise on

Create or patch one parameter definition (not observations). Pass rev for If-Match on update.

Create or patch many catalog rows (cap 400). Same body shape as model_upsert_parameter. continueOnError returns per-row errors; otherwise one transaction.

Replace workspace state with normalized JSON (serializeState shape). In shared edit mode, saves to the cloud automatically.

Replace roads via friendly markup (same as the editor panel). Shared edit mode auto-saves.

Persist the current workspace to the cloud (permanent share). Returns editUrl (play/edit/share further) and viewUrl (visual canvas, read-only). Prefer viewUrl when the user only ne

Clear the in-memory workspace for this MCP session (does not delete cloud maps).

Export steps as CSV (road, goal, lane, step, notes, type, status, position, date).

Export the current workspace as JSON (serializeState).

Export the current workspace as friendly markup.

Return the current workspace as JSON and/or markup.

Load one shared-map version by relative index (e.g. -1 newest, -2 previous). Returns JSON state. Does not change the live map or workspace unless load=true.

List shared-map version checkpoints (newest first). Relative indexes: -1 = newest. Requires a shared edit workspace (not view-only).

Create an ephemeral in-memory roadflow workspace (default). Optional seed JSON and/or markup. No cloud id until create_shared.

Load a cloud map by edit or view id into this session. View links are read-only.

Return mode, ids, URLs, and road/step counts for the current MCP session workspace.