# io.roadflow/roadflow: tool descriptions scored

- tools/list taken: 2026-11-02 (UTC)
- From: [Official MCP Registry](https://registry.modelcontextprotocol.io/v0/servers/io.roadflow%2Froadflow/versions/latest)
- Connected to: https://roadflow.io/mcp
- Scoring rules: v2
- Tools: 43
- Average: 34.1 / 100 (Rain)
- Near-identical pairs: 5

This page shows how io.roadflow/roadflow's tool descriptions scored, the issues found and the names of its tools and parameters. The descriptions are the server's own: read them where the copy came from.

Forecall asked the URL this server lists in the official MCP Registry for its tools/list once, on the date above, without calling any tool. The server may have changed since.

## Across the server

- Major: 43 tools. Above 40, models choose less accurately.
- Minor: The server has no instructions. Say there, once, what the server is for and when to use it: Claude Code and Gemini CLI read the instructions before the tool descriptions.

## Tools

- `model_delete_edge`: 11 / 100
  - Major: The description only restates the name (6 words).
  - Major: The description is too short (6 words).
  - Major: Says nothing about when to use it, or when not to.
  - Major: Arguments without a description: id, edgeId.
  - Minor: String arguments with no constraint or example: id, edgeId.
  - Minor: Says nothing about what it returns.
  - Minor: No constraints, side effects, auth or rate limits described, and no annotations.
  - Major: It may be destructive, but destructiveHint is not set.
  - Minor: Required identifiers whose description does not say where the value comes from: edgeId. Name the tool or the place that returns it, or models look it up first.
- `model_delete_parameter`: 11 / 100
  - Major: The description only restates the name (7 words).
  - Major: The description is too short (7 words).
  - Major: Says nothing about when to use it, or when not to.
  - Major: Arguments without a description: id, parameterId.
  - Minor: String arguments with no constraint or example: id, parameterId.
  - Minor: Says nothing about what it returns.
  - Minor: No constraints, side effects, auth or rate limits described, and no annotations.
  - Major: It may be destructive, but destructiveHint is not set.
  - Minor: Required identifiers whose description does not say where the value comes from: parameterId. Name the tool or the place that returns it, or models look it up first.
- `model_list_parameters`: 15 / 100
  - Major: Says nothing about when to use it, or when not to.
  - Major: Arguments without a description: id, streamId, role, layer, primaryOwner.
  - Minor: String arguments with no constraint or example: id, streamId, role, layer, primaryOwner.
  - Minor: No `required` list, so every argument is optional.
  - Minor: Says nothing about what it returns.
  - Minor: No constraints, side effects, auth or rate limits described, and no annotations.
- `model_list_dictionaries`: 16 / 100
  - Major: Says nothing about when to use it, or when not to.
  - Major: Arguments without a description: id.
  - Minor: String arguments with no constraint or example: id.
  - Minor: No `required` list, so every argument is optional.
  - Minor: Says nothing about what it returns.
  - Minor: No constraints, side effects, auth or rate limits described, and no annotations.
- `model_status`: 16 / 100
  - Major: Says nothing about when to use it, or when not to.
  - Major: Arguments without a description: id.
  - Minor: String arguments with no constraint or example: id.
  - Minor: No `required` list, so every argument is optional.
  - Minor: Says nothing about what it returns.
  - Minor: No constraints, side effects, auth or rate limits described, and no annotations.
- `model_list_edges`: 17 / 100
  - Major: Says nothing about when to use it, or when not to.
  - Major: Arguments without a description: id, fromId, toId, edgeType.
  - Minor: String arguments with no constraint or example: id, fromId, toId.
  - Minor: No `required` list, so every argument is optional.
  - Minor: The description mentions none of its 3 or more arguments.
  - Minor: Says nothing about what it returns.
  - Minor: No constraints, side effects, auth or rate limits described, and no annotations.
- `model_delete_observation`: 18 / 100
  - Major: Says nothing about when to use it, or when not to.
  - Major: Arguments without a description: id, parameterId, scope, scopeKey, setId.
  - Minor: String arguments with no constraint or example: id, parameterId, scopeKey, setId.
  - Minor: Says nothing about what it returns.
  - Minor: No constraints, side effects, auth or rate limits described, and no annotations.
  - Major: It may be destructive, but destructiveHint is not set.
  - Minor: Required identifiers whose description does not say where the value comes from: parameterId. Name the tool or the place that returns it, or models look it up first.
- `model_list_observations`: 19 / 100
  - Major: Says nothing about when to use it, or when not to.
  - Major: Arguments without a description: id, parameterId, setId, evidenceStatus.
  - Minor: String arguments with no constraint or example: id, parameterId, setId, evidenceStatus.
  - Minor: No `required` list, so every argument is optional.
  - Minor: Says nothing about what it returns.
  - Minor: No constraints, side effects, auth or rate limits described, and no annotations.
- `model_patch_project`: 21 / 100
  - Major: Says nothing about when to use it, or when not to.
  - Major: Arguments without a description: id, title, calendar, viewId, streams, axes, phases, parameterSets, chains.
  - Minor: String arguments with no constraint or example: id, title.
  - Minor: No `required` list, so every argument is optional.
  - Minor: Says nothing about what it returns.
  - Minor: No constraints, side effects, auth or rate limits described, and no annotations.
- `model_evaluate`: 22 / 100
  - Major: Says nothing about when to use it, or when not to.
  - Major: Arguments without a description: id, setId, periodId, rangeStart, rangeEnd, slice, parameterIds, includeInputs, includeEmpty.
  - Minor: String arguments with no constraint or example: id, setId, periodId, rangeStart, rangeEnd.
  - Minor: No `required` list, so every argument is optional.
  - Minor: The meaning of the boolean argument includeInputs is unclear.
  - Minor: The meaning of the boolean argument includeEmpty is unclear.
  - Minor: Says nothing about what it returns.
- `model_upsert_edge`: 23 / 100
  - Major: Says nothing about when to use it, or when not to.
  - Major: Arguments without a description: id, edgeId, fromId, toId, edgeType, condition, label, owner, rev.
  - Minor: String arguments with no constraint or example: id, edgeId, fromId, toId, label, owner.
  - Minor: The description mentions none of its 3 or more arguments.
  - Minor: Says nothing about what it returns.
  - Minor: No constraints, side effects, auth or rate limits described, and no annotations.
  - Minor: Required identifiers whose description does not say where the value comes from: edgeId. Name the tool or the place that returns it, or models look it up first.
- `model_upsert_parameter`: 23 / 100
  - Major: Says nothing about when to use it, or when not to.
  - Major: Arguments without a description: id, parameterId, streamId, role, layer, primaryOwner, formula, name, definition, unit, valueType, scopeAxes, priority, canonicalId, domainId, comment, assignedWs, economicClass, qtyParameterId, rateParameterId, rateComponents, adjustmentKind, rev.
  - Minor: String arguments with no constraint or example: id, parameterId, streamId, role, layer, primaryOwner, formula, name, definition, unit, valueType, priority, canonicalId, domainId, comment, assignedWs, economicClass, qtyParameterId, rateParameterId, adjustmentKind.
  - Minor: Says nothing about what it returns.
  - Minor: No constraints, side effects, auth or rate limits described, and no annotations.
  - Minor: Required identifiers whose description does not say where the value comes from: parameterId. Name the tool or the place that returns it, or models look it up first.
- `model_get_parameter`: 28 / 100
  - Major: The description is too short (7 words).
  - Major: Says nothing about when to use it, or when not to.
  - Minor: Arguments without a description: id.
  - Minor: String arguments with no constraint or example: id.
  - Minor: Says nothing about what it returns.
  - Minor: No constraints, side effects, auth or rate limits described, and no annotations.
  - Minor: Required identifiers whose description does not say where the value comes from: parameterId. Name the tool or the place that returns it, or models look it up first.
- `artifacts_export_json`: 31 / 100
  - Major: The description only restates the name (8 words).
  - Major: Says nothing about when to use it, or when not to.
  - Minor: Says nothing about what it returns.
  - Minor: No constraints, side effects, auth or rate limits described, and no annotations.
- `roadflow_export_json`: 31 / 100
  - Major: The description only restates the name (7 words).
  - Major: The description is too short (7 words).
  - Major: Says nothing about when to use it, or when not to.
  - Minor: Says nothing about what it returns.
  - Minor: No constraints, side effects, auth or rate limits described, and no annotations.
- `roadflow_export_markup`: 31 / 100
  - Major: The description only restates the name (7 words).
  - Major: The description is too short (7 words).
  - Major: Says nothing about when to use it, or when not to.
  - Minor: Says nothing about what it returns.
  - Minor: No constraints, side effects, auth or rate limits described, and no annotations.
- `model_upsert_observations`: 34 / 100
  - Major: Says nothing about when to use it, or when not to.
  - Major: Arguments without a description: id, continueOnError.
  - Minor: String arguments with no constraint or example: id.
  - Minor: The meaning of the boolean argument continueOnError is unclear.
  - Minor: No constraints, side effects, auth or rate limits described, and no annotations.
- `model_upsert_parameters`: 34 / 100
  - Major: Says nothing about when to use it, or when not to.
  - Major: Arguments without a description: id, continueOnError.
  - Minor: String arguments with no constraint or example: id.
  - Minor: The meaning of the boolean argument continueOnError is unclear.
  - Minor: No constraints, side effects, auth or rate limits described, and no annotations.
- `roadflow_new`: 34 / 100
  - Major: Says nothing about when to use it, or when not to.
  - Minor: No `required` list, so every argument is optional.
  - Minor: Says nothing about what it returns.
  - Minor: No constraints, side effects, auth or rate limits described, and no annotations.
- `roadflow_apply_markup`: 37 / 100
  - Major: Says nothing about when to use it, or when not to.
  - Minor: Says nothing about what it returns.
  - Minor: No constraints, side effects, auth or rate limits described, and no annotations.
- `artifacts_create_shared`: 38 / 100
  - Major: Says nothing about when to use it, or when not to.
  - Minor: No `required` list, so every argument is optional.
  - Minor: No constraints, side effects, auth or rate limits described, and no annotations.
- `artifacts_get`: 38 / 100
  - Major: The description only restates the name (7 words).
  - Major: The description is too short (7 words).
  - Major: Says nothing about when to use it, or when not to.
  - Minor: No constraints, side effects, auth or rate limits described, and no annotations.
- `artifacts_apply_json`: 39 / 100
  - Major: Says nothing about when to use it, or when not to.
  - Minor: No `required` list, so every argument is optional.
  - Minor: Says nothing about what it returns.
  - Minor: No constraints, side effects, auth or rate limits described, and no annotations.
- `artifacts_new`: 39 / 100
  - Major: Says nothing about when to use it, or when not to.
  - Minor: No `required` list, so every argument is optional.
  - Minor: Says nothing about what it returns.
  - Minor: No constraints, side effects, auth or rate limits described, and no annotations.
- `model_new`: 39 / 100
  - Major: Arguments without a description: title, viewId, streams, axes, phases, parameterSets, chains.
  - Minor: String arguments with no constraint or example: title, viewId.
  - Minor: No `required` list, so every argument is optional.
  - Minor: No constraints, side effects, auth or rate limits described, and no annotations.
- `roadflow_apply_json`: 39 / 100
  - Major: Says nothing about when to use it, or when not to.
  - Minor: No `required` list, so every argument is optional.
  - Minor: Says nothing about what it returns.
  - Minor: No constraints, side effects, auth or rate limits described, and no annotations.
- `artifacts_open_shared`: 40 / 100
  - Major: Says nothing about when to use it, or when not to.
  - Minor: Says nothing about what it returns.
  - Minor: Required identifiers whose description does not say where the value comes from: id. Name the tool or the place that returns it, or models look it up first.
- `model_open`: 40 / 100
  - Major: Says nothing about when to use it, or when not to.
  - Minor: Says nothing about what it returns.
  - Minor: Required identifiers whose description does not say where the value comes from: id. Name the tool or the place that returns it, or models look it up first.
- `roadflow_open_shared`: 40 / 100
  - Major: Says nothing about when to use it, or when not to.
  - Minor: Says nothing about what it returns.
  - Minor: Required identifiers whose description does not say where the value comes from: id. Name the tool or the place that returns it, or models look it up first.
- `artifacts_discard`: 42 / 100
  - Major: Says nothing about when to use it, or when not to.
  - Minor: Says nothing about what it returns.
  - Minor: No constraints, side effects, auth or rate limits described, and no annotations.
  - Major: It may be destructive, but destructiveHint is not set.
- `artifacts_get_version`: 42 / 100
  - Major: Says nothing about when to use it, or when not to.
  - Minor: Says nothing about what it returns.
  - Minor: No constraints, side effects, auth or rate limits described, and no annotations.
- `model_discard`: 42 / 100
  - Major: Says nothing about when to use it, or when not to.
  - Minor: Says nothing about what it returns.
  - Minor: No constraints, side effects, auth or rate limits described, and no annotations.
  - Major: It may be destructive, but destructiveHint is not set.
- `roadflow_discard`: 42 / 100
  - Major: Says nothing about when to use it, or when not to.
  - Minor: Says nothing about what it returns.
  - Minor: No constraints, side effects, auth or rate limits described, and no annotations.
  - Major: It may be destructive, but destructiveHint is not set.
- `roadflow_export_csv`: 42 / 100
  - Major: Says nothing about when to use it, or when not to.
  - Minor: Says nothing about what it returns.
  - Minor: No constraints, side effects, auth or rate limits described, and no annotations.
- `roadflow_get`: 42 / 100
  - Major: Says nothing about when to use it, or when not to.
  - Minor: No `required` list, so every argument is optional.
  - Minor: No constraints, side effects, auth or rate limits described, and no annotations.
- `model_get`: 44 / 100
  - Minor: Arguments without a description: id.
  - Minor: String arguments with no constraint or example: id.
  - Minor: No `required` list, so every argument is optional.
  - Minor: Says nothing about what it returns.
  - Minor: No constraints, side effects, auth or rate limits described, and no annotations.
- `model_upsert_observation`: 44 / 100
  - Major: Arguments without a description: id, parameterId, scopeKey, value, evidenceStatus, valueLocked, valueOverride, rev.
  - Minor: String arguments with no constraint or example: id, parameterId, scopeKey, evidenceStatus.
  - Minor: The meaning of the boolean argument valueLocked is unclear.
  - Minor: The meaning of the boolean argument valueOverride is unclear.
  - Minor: Says nothing about what it returns.
  - Minor: No constraints, side effects, auth or rate limits described, and no annotations.
  - Minor: Required identifiers whose description does not say where the value comes from: parameterId. Name the tool or the place that returns it, or models look it up first.
- `artifacts_status`: 45 / 100
  - Major: Says nothing about when to use it, or when not to.
  - Minor: No constraints, side effects, auth or rate limits described, and no annotations.
- `artifacts_list_versions`: 47 / 100
  - Minor: Says nothing about what it returns.
  - Minor: No constraints, side effects, auth or rate limits described, and no annotations.
- `roadflow_list_versions`: 47 / 100
  - Minor: Says nothing about what it returns.
  - Minor: No constraints, side effects, auth or rate limits described, and no annotations.
- `roadflow_status`: 49 / 100
  - Major: Says nothing about when to use it, or when not to.
  - Minor: No constraints, side effects, auth or rate limits described, and no annotations.
- `roadflow_get_version`: 57 / 100
  - Major: Says nothing about when to use it, or when not to.
  - Minor: No constraints, side effects, auth or rate limits described, and no annotations.
- `roadflow_create_shared`: 59 / 100
  - Minor: No `required` list, so every argument is optional.

Is your server listed here and you would rather it were not? Email support@forecall.dev, and we will take it off within 7 days.

[All scored servers](https://forecall.dev/en/servers)