roadflow_new
New roadflow workspace
Create an ephemeral in-memory roadflow workspace (default). Optional seed JSON and/or markup. No cloud id until create_shared.
jsonmarkupio.roadflowPublished by roadflow.ioOfficial publisherv1.0.0Updated Oct 24, 2026
Create and edit roadmaps with JSON or markup; share edit and view links from AI agents.
Lets an assistant create and edit roadmaps and produce shareable edit or view links.
Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.
Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.
Read https://sourceweft.com/mcp/io.roadflow%2Froadflow/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.Add this to your client's mcpServers config.
{
"mcpServers": {
"roadflow": {
"type": "http",
"url": "https://roadflow.io/mcp"
}
}
}New roadflow workspace
Create an ephemeral in-memory roadflow workspace (default). Optional seed JSON and/or markup. No cloud id until create_shared.
jsonmarkupWorkspace status
Return mode, ids, URLs, and road/step counts for the current MCP session workspace.
Takes no parameters.
Get workspace snapshot
Return the current workspace as JSON and/or markup.
formatApply JSON state
Replace workspace state with normalized JSON (serializeState shape). In shared edit mode, saves to the cloud automatically.
jsonmergeApply markup
Replace roads via friendly markup (same as the editor panel). Shared edit mode auto-saves.
markuprequiredOpen shared roadflow
Load a cloud map by edit or view id into this session. View links are read-only.
idrequiredCreate shared roadflow
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 needs to see the map.
editIdviewIdExport JSON
Export the current workspace as JSON (serializeState).
Takes no parameters.
Export markup
Export the current workspace as friendly markup.
Takes no parameters.
Export CSV
Export steps as CSV (road, goal, lane, step, notes, type, status, position, date).
Takes no parameters.
List version history
List shared-map version checkpoints (newest first). Relative indexes: -1 = newest. Requires a shared edit workspace (not view-only).
Takes no parameters.
Get version snapshot
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.
relrequiredloadDiscard workspace
Clear the in-memory workspace for this MCP session (does not delete cloud maps).
Takes no parameters.
New Artifacts workspace
Create an ephemeral in-memory Artifacts graph workspace. Optional seed JSON (serializeState shape: nodes + labels). No cloud id until artifacts_create_shared.
jsonArtifacts workspace status
Return mode, ids, /artifacts/?id= URLs, and node/label counts.
Takes no parameters.
Get Artifacts graph
Return the current Artifacts workspace as JSON.
Takes no parameters.
Apply Artifacts JSON
Replace (or merge) the Artifacts graph with normalized JSON. Shared edit mode auto-saves to the cloud.
jsonmergeOpen shared Artifacts graph
Load a cloud Artifacts graph by edit or view id. View links are read-only.
idrequiredCreate shared Artifacts graph
Persist the current Artifacts workspace to the cloud. Returns editUrl and viewUrl under /artifacts/.
editIdviewIdExport Artifacts JSON
Export the current Artifacts workspace as JSON (serializeState).
Takes no parameters.
List Artifacts version history
List shared Artifacts version checkpoints (newest first). Requires a shared edit workspace.
Takes no parameters.
Get Artifacts version snapshot
Load one shared Artifacts version by relative index (-1 newest). Optional load=true replaces the MCP workspace (does not save).
relrequiredloadDiscard Artifacts workspace
Clear the in-memory Artifacts workspace for this MCP session (does not delete cloud graphs or the Plans workspace).
Takes no parameters.
New Model register
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, parameterSets, chains, parameters, observations, edges. Does not persist CALC outputs or FORMULA edges. Binds this MCP session. UI: /model/?id=…
axesedgestitlechainsphasesviewIdstreamscalendarparametersobservationsparameterSetsOpen Model register
Bind this MCP session to an existing Model project (edit or view id). View ids are read-only.
idrequiredModel register status
Counts, rev, and /model/?id= URLs for the bound project (or pass id).
idGet Model register
Hydrate records from MySQL. include=summary (default counts), dictionaries, parameters, observations, edges, or all. Prefer model_upsert_observation to change one fact — do not treat this as a blob to rewrite.
idincludeDiscard Model session
Unbind the Model project from this MCP session. Does not delete MySQL rows.
Takes no parameters.
Patch Model dictionaries
Update title, calendar, viewId, streams, axes, phases, parameterSets, and/or chains. Send If-Match via rev. Replaces each provided dictionary in full.
idrevaxestitlechainsphasesviewIdstreamscalendarparameterSetsList parameters
List parameter catalog rows. Optional filters: streamId, role, layer, primaryOwner.
idrolelayerstreamIdprimaryOwnerGet parameter
One catalog row plus its observations (facts).
idparameterIdrequiredUpsert parameter catalog
Create or patch one parameter definition (not observations). Pass rev for If-Match on update.
idrevnameroleunitattrslayercommentformuladomainIdprioritystreamId+12 moreBulk upsert parameters
Create or patch many catalog rows (cap 400). Same body shape as model_upsert_parameter. continueOnError returns per-row errors; otherwise one transaction.
idparametersrequiredcontinueOnErrorDelete parameter
Delete a parameter and its observations (cascade).
idparameterIdrequiredList observations
List facts. Filter by parameterId, setId, evidenceStatus. Sets are a column (Base/Downside/Upside), not an axis.
idsetIdparameterIdevidenceStatusUpsert observation
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 for If-Match.
idrevscopesetIdvaluesourcescopeKeyparameterIdrequiredvalueLockedvalueOverrideevidenceStatusBulk upsert observations
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 one transaction.
idobservationsrequiredcontinueOnErrorDelete observation
Delete one fact by parameterId + scope/scopeKey + setId.
idscopesetIdscopeKeyparameterIdrequiredList edges
Manual lineage edges only (SOURCE/FLOW/INTERFACE). FORMULA edges are derived from formulas on load — not stored.
idtoIdfromIdedgeTypeUpsert edge
Create or patch a manual SOURCE, FLOW, or INTERFACE edge. FORMULA is rejected.
idrevtoIdlabelowneredgeIdrequiredfromIdedgeTypeconditionDelete edge
Delete a manual edge by edgeId.
idedgeIdrequiredEvaluate Model compute
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.
idsetIdsliceperiodIdrangeEndrangeStartincludeEmptyparameterIdsincludeInputsList dictionaries
Streams, axes (members), phases, parameter sets, chains, and calendar. Period members may be derived from calendar.
id83% of the applicable checks met
How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.
Declare a GitHub repository with a README, or serve resource_documentation in the OAuth protected-resource metadata.
A hosted service is used under its provider's terms, so no license is expected here. This check is left out of the percentage.