# IterxAI CLI (npm · @iterx/cli)

IterxAI hardware toolchain for AI agents: parts, check, build, flash, sim, preview

- Trust score: 68/100 (medium)
- Change this week: +4
- Registry status: active
- Liveness: live
- Owner verified: no
- Last scored: 2026-11-05

## Components

- npm · `@iterx/cli`: 68/100 (this document), [markdown](https://verifymcp.io/servers/jrenc2002-iterx/iterx-cli.md), [page](https://verifymcp.io/servers/jrenc2002-iterx/iterx-cli)

## Channel facts

- Registry: `npm`
- Package: `@iterx/cli`
- Version: `0.7.0`
- Transport: `stdio`

## Trust breakdown

How this component scores in each security and reliability category. Every signal is checked automatically from public evidence about the published package, including repeated runs of it in an isolated sandbox, 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-11-05.

- **Supply Chain Security**: 100/100
  - No malware found by supply-chain analysis.
  - No known CVEs affecting this package version or its production dependencies.
  - No install/post-install scripts declared.
  - 0 of 1 dependencies flagged as unhealthy.
- **Provenance & Transparency**: 19/100
  - Repository check failed: the declared repository URL returned HTTP 404.
  - Provenance check failed: no build-provenance attestation is published.
  - Clear OSI-approved license (Apache-2.0).
  - Actively maintained (last published 7 days ago).
  - Security-disclosure policy not yet verified: we couldn't inspect the source repository.
- **Schema Quality & AI Usability**: 75/100
  - AI-judged instruction clarity (good).
  - Tool/resource definitions use about 1659 tokens (~97/item across 17 items; 17 tools + 0 resources), lean.
  - Usage-examples check failed: none of the tools include examples.
- **Stability & Change Management**: 30/100
  - Stability observed for 9 of 30 days with no destabilising changes; credit accrues until the full window elapses.
- **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.
- **Tool Safety**: 100/100
  - No prompt-injection markers were found in the server instructions, tool names or descriptions we captured.
  - We read all 17 captured tool definition(s), and no name or description among them implies an irreversible operation.
  - An AI judge read all 18 captured unit(s) of tool text and found none that tries to manipulate the model reading it.
- **Capabilities**: 60/100
  - Spec-recency check failed: implements MCP spec 2025-06-18; the latest is 2026-07-28.

## Install

### How do I install the IterxAI CLI MCP server?

IterxAI CLI runs locally as an npm package, launched with npx -y @iterx/cli. Ready-made configuration for Claude, Cursor, VS Code, Codex and 5 more is on this page, copied from each client's own documentation.

### Claude

```bash
claude mcp add jrenc2002-iterx -- npx -y @iterx/cli
```

### Cursor

```json
{
  "mcpServers": {
    "jrenc2002-iterx": {
      "command": "npx",
      "args": [
        "-y",
        "@iterx/cli"
      ]
    }
  }
}
```

### VS Code

```json
{
  "servers": {
    "jrenc2002-iterx": {
      "command": "npx",
      "args": [
        "-y",
        "@iterx/cli"
      ]
    }
  }
}
```

### Codex

```bash
codex mcp add jrenc2002-iterx -- npx -y @iterx/cli
```

### opencode

```json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "jrenc2002-iterx": {
      "type": "local",
      "command": [
        "npx",
        "-y",
        "@iterx/cli"
      ],
      "enabled": true
    }
  }
}
```

### OpenClaw

```bash
openclaw mcp add jrenc2002-iterx --command npx --arg -y --arg @iterx/cli
```

### Hermes

```yaml
mcp_servers:
  jrenc2002-iterx:
    command: "npx"
    args: ["-y", "@iterx/cli"]
```

### Netclaw

```json
{
  "McpServers": {
    "jrenc2002-iterx": {
      "Transport": "stdio",
      "Command": "npx",
      "Arguments": [
        "-y",
        "@iterx/cli"
      ]
    }
  }
}
```

### Vellum

```bash
assistant mcp add jrenc2002-iterx -t stdio -c npx -a -y @iterx/cli
```

### Other

```json
{
  "mcpServers": {
    "jrenc2002-iterx": {
      "command": "npx",
      "args": [
        "-y",
        "@iterx/cli"
      ]
    }
  }
}
```

## 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-11-05 (score 68, +1)

No change was recorded against any check on this day. Stability & Change Management went from 27 to 30. That category is still filling its 30-day observation window: 8 days of observed history at the previous scan, 9 at this one. The score rises as the window fills, whether or not the server changes.

### 2026-11-03 (score 67, +3)

- [functional improvement] Stability: unverified → 0.23

### 2026-10-28 (score 64, +15)

- [security improvement] Malware scan: unverified → pass

### 2026-10-27 (score 49)

First indexed and scored.

## MCP tools (17)

### `search_parts` (~82 tokens)

Search the IterxAI parts catalog (boards, sensors, actuators). Returns matching parts with ids for get_part.

Input parameters:

- `board` (string): Optional boardId to filter for compatibility.
- `limit` (integer): Max results (default decided by CLI).
- `query` (string, required): Free-text query, e.g. "temperature sensor" or "ESP32".

### `get_part` (~48 tokens)

Get full facts for one part by id (pins, power, libraries).

Input parameters:

- `facts` (array): Optional subset of facts to return.
- `id` (string, required): Part id from search_parts.

### `sync_parts_catalog` (~101 tokens)

Download (or refresh) the signed IterxAI cloud parts catalog (~10 MB, the same catalog the desktop app uses). Call it when search_parts/get_part fail with PARTS_CATALOG_SYNCING or warn PARTS_CATALOG_STALE; it may take a few minutes on a slow link. Needs a signed-in IterxAI account like every iterx tool.

Input parameters:

- `refresh` (boolean): Force a full re-download even if the cache is current.

### `get_help` (~80 tokens)

iterx CLI help as data: without `command`, every command grouped with exit codes, env vars and the JSON envelope; with `command`, its usage, options, examples and notes. Use it to discover CLI-only features (flash, monitor, preview).

Input parameters:

- `command` (string): Optional command name, e.g. "sim" or "parts".

### `create_project` (~179 tokens)

Scaffold a new IterxAI hardware project (iterx.json, selection, netlist, src/main.ino, sim smoke scenario) plus agent config files. Use when the user has no project yet.

Input parameters:

- `board` (string): Board id or alias, e.g. uno, esp32-devkit, esp32-s3, esp32-c3 (see get_rules topic "firmware"). Default arduino-uno.
- `dir` (string, required): New project directory (absolute, or relative to the server cwd).
- `dryRun` (boolean): Only report the files that would be written.
- `harness` (string): Comma-separated agents to configure: codex,claude,trae,workbuddy (default all).
- `name` (string): Project display name.
- `recipe` (string): Starter recipe (default blink).

### `project_status` (~70 tokens)

Project summary: board, selected parts, netlist size, file health, and whether build/receipt.json is fresh or stale. Call first to orient in a project.

Input parameters:

- `projectPath` (string): Absolute path to the IterxAI project directory (contains iterx.json). Defaults to the server cwd.

### `get_rules` (~69 tokens)

Get IterxAI project authoring rules (file layout, wiring, firmware conventions). Read before editing a project.

Input parameters:

- `projectPath` (string): Absolute path to the IterxAI project directory (contains iterx.json). Defaults to the server cwd.
- `topic` (string): Optional rules topic.

### `check_project` (~58 tokens)

Validate an IterxAI project (manifest, selection, netlist, firmware). Errors include a fix hint.

Input parameters:

- `projectPath` (string): Absolute path to the IterxAI project directory (contains iterx.json). Defaults to the server cwd.

### `sync_project` (~53 tokens)

Sync derived project files (selection/netlist/firmware stubs) after edits.

Input parameters:

- `projectPath` (string): Absolute path to the IterxAI project directory (contains iterx.json). Defaults to the server cwd.

### `build_project` (~47 tokens)

Compile the project firmware and write build/receipt.json.

Input parameters:

- `projectPath` (string): Absolute path to the IterxAI project directory (contains iterx.json). Defaults to the server cwd.

### `sim_run` (~101 tokens)

Run the project in the simulator, optionally with a scenario file; assertion failures are reported as errors.

Input parameters:

- `duration` (string): Simulated duration, e.g. "5s" or "2000ms".
- `projectPath` (string): Absolute path to the IterxAI project directory (contains iterx.json). Defaults to the server cwd.
- `scenario` (string): Scenario file path (sim/*.yaml|*.json), relative to the project.

### `ensure_toolchain` (~186 tokens)

Install (or with check:true only report) a verified standalone toolchain: managed arduino-cli + board core + project libraries, plus IterxAI simulator components (QEMU / ESP-EMU) for ESP32 boards. Idempotent; works without the desktop app.

Input parameters:

- `board` (string): Board id (e.g. arduino-uno, esp32-devkit, esp32-c3-generic); defaults to the project board.
- `check` (boolean): Only report what is missing; download nothing.
- `projectPath` (string): Absolute path to the IterxAI project directory (contains iterx.json). Defaults to the server cwd.
- `source` (string): auto (default), arduino (compile toolchain only), iterx (simulator components only) or espressif (simulator components from Espressif's official QEMU release).

### `doctor` (~77 tokens)

One-shot environment report: node, arduino-cli, cores, simulators, network, desktop bridge, login — each problem with a fix command.

Input parameters:

- `board` (string): Optional board id to check.
- `projectPath` (string): Absolute path to the IterxAI project directory (contains iterx.json). Defaults to the server cwd.

### `list_devices` (~18 tokens)

List connected serial devices/boards available for flashing.

### `render_wiring` (~49 tokens)

Render the project wiring diagram and return it as SVG text.

Input parameters:

- `projectPath` (string): Absolute path to the IterxAI project directory (contains iterx.json). Defaults to the server cwd.

### `generate_board` (~215 tokens)

Generate the PCB with the IterxAI desktop board engine (same code as the desktop app; runs headless in the IterxAI runtime when the desktop is closed). mode: prototype adopts the first-version board (run once first), generate (default) lays out, autoroutes, runs DRC and writes Gerber/drill/JLC package, reroute re-routes the saved board, layout only places, board skips the JLC package. Gate failures (e.g. FIRMWARE_REVALIDATION_REQUIRED, PROTOTYPE_REQUIRED) keep the saved board and return error.fix with the next step.

Input parameters:

- `doubleSided` (boolean): Allow components on both board sides.
- `handoffOnly` (boolean): Only rebuild Gerber/JLC files from the saved board.
- `mode` (string): Default generate.
- `process` (string): Copper layers available to the router.
- `projectPath` (string): Absolute path to the IterxAI project directory (contains iterx.json). Defaults to the server cwd.

### `whoami` (~86 tokens)

Show the IterxAI login state. iterx requires an IterxAI account: when logged out (LOGIN_REQUIRED warning) every tool except get_help/whoami/doctor fails until the user runs `iterx login` in a terminal (it opens a browser to register/sign in). Callable without login.

Input parameters:

- `offline` (boolean): Only report the local token state (no network).

## Diagnostics

Captured diagnostic sections: Provenance, Dependencies. The full working is on the page: https://verifymcp.io/servers/jrenc2002-iterx/iterx-cli#diagnostics

## Score history

- 2026-11-05: 68
- 2026-11-04: 67
- 2026-11-03: 67
- 2026-11-02: 64
- 2026-11-01: 64
- 2026-10-31: 64
- 2026-10-30: 64
- 2026-10-29: 64
- 2026-10-28: 64
- 2026-10-27: 49

## Common questions

### What is the IterxAI CLI MCP server?

IterxAI CLI is an MCP server listed in the public MCP registry as io.github.jrenc2002/iterx. IterxAI hardware toolchain for AI agents: parts, check, build, flash, sim, preview. This page covers its npm package (@iterx/cli).

### Is the IterxAI CLI MCP server safe to use?

IterxAI CLI scores 68 out of 100 on VerifyMCP. We found no known CVEs affecting it as of 5 November 2026. It declares no install or post-install scripts. That is a record of what we were able to check automatically, not an endorsement. The category breakdown on this page shows every signal behind the number, including the ones we could not confirm.

### What tools does the IterxAI CLI MCP server expose?

IterxAI CLI exposes 17 tools: search_parts, get_part, sync_parts_catalog, get_help, create_project, and 12 more. Their descriptions and schemas cost roughly 1,519 tokens of context every time the server is loaded.

### Is the IterxAI CLI MCP server still maintained?

IterxAI CLI is still listed as active in the MCP registry. We last reached this channel on 5 November 2026. Those dates come from our own scans of the registry and the channel itself, not from anything the publisher announced.

### What licence is the IterxAI CLI MCP server under?

IterxAI CLI declares the Apache-2.0 licence, which is OSI-approved. That covers the source only, and says nothing about the cost of any service it calls.

## Links

- npm package: https://www.npmjs.com/package/@iterx/cli
- Socket report: https://socket.dev/npm/package/@iterx/cli
- Changelog RSS feed: https://verifymcp.io/servers/jrenc2002-iterx/iterx-cli.xml
- Changelog JSON feed: https://verifymcp.io/servers/jrenc2002-iterx/iterx-cli.json
- HTML version of this page: https://verifymcp.io/servers/jrenc2002-iterx/iterx-cli