OpenROAD MCP Server (Python distribution)

A Model Context Protocol (MCP) server that provides tools for interacting with OpenROAD and ORFS (OpenROAD Flow Scripts).

This is the Python distribution, published to PyPI and runnable with uvx. It is one of two interchangeable distributions of openroad-mcp — the other is the Node.js distribution published to npm and runnable with npx. Both expose identical tools and behavior; pick the one that matches your installed runtime.

For the full feature list, client support matrix, configuration examples, and architecture docs, see the main project README and the Quick Start guide.

Requirements

OpenROAD installed and available in your PATH (installation guide)
OpenROAD-flow-scripts (ORFS) for complete RTL-to-GDS flows (optional but recommended)
Python 3.13+ and the uv package manager
- Install uv: curl -LsSf https://astral.sh/uv/install.sh | sh

Configuration (uvx)

{
  "mcpServers": {
    "openroad-mcp": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/The-OpenROAD-Project/openroad-mcp@v0.6.0#subdirectory=python",
        "openroad-mcp"
      ]
    }
  }
}

The pinned @v0.5.5 suffix is recommended for supply-chain safety; drop it to track the latest release.

Local development

This package lives under python/ in the repository. From the repo root:

cd python
uv sync --all-extras --inexact
uv run openroad-mcp --help

Common tasks are wired through the root Makefile (make check, make test, make test-tools, ...). See CONTRIBUTING.md for the full workflow.

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

openroad_mcp-0.6.0.tar.gz (153.5 kB view details)

Uploaded Jul 28, 2026 Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

openroad_mcp-0.6.0-py3-none-any.whl (42.2 kB view details)

Uploaded Jul 28, 2026 Python 3

File details

Details for the file openroad_mcp-0.6.0.tar.gz.

File metadata

Download URL: openroad_mcp-0.6.0.tar.gz
Upload date: Jul 28, 2026
Size: 153.5 kB
Tags: Source
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/6.1.0 CPython/3.13.13

File hashes

Hashes for openroad_mcp-0.6.0.tar.gz
Algorithm	Hash digest
SHA256	`6257fa7738e2a6d4fbaeb274b13b227ba4aaca119bcde0f1f3bdc8ec15495e19`
MD5	`60e73acf9b6dabf09d1cab1a1d3306ab`
BLAKE2b-256	`85aee053b32c38024542a184a4a72a731472d0f1af5e5cd033e73e0b56002247`

See more details on using hashes here.

Provenance

The following attestation bundles were made for openroad_mcp-0.6.0.tar.gz:

Publisher: release.yml on The-OpenROAD-Project/OpenROAD-MCP

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: openroad_mcp-0.6.0.tar.gz
- Subject digest: 6257fa7738e2a6d4fbaeb274b13b227ba4aaca119bcde0f1f3bdc8ec15495e19
- Sigstore transparency entry: 2264054826
- Sigstore integration time: Jul 28, 2026
Source repository:
- Permalink: The-OpenROAD-Project/OpenROAD-MCP@5f2439516c575c02253ebfe3ba90c0c8102fc7f8
- Branch / Tag: refs/tags/v0.6.0
- Owner: https://github.com/The-OpenROAD-Project
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: release.yml@5f2439516c575c02253ebfe3ba90c0c8102fc7f8
- Trigger Event: push