# io.roadflow/roadflow (remote · roadflow.io)

Create and edit roadmaps with JSON or markup; share edit and view links from AI agents.

- Trust score: 62/100 (medium)
- Registry status: active
- Liveness: live
- Owner verified: no
- Last scored: 2026-08-03

## Components

- remote · `roadflow.io`: 62/100 (this document), [markdown](https://verifymcp.io/servers/io-roadflow-roadflow/roadflow.md), [page](https://verifymcp.io/servers/io-roadflow-roadflow/roadflow)

## Channel facts

- Endpoint: `https://roadflow.io/mcp`
- Transports: `streamable-http`
- Auth: `none`
- Version: `1.0.0`

## Trust breakdown

How this component scores in each security and reliability category. Every signal is checked automatically against the live server, and we only credit what we can confirm. Scores are 0–100 per category. Scoring method: https://verifymcp.io/docs/scoring (what has changed: https://verifymcp.io/docs/scoring/changelog)

Scored 2026-08-03.

- **Endpoint Security**: 57/100
  - The endpoint's TLS certificate is valid, in date, and uses a strong key.
  - Authorisation not fully verified: no authorisation is required to call this server, and 11 tool(s) never declared a destructiveHint. The MCP spec treats an absent hint as destructive by default, so we cannot call this surface safe.
  - HTTPS is enforced; there's no plaintext access path.
  - HSTS check failed: the Strict-Transport-Security header is absent.
  - DNSSEC check failed: this domain isn't protected by DNSSEC.
- **Transport & Reachability**: 100/100
  - Verified streamable-http transport via a live MCP handshake.
- **Schema Quality & AI Usability**: 71/100
  - AI-judged instruction clarity (good).
  - Tool/resource definitions use about 464 tokens (~42/item across 11 items; 11 tools + 0 resources), lean.
  - Usage-examples check failed: none of the tools include examples.
- **Stability & Change Management**: 0/100
  - Stability not yet verified: not enough scan history yet (needs a 30-day window).
- **Tool Coverage**: 100/100
  - 100% of tools have a non-trivial description (not blank, and not just the tool's name).
  - 100% of tool parameters carry a description.
- **Capabilities**: 100/100
  - Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.

**Unverified: 1 category.** A category scored 0 because we could not verify it: authentication we do not have, an unreachable endpoint, or not enough scan history. We only credit what we can confirm.

## Install

### Claude

```bash
claude mcp add --transport http io-roadflow-roadflow https://roadflow.io/mcp
```

### Codex

```toml
[mcp_servers.io-roadflow-roadflow]
url = "https://roadflow.io/mcp"
```

### opencode

```json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "io-roadflow-roadflow": {
      "type": "remote",
      "url": "https://roadflow.io/mcp",
      "enabled": true
    }
  }
}
```

### OpenClaw

```bash
openclaw mcp add io-roadflow-roadflow --url https://roadflow.io/mcp --transport streamable-http
```

### Hermes

```yaml
mcp_servers:
  io-roadflow-roadflow:
    url: "https://roadflow.io/mcp"
```

### Other

```json
{
  "mcpServers": {
    "io-roadflow-roadflow": {
      "type": "http",
      "url": "https://roadflow.io/mcp"
    }
  }
}
```

The mcpServers block is a cross-client convention. Remote transports vary, so check your client's docs.

## Changelog

Every change recorded for this component, newest first. Days that predate change tracking, or that we cannot explain, say so: "we were watching and nothing happened" and "we were not watching" are different claims.

### 2026-08-03 (score 62)

First indexed and scored.

## MCP tools (11)

### `roadflow_new` (~64 tokens)

New roadflow workspace

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

Input parameters:

- `json`: Optional seed state (same shape as serializeState)
- `markup` (string): Optional friendly markup to apply after seed/empty

### `roadflow_status` (~28 tokens)

Workspace status

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

### `roadflow_get` (~28 tokens)

Get workspace snapshot

Return the current workspace as JSON and/or markup.

Input parameters:

- `format` (string): Default both

### `roadflow_apply_json` (~67 tokens)

Apply JSON state

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

Input parameters:

- `json`: Full or partial map state object, or JSON string
- `merge` (boolean): If true, deep-ish merge timeline/display and replace roads from payload

### `roadflow_apply_markup` (~41 tokens)

Apply markup

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

Input parameters:

- `markup` (string, required): Friendly roadflow markup text

### `roadflow_open_shared` (~49 tokens)

Open shared roadflow

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

Input parameters:

- `id` (string, required): editId or viewId from a share URL (?id=…)

### `roadflow_create_shared` (~90 tokens)

Create 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.

Input parameters:

- `editId` (string): Optional edit id (default: random rm-…)
- `viewId` (string): Optional view id (default: random rm-…)

### `roadflow_export_json` (~20 tokens)

Export JSON

Export the current workspace as JSON (serializeState).

### `roadflow_export_markup` (~18 tokens)

Export markup

Export the current workspace as friendly markup.

### `roadflow_export_csv` (~33 tokens)

Export CSV

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

### `roadflow_discard` (~26 tokens)

Discard workspace

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

## Diagnostics

Captured diagnostic sections: TLS, DNSSEC, Authorisation, Transports. The full working is on the page: https://verifymcp.io/servers/io-roadflow-roadflow/roadflow#diagnostics

## Score history

- 2026-08-03: 62

## Links

- Remote endpoint: https://roadflow.io/mcp
- Changelog RSS feed: https://verifymcp.io/servers/io-roadflow-roadflow/roadflow/changelog.xml
- Changelog JSON feed: https://verifymcp.io/servers/io-roadflow-roadflow/roadflow/changelog.json
- HTML version of this page: https://verifymcp.io/servers/io-roadflow-roadflow/roadflow
