gridoxide-mcp
gridmcp is a Model Context Protocol server for power
networks, built on gridoxide. It lets an LLM chat answer
questions about a network: how big it is, whether it solves, which buses sit furthest from
nominal voltage and which branches carry the most.
It reads MATPOWER cases (.m), UCTE-DEF (.uct), PowSyBl IIDM (.xiidm) and directories of
CGMES profiles. Every tool reads; none writes a file.
| Tool | |
|---|---|
list_networks |
the networks below a directory, with their format |
summary |
size, bus types, voltage levels, tap changers, areas, and what the importer noted |
power_flow |
an AC power flow (Newton-Raphson), optionally with tap control, reactive limits, distributed slack or area interchange: convergence, losses, slack injection, voltage extremes, largest flows |
results |
the buses or branches of the last power_flow, filtered and sorted |
--dir <path> (else GRIDOXIDE_NETWORK_DIR, else the working directory) is where relative
paths resolve.
Install
With uv, nothing needs installing first; clients start it as
uvx --from gridoxide-mcp gridmcp --dir /path/to/networks
or install it once with uv tool install gridoxide-mcp (or pipx install gridoxide-mcp) and
run gridmcp. It is also on crates.io (cargo install gridoxide-mcp) and bundled in the
VS Code extension.
Configure a client
Claude Code (servers start in the project directory, so --dir can be left out):
claude mcp add gridoxide -- uvx --from gridoxide-mcp gridmcp
Codex (~/.codex/config.toml):
[mcp_servers.gridoxide]
command = "uvx"
args = ["--from", "gridoxide-mcp", "gridmcp", "--dir", "/path/to/networks"]
Claude Desktop, Cursor, Windsurf and most others take an mcpServers block:
{
"mcpServers": {
"gridoxide": {
"command": "uvx",
"args": ["--from", "gridoxide-mcp", "gridmcp", "--dir", "/path/to/networks"]
}
}
}
Licence
gridmcp's own code is Apache-2.0. The binary links gridoxide, whose sparse solver is a
translation of SuiteSparse (BSD-3-Clause for AMD, LGPL-2.1-or-later for BTF/KLU); see
gridoxide's docs/src/reference/provenance.md.
1 maintainer
Metadata
1 maintainer
Release files for gridoxide-mcp 0.3.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Built distributions (wheels)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| gridoxide_mcp-0.3.0-py3-none-win_amd64.whl | Python 3 | none | Windows x86-64 | Details for gridoxide_mcp-0.3.0-py3-none-win_amd64.whl |
| gridoxide_mcp-0.3.0-py3-none-manylinux2014_x86_64.manylinux_2_17_x86_64.whl | Python 3 | none | Linux glibc 2.17+ x86-64 | Details for gridoxide_mcp-0.3.0-py3-none-manylinux2014_x86_64.manylinux_2_17_x86_64.whl |
| gridoxide_mcp-0.3.0-py3-none-macosx_11_0_arm64.whl | Python 3 | none | macOS 11.0+ ARM64 | Details for gridoxide_mcp-0.3.0-py3-none-macosx_11_0_arm64.whl |
Total release size: 6.2 MB
Release files / gridoxide_mcp-0.3.0-py3-none-win_amd64.whl
| Download URL | gridoxide_mcp-0.3.0-py3-none-win_amd64.whl |
|---|---|
| Size | 1.9 MB |
| Tags | Python 3 Windows x86-64 |
|
SHA-256 checksum How to use checksums |
8d5e6da439f6bcdcf734708b0898d27d1d7e9632ea84ef8cb197f354daf4ff86
|
|
BLAKE2b-256 checksum How to use checksums |
1361fbaa9632878833476cce95f801e4f7958e62d3a9cfb5972a16eaf8b696e5
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.16
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 30, 2026.
Transparency logRelease files / gridoxide_mcp-0.3.0-py3-none-manylinux2014_x86_64.manylinux_2_17_x86_64.whl
| Download URL | gridoxide_mcp-0.3.0-py3-none-manylinux2014_x86_64.manylinux_2_17_x86_64.whl |
|---|---|
| Size | 2.5 MB |
| Tags | Linux glibc 2.17+ x86-64 Python 3 |
|
SHA-256 checksum How to use checksums |
417dc917141edd230a54d41adc9bba4470f9214b936da612230a9ac00d8e9c2d
|
|
BLAKE2b-256 checksum How to use checksums |
5746fad81db6cb5f8e637677e90b9c9b94a2e9b108e633ccb9690816c1b35e35
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.16
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 30, 2026.
Transparency logRelease files / gridoxide_mcp-0.3.0-py3-none-macosx_11_0_arm64.whl
| Download URL | gridoxide_mcp-0.3.0-py3-none-macosx_11_0_arm64.whl |
|---|---|
| Size | 1.7 MB |
| Tags | Python 3 macOS 11.0+ ARM64 |
|
SHA-256 checksum How to use checksums |
7eb4bb45d47c348fc12ddc08de552969fe79426574b0a9665e610446c1f3ec90
|
|
BLAKE2b-256 checksum How to use checksums |
2c8f3bd71f63b0d55369eda8dd1933f21d55148ddf8add6f07fae386b88a11f7
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.16
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 30, 2026.
Transparency logSecurity for gridoxide-mcp 0.3.0
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
Full provenance
All 3 files in this release have been uploaded with provenance metadata.
Attestation for gridoxide_mcp-0.3.0-py3-none-win_amd64.whl
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 30, 2026.
Transparency logA note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.
