Openroad MCP

Install

Works with Claude Code, Codex, VS Code, Cursor, Windsurf, Claude Desktop. Read the repository before you give any tool access to your data.

npx agentmarket install connector/luarss-openroad-mcp

About

No reviews yet. Installed it? Reviews come from verified installers only. How reviews work

Permissions

What this server can do and what it asks for, from its tool list, install config and code. Checked Oct 25, 2026.

Tools

10 read · 1 write · 4 delete

Secrets

None asked for

Install scripts

Runs code on install

Runs as

Python package

Tools (15)

Read from the source code; the running server may differ. Descriptions are the server’s own words; hidden characters are shown as [U+…].

• cancel_orfs_jobcan change or delete data

  Terminate a running flow job and every process it spawned, so no orphaned openroad process is left behind.

• create_interactive_session

  Create a new interactive OpenROAD session.

• get_orfs_jobread-only

  Poll a flow run started by run_orfs_stage: status, elapsed time, the ORFS stage currently executing, detailed-route iteration and live DRC violation count, CPU and memory, and the tail of the run log. Once the run succeeds it also carries the parsed stage metrics. Omit job_id to list every run. For a QoR verdict, call read_orfs_metrics with check_qor.

• get_session_historyread-only

  Get command history for an interactive OpenROAD session.

• get_session_metricsread-only

  Get comprehensive metrics for all interactive OpenROAD sessions.

• grep_session_outputread-only

  Search the output of commands already run in a session, without re-running them or re-sending a large result. `pattern` is a regular expression, falling back to a substring search if it does not compile. Use `context_lines` to see surrounding lines and `command_number` to search one command's output. Only recent output is retained (OPENROAD_OUTPUT_HISTORY_CHARS, default 256 KB); the result reports how much was searched and whether older output has been evicted.

• inspect_interactive_sessionread-only

  Get detailed inspection data for an interactive OpenROAD session.

• interactive_openroad_execcan change or delete data

  Execute a state-modifying OpenROAD command (set_*, create_*, read_*, write_*, flow commands). Use this for loading designs, running placement/routing, applying constraints, and writing output files. Only the BLOCKED_COMMANDS list (quit, socket, load, glob, etc.) is rejected; read-only commands such as report_* are also accepted here. Use interactive_openroad_query instead for queries to keep state changes visible and auditable. Results carry `truncated`, `bytes_discarded` and `total_bytes`: when `truncated` is true the output lost its beginning to the session buffer and is a PARTIAL answer, so…

• interactive_openroad_queryread-only

  Execute a read-only OpenROAD command (report_*, get_*, check_*, sta, help, etc.). Use this for querying design state, generating reports, and inspecting timing. Commands that modify design state are blocked — use interactive_openroad_exec instead. Results carry `truncated`, `bytes_discarded` and `total_bytes`: when `truncated` is true the output lost its beginning to the session buffer and is a PARTIAL answer, so do not treat it as complete — narrow the command and re-run.

• list_interactive_sessionsread-only

  List all active interactive OpenROAD sessions.

• list_report_imagesread-only

  List available report images from ORFS runs organized by stage.

• read_orfs_metricsread-only

  Read an ORFS design's per-stage metrics and the tagged errors/warnings from each stage log. Set `check_qor` to also send the selected stages' metrics to the public QoR dashboard and get its verdict against the latest master build (`qor_check`: status, baseline, totals, failing metrics). Use `stage: all` to send every stage's metrics. Platforms outside the public ORFS list are not sent and come back `inconclusive`; an unreachable dashboard is `unreachable`, not a failure. Prefer this over shelling out to find/cat/jq/grep in the flow tree. `stage` accepts a step name (cts, place, route, floorpla…

• read_report_imageread-only

  Read a report image (congestion, IR-drop, placement, clock tree) and return it as a viewable image alongside its metadata. Optionally pass max_size_kb to override the configured base64 budget for this call; larger budgets keep more detail in heatmaps.

• run_orfs_stagecan change or delete data

  Run an ORFS flow stage (synth, floorplan, place, cts, grt, route, finish, or a clean_* target) via make, streaming output to a file rather than the session buffer. Returns a job_id immediately so a multi-hour route does not block the call; pass wait_seconds to get the finished result inline when the stage is short. `overrides` become make command-line assignments (e.g. {"CTS_CLUSTER_SIZE": "20"}), which take precedence over both the environment and the Makefile. Poll with get_orfs_job for live progress, and the parsed stage metrics once it finishes. Set dry_run to see what make would do withou…

• terminate_interactive_sessioncan change or delete data

  Terminate an interactive OpenROAD session.

Signals

Stars

30

Forks

11

Open issues

1

Contributors

9

Weekly downloads

36

Last commit

Oct 23, 2026 (6 days ago)

Last release

Aug 26, 2026 (2 months ago)

Last package publish

Jul 30, 2026 (3 months ago)

From GitHub (fetched Oct 24, 2026) and the package registry.

Details

Registry name

io.github.luarss/openroad-mcp

Version

0.5.3

Auth

No auth

Packages

pypi openroad-mcpoci ghcr.io/luarss/openroad-mcp:0.5.3

License

BSD-3-Clause

Repository

github.com/luarss/openroad-mcp

First seen

Oct 24, 2026

Last checked

Oct 24, 2026

Source

Official MCP Registrygithub-graphql