NetOps Helper
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
NetOps
Let your AI assistant work on your network — with guardrails, not a root shell.
NetOps is a self-hosted MCP server that gives Claude Code, Codex or any other MCP client controlled access to your network devices. The assistant can troubleshoot, audit configurations and make small, reversible changes. It never sees a device password, never gets a free-form CLI and never touches a device you did not enroll.
Troubleshoot faster. Read-only checks on FortiGate, FortiADC, Cisco, Juniper, Arista, ExtremeXOS, Ruckus Unleashed and Linux: a vetted query catalogue, the same normalized tables (interfaces, VLANs, MAC, ARP, LLDP, routes, OSPF, BGP, LAG, STP) on the switches and routers of six operating systems, endpoint location across several devices, FortiGate Wi-Fi client and flow diagnostics, and guided triage of FortiGate health, routing and IPsec VPN and of FortiADC load balancing. Every finding cites the device output it came from.
Audit configurations. Rule catalogues for FortiOS (including CIS FortiGate Benchmark checks), ExtremeXOS and FortiADC, with text, JSON or SARIF output.
Change safely. Admin changes on FortiOS (firewall policies, addresses, DHCP reservations), ExtremeXOS (VLANs, ports), Cisco IOS, IOS XE and NX-OS, Arista EOS and Juniper Junos (interface description, admin state, access VLAN) run behind an on-device safeguard that undoes the change by itself if NetOps cannot confirm it. FortiADC pool-member changes use the same preview, enrollment and audit path; Admin returns an unconfirmed one with an inverse write, because FortiADC has no on-device timed return.
Know what happened. Every request is written to the audit before it reaches a device; if the audit cannot be written, nothing runs.
Trust what you install. One image for amd64 and arm64 with a Sigstore-signed checksum list, SBOMs and written vulnerability assessments.
NetOps is an independent, open-source, multi-vendor tool. It is not a product of any vendor whose devices, software or MCP clients it supports or names, and it is not affiliated with, endorsed by or supported by any of them; see the disclaimer.
The image contains no AI agents. Any MCP client that supports Streamable HTTP with a bearer token and verifies TLS normally can connect; the quickstart covers Claude Code and Codex. See Tested MCP clients for the dated results and earlier release history.
Start here: NetOps 1.0 quickstart
What's new in 1.0.11
NetOps 1.0.11 follows NetOps 1.0.10. It removes the remaining conversion paths for data from before NetOps 1.0, returns a failed Junos change at once with a plain commit that the device timer cannot undo and describes an installation without sudo rights. Only 1.0.10 is accepted as the previous release; upgrade 1.0.9 to 1.0.10 first (upgrade guide).
Admin Junos immediate return. After a failed write or readback, Admin commits the inverse lines with a plain commit (
netops-<id>-revert) instead ofcommit confirmed, so an interrupted return no longer lets the device timer bring the change back. After a Junos operation of 1.0.10 that endedrevert-failedorunknown, check the port as described in the manual check of the Admin configuration.Conversions from before NetOps 1.0 removed. The Auditor commands
auditor migrate-storeandauditor migrate-suppressionsare removed, and a store or suppression file in the format before NetOps 1.0 is refused before any write. Admin refuses a plan written by Admin 0.x (plan content does not match its plan_sha256); run a new preview.Quickstart without sudo. Docker and
jqare set up by the host administrator, and cosign is installed as a program of the own account in~/.local/bin.Upgrade. Upgrade only from 1.0.10 by restoring its backup into a separate 1.0.11 instance; do not run
initon the restored state. Enrollments made with 1.0.10 stay valid: a device needsadmin enrollagain only when its device entry, its accounts, its firmware or the Admin notification or status file settings change.
See the 1.0.11 release notes and the changelog. The sections for 1.0.10, 1.0.9, 1.0.8 and 1.0.7 below are kept as history.
Related MCP server: NetContext MCP
What's new in 1.0.10
NetOps 1.0.10 follows NetOps 1.0.9. It brings Arista EOS, FortiADC, Cisco IOS, IOS XE, NX-OS and Juniper Junos into the common Admin, makes FortiOS config_diff line-based, binds Admin plan_sha256 to the device and firmware, runs the Auditor store in WAL mode, tightens the ExtremeXOS PoE cycle safeguard budget and recover, and hides typed Cisco-style hashes and whole account values in responses while keeping everything that 1.0.8 hid hidden. Only 1.0.9 is accepted as the previous release; upgrade 1.0.8 to 1.0.9 first (upgrade guide).
Admin for Cisco IOS, IOS XE and NX-OS, Juniper Junos and Arista EOS. Admin supports Cisco IOS 15.x and IOS XE 17.x (platforms
iosandiosxe), Cisco NX-OS 9.3(12) (platformnxos), Juniper Junos 26.2R1.7 on ELS switches (platformjunos) and Arista EOS (cEOSLab 4.36.1F) through the shared Admin path: preview withplan_sha256, enrollment, journal and audit, check-account readback, undo, recover and the existing MCP tools (no new tool). Operations: interface description, admin state and access VLAN (on Cisco IOS and IOS XE the access VLAN only on the switch images). Each change runs under a device-side safeguard: the IOS/IOS XE revert timer, an NX-OS checkpoint with a one-timefeature schedulerjob, Junoscommit confirmed 10and the EOS configuration sessioncommit timer. These were measured in the GNS3 lab only, through the operator command line; the MCP tools were not called live (release notes).Admin for FortiADC through MCP. Admin supports FortiADC (load-balance pool member state, add and remove) through the shared Admin path: preview with
plan_sha256, enrollment, journal, audit, check-account readback, undo, recover and doctor; Admin MCP execution covers the FortiADC profiles (FortiADC bounds). FortiADC 7.6.7 has no on-device timed return, so an unconfirmed write is reverted by Admin itself with an inverse write in the same run, or byadmin recoverafter an interruption.Response redaction. Response redaction hides typed Cisco-style hashes and whole account values, for example the hash in Arista EOS
enable password sha512 <hash>. Every character that the released 1.0.8 redaction hid stays hidden on every path to the AI client, also in diagnostic output cut tomax_bytes; where the current chain cannot keep a JSON document's structure safely, the output is withheld (security note).Admin approvals and ExtremeXOS. Admin
plan_sha256of profile plans now includes the device alias, platform and firmware, so a plan approved for one device or firmware is refused (plan_changed) on another. An ExtremeXOS PoE cycle needssafeguard_secondsof at least 221 with the default margin 45, and enabling an ExtremeXOS port is refused where disabling it is refused.FortiOS
config_diffand Auditor store. FortiOSconfig_diffuses the line comparison (Myers) of the other platforms instead of positional comparison; FortiADC keeps positional comparison. The Auditor store runs in SQLite WAL mode; the first writer open converts an existing store once, andstore.sqlite-wal/-shmbelong to the store and to its backup.Upgrade and re-enrollment. Upgrade only from 1.0.9 by restoring its backup into a separate 1.0.10 instance; do not run
initon the restored state. Re-enroll every Admin device (admin enroll), FortiOS and ExtremeXOS included, before its first change after the upgrade: every 1.0.9 enrollment is refused withenrollment_required. Approvedplan_sha256values from a 1.0.9 preview do not pass after the upgrade; run a new preview.Acceptance of the release candidate. The MCP client checks, the installation by following the quickstart, the upgrade check from 1.0.9 and the release scan are part of the acceptance of the signed release candidate. The release notes describe the required checks and do not assert that publication acceptance has passed.
See the 1.0.10 release notes and the changelog. The sections for 1.0.9, 1.0.8 and 1.0.7 below are kept as history.
What's new in 1.0.9
NetOps 1.0.9 follows NetOps 1.0.8. It adds configuration captures and config_diff for ExtremeXOS, Cisco and Arista, FortiOS IPv6 route lookup and multi-VDOM reads, NX-OS vPC and EOS/EXOS MLAG views, ExtremeXOS optics and chassis summaries, Wi-Fi AP backhaul correlation and FortiADC schedule-pool triage. The Auditor gains findings_summary and collection while NetOps runs; Admin gains expected_plan_sha256, admin_undo_preview, the measured FortiOS firewall service custom profile and ExtremeXOS port admin-state and PoE cycles. Upgrading from 1.0.8 needs no inventory or credential change; only 1.0.8 is accepted as the previous release (upgrade guide).
Configuration captures and
config_diffon ExtremeXOS, Cisco and Arista. Configuration captures add narrowly gated ExtremeXOS, Cisco IOS, IOS XE, NX-OS and Arista EOS full views; each requires explicit configuration access, a supported live identity and device permission for the fixed command, and device refusal returnsdevice-refused, never an empty snapshot (identities and account requirements).config_diffcompares snapshots on those five platforms with a shortest line edit script (Myers), refuses oversized comparisons withconfig_diff_limit_exceededand does not compare hidden content (hidden_lines_compared: false). FortiOS/FortiADC retain positional comparison.FortiOS multi-VDOM reads. Catalogue, normalized-table and routing/VPN/health triage reads verify the session VDOM and context, label
data_scope, and fail closed on ambiguous identity, context or interface ownership; only the enrolled current VDOM is read. A per-VDOM administrator logged in through an interface of its VDOM reads that VDOM directly once the device proves the login context (verified live on the FortiGate-60F 7.6.8 build3744 on 2026-11-15, task 222, source 7bec0b7, 112/112 checks passed). Multi-VDOMconfig_readwithredaction="minimal"andtriage_flowremain unsupported (scope and refusals).More Helper reads. FortiOS
ipv6_route_lookupadds scoped IPv6 destination lookup. NX-OS vPC and EOS/EXOS MLAG summaries and members accompany the fixedssh_readcatalogue queries; they are notswitch_readtables. ExtremeXOS optics/DOM and chassis summaries expose the measured metrics and partial evidence; physical DOM evidence is limited to the X440G2-12p-10G4 on 33.7.1.6-patch1-11 (two switches, one LX 1310 nm SFP each, read-only capture of 2026-11-13 23:42 UTC, task 64).Wi-Fi backhaul and FortiADC schedules. Helper can correlate a tunneled Wi-Fi client with its AP/radio and the AP's switch backhaul; the switch port belongs to the AP, not to the tunneled client. FortiADC SLB triage follows
schedule-listthrough schedule-pool and schedule-group views and returns sourced candidate pools without claiming an active pool or backend health; schedule-window activity is not calculated.Auditor while NetOps runs.
collect,runandstatuswork throughdocker compose execwhile NetOps runs, and a private store lock serializes writers; configuration and imports still require the stopped instance.findings_summaryreturns brief last-run findings across devices with severity/state/rule filters; it has no paging or historical detail.Admin.
expected_plan_sha256optionally binds apply to the approved preview, andadmin_undo_previewand CLIadmin undo --previewshow checks and impact without applying undo. Opt-in FortiOSfirewall service customsupports create/update/delete and undo, measured end-to-end on 7.6.8 build3744 (cli-script) and 8.0.2 build0251 HA (webhook) on 2026-11-14 (tasks 168, 177 and 180). ExtremeXOS portadmin-stateupdates and operator-only PoE cycles use the persistent UPM safeguard, measured only on 33.7.1.6-patch1-11 on X435-8P-4S/X440G2 (2026-11-14, tasks 171 and 184). Admin writes for Junos, Arista and Cisco are deferred to 1.0.10.Base image and dependencies. The pinned Python/Alpine base digest and compatible dependencies (FastMCP 4.1.3, PySNMP 7.1.32, cryptography 50.0.2) are refreshed. This does not claim that every dependency vulnerability is fixed or that release scans/signatures are complete.
See the 1.0.9 release notes and the changelog. The sections for 1.0.8 and 1.0.7 below are kept as history.
What's new in 1.0.8
NetOps 1.0.8 follows 1.0.7 on the same install, enrollment and audit procedures. It adds two daily-work reads, fixes FortiOS route and VLAN parsing, hardens the Auditor store and the HTTP response readers, and states the minimum requirements and the platforms on which the installation was run. Upgrading from 1.0.7 needs no inventory or credential change (upgrade guide).
CDP neighbours.
switch_read(table="cdp_neighbor")returns the CDP neighbours of Cisco IOS, IOS XE and NX-OS from the opt-incdp_neighborsquery: local port, full Device ID, neighbour port, management IP, platform and capabilities.Linux tables.
switch_readreturns interfaces (state, MAC; MTU for one enrolled interface), IP addresses with MAC and default gateway, IPv4 routes, ARP/ND neighbours and the bridge forwarding table of a Linux host, andlocate_endpointreads the Linux neighbour and bridge tables. A neighbour is never reported as a switch port: when a Linux host has the endpoint as a neighbour but no matching bridge port, the result staysincompleteunless another enrolled switch locates the endpoint.FortiOS routes and VLANs. Recursive BGP next hops, summary and Null routes, the route codes of FortiOS 7.6 and 8.0 and VLAN interfaces with
config ipv6are parsed instead of reported as unparsed.Tunnel-mode Wi-Fi clients. A Wi-Fi client of a tunnel-mode SSID (the SSID default) is expected not to be learned on the switches between its access point and controller because its traffic is carried in CAPWAP to the FortiGate;
locate_endpointthen reports it as not found in the checked data. Usewifi_clientsorwifi_triageto identify the access point, then locate the access point through LLDP or its MAC. In the recorded run the client's MAC was absent from both checked switch FDBs; the cause of that absence was not established.Stricter HTTP response handling and Auditor store. The Wi-Fi REST reader (Helper) and the FortiOS REST collector (Auditor) refuse a chunk-size line that is not plain hexadecimal, which the Python 3.14.10 standard library still accepts (CVE-2026-103995); the Auditor checks the type of every expected schema object of a store. Admin
doctorreads the journal once per request in its local checks.Requirements and platforms. Minimum requirements (1 vCPU, 2 GiB RAM, 2 GiB disk,
NETOPS_CPUS=1on a one-CPU host) and Supported platforms: the quickstart procedure was run on Ubuntu 24.04 and 26.04, on rootless Docker (Ubuntu 24.04, Debian 13) and on Raspberry Pi OS 64-bit, including physical arm64 hardware.Open dependency findings. Some findings remain in the pinned base image. Depending on the finding, no fixed Python 3.14 release was available, the upstream fix is not yet packaged in Alpine 3.24, or no fix is released at all (the
sqlite3shell finding). NetOps lists them with written assessments instead of claiming they are gone (details).
See the 1.0.8 release notes and the changelog. Everything introduced by 1.0.7 (switch and router tables, locate_endpoint, Wi-Fi diagnostics, triage_flow) remains available and is described below; the 1.0.8 changes to it are listed above.
What's new in 1.0.7
NetOps 1.0.7 is the largest extension of the Helper since 1.0: until 1.0.6 its guided diagnostics covered FortiGate and FortiADC, while the Cisco, Arista, Juniper and ExtremeXOS profiles offered raw catalogue reads only. 1.0.7 lets the assistant work with the switches and routers of six operating systems in one common data model, find where a device is connected, and diagnose FortiGate Wi-Fi clients and flows. Everything new is read-only and keeps the existing guardrails: enrolled targets only, fixed catalogue commands, pinned host keys, and every request written to the audit before it reaches a device.
Multi-vendor switches and routers. The query catalogue grows from 380 to 547 templates. ExtremeXOS, Cisco IOS, IOS XE and NX-OS, Arista EOS and Junos (including EX/QFX ELS) gain the reads of daily operations: whole routing tables, OSPF interfaces, spanning tree, trunks, err-disabled ports, detailed LLDP, NTP, bounded logs, and vPC/MLAG, PoE and stack state where the platform has them.
One table format for every vendor (
switch_read). Interfaces, interface error counters, port VLAN membership, IP interfaces (address, prefix length, SVI VLAN), VLANs, MAC table, ARP/ND, LLDP neighbours, routes, OSPF neighbours, BGP peers, LAG and STP ports come back as the same records whatever the vendor prints. Every result names its source commands with a hash of their output; lines the parser does not recognize are returned inunparsed, never dropped, andcoveragesays which fields the device did not supply.Find a device on the network (
locate_endpoint). One IP or MAC address across 1–64 enrolled targets (including managed-switch slots): ARP/ND on routers and firewalls gives the MAC, MAC tables on switches give the port and VLAN, LLDP tells an access port from an uplink, and an IP phone or Wi-Fi access point on the port is named. A MAC seen only on an uplink to a device you did not enroll is reported as such, never as "not found". Up to 8 concurrent readers, 40 reads for at most 8 aliases and otherwise 8 reads per alias, with a shared 59.5-second deadline.FortiGate Wi-Fi diagnostics. Seven Wi-Fi reads that work with a read-only account, and
wifi_triagefor one client by MAC, IP or exact hostnamename(identity_trust: client_supplied): significant client history, access point, radio, SSID and RF state, with findings. An optional read-only REST token, enrolled separately, adds live clients with RSSI/SNR (wifi_clients), managed AP state (wifi_aps_live) and rogue and interfering APs (wifi_rogue): fixed GET requests, certificate pin or CA, no writes (administrator checklist).Is this flow allowed? (
triage_flow). For one IPv4 flow through a FortiGate: the route to the destination and back to the source, the firewall policy lookup and, when enrolled, the sessions of the flow, with a verdict such asallowed_and_session_seenordenied_by_policy. Accepted only on the measured identity, FortiGate 80F with FortiOS 8.0.2 and VDOMs disabled.Also new: MCP progress notifications during triage, an authenticated
GET /healthz, acoveragereport in the Auditor, reason codes in Admin refusals, and a fix for a session or transport secret that could be rebuilt from two pages ofssh_read/schema_read(security note).
Examples of questions an administrator can ask the assistant once the devices are enrolled:
"Where is the device with MAC 00:00:5e:00:53:10 connected?" or "Which switch port and VLAN does 192.0.2.10 use?" (
locate_endpoint)"Why does the Wi-Fi client 00:00:5e:00:53:21 have a weak signal or keep disconnecting?" (
wifi_triage; live RSSI/SNR needs the optional REST token)"Are there rogue access points stronger than -70 dBm?" (
wifi_rogue)"Is HTTPS from 192.0.2.10 to 198.51.100.20 allowed through the FortiGate, and is there a session?" (
triage_flow)"Which OSPF neighbours does the core router have, and which ports are blocking in spanning tree on the access switch?" (
switch_read)"Compare the VLANs and the LLDP neighbours of the two distribution switches." (
switch_read)
The assistant answers from the device output it read and lists what it could not read; none of these tools changes the device configuration.
Coverage by vendor and operating system
✓ the command's output was captured live from that OS with a read-only account, and the tests parse that output · docs the output layout comes from the vendor documentation only, because the measured device had nothing to show (feature not configured, empty table, or command missing on the virtual image) · – not provided. Unless a cell names a later date, live captures used development builds of the 1.0.7 source on 2026-11-08 and 2026-11-09, and the Linux row comes from the 1.0.8 checks described below the table; virtual images do not establish hardware behavior (PoE, optics, stacking, forwarding), and no hardware Cisco, Arista or Juniper device was tested. A check mark records a dated capture or live acceptance result, not the current lab configuration; the endpoint column has the narrower scope in note ⁵. replay means offline replay of live captures; transit means a transit hop in a completed live endpoint search; ARP means captured IPv4 router/firewall input, without an end-to-end endpoint result. Measurement quality limits are in note ⁷.
Normalized tables (switch_read) and endpoint location:
OS (profile) | Verified live on | Interfaces | VLAN | Port VLAN | MAC | ARP | LLDP | Routes | OSPF | BGP | LAG | STP | Errors / flaps | IP interfaces |
|
ExtremeXOS ( | X435-8P-4S and three X440G2-12p-10G4 with 33.7.1.6-patch1-11; EXOS-VM 33.6.1.14 | ✓ | ✓ | ✓⁸ | ✓ | ✓ | ✓ | ✓ | – | – | ✓ | – | ✓ CRC/TX | ✓ | live located: 13 physical end hosts on X440G2 by MAC; 11 also by IP (24/24 executed searches matched CLI; two IP searches not run because no ARP mapping was available) and an end host on EXOS-VM port 2, VLAN 10, 2026-11-11⁵ |
Cisco IOS ( | IOSv 15.9(3)M12 (router), IOSvL2 15.2(20200924) (switch) | ✓ | ✓ | ✓⁸ | ✓ | ✓ | ✓ | ✓ | ✓ | docs | ✓⁶ | ✓ | live MCP fallback: show interfaces (2026-11-11) | ✓ | live located: end host on IOSvL2 Gi0/3, VLAN 10 untagged, 2026-11-11⁵ |
Cisco IOS XE ( | IOL XE 17.18.2 (router image) | ✓⁹ router | docs | docs⁸ | docs | ✓ | ✓ | ✓ | ✓ | ✓¹ | docs⁶ | docs | live MCP fallback: show interfaces (2026-11-11) | ✓ | ARP in completed live search, 2026-11-10⁵ |
Cisco NX-OS ( | Nexus 9300v, NX-OS 9.3(12) | ✓ | ✓ | ✓⁸ | ✓ | ✓ | ✓² | ✓ | ✓ | ✓¹ | ✓⁶ | ✓ | prior canonical replay; new capture refused | ✓ | live located, 2026-11-11⁵ |
Arista EOS ( | cEOS 4.36.1F | ✓ | ✓ | ✓⁸ | ✓ | ✓ | ✓ | ✓ | ✓ | docs | ✓⁶ | ✓ | ✓ errors; discards prior replay | ✓ | live transit, 2026-11-11⁵ |
Junos ELS, EX/QFX ( | vJunos-switch 26.2R1.7 | ✓ | ✓ | ✓⁸ | ✓ | ✓ | ✓ | ✓ | ✓ | docs | docs⁶ | ✓⁶ | ✓ extensive | ✓ | live located: end host on ge-0/0/1, VLAN 20 untagged, 2026-11-11⁵ |
Junos, other platforms ( | the same commands on vJunos-switch 26.2R1.7³ | ✓³ | – | – | – | ✓³ | ✓³ | ✓³ | ✓³ | docs | docs⁶ | – | replay on ELS switch | ✓³ | ARP³⁵ |
FortiOS ( | FortiGate 80F, FortiOS 8.0.2 build0251 | ✓ link/speed/duplex | ✓ interface configuration | – | empty local bridge only | ✓ | ✓ local summary | ✓ IPv4 | – | – | – | – | – | ✓⁹ | ARP / own interface, 2026-11-10⁵ |
FortiSwitch 224E-POE managed by a FortiGate | FortiGate 80F, FortiOS 8.0.2 build0251; switch firmware 8.0.1 recorded on 2026-11-07, not captured in the 2026-11-10 run | ✓ link/speed | ✓ interface configuration on FortiGate | ✓ configuration | ✓ | – | ✓ (summary, no management IP) | – | – | – | – | – | ✓ errors/drops | – | live located: AP port3, VLAN 100 untagged, 2026-11-10⁵ |
Linux ( | Ubuntu 24.04.5; Debian 13.7 cloud; Proxmox VE on Debian 13.7 (CLI captures, 2026-11-13) | ✓ links, MAC; MTU of one enrolled interface | – | – | ✓ bridge FDB (static entries only on the Ubuntu host) | ✓ neighbors, ARP and ND | – | ✓ IPv4 | – | – | – | – | – | ✓ with MAC and default gateway | neighbors and bridge FDB on captured outputs; a bridge port stays |
Additional EXOS acceptance (2026-11-13). The read-only EXOS acceptance of source ad4ff3c (2026-11-13), carried forward by the final 1.0.8 acceptance, compared eleven switch_read tables on one X435-8P-4S and three X440G2-12p-10G4, all 33.7.1.6-patch1-11: 44/44 independent table comparisons and 8/8 IP/MAC endpoint searches passed. LAG and aggregate were empty on two switches and populated on two X440G2 (sharing group 13, members 13–16, active 13 and 15). This adds live port_vlan evidence to the earlier replays; it does not qualify Admin writes, PoE, DOM or active MLAG.
FortiSwitch qualification. Only two 224E-POE managed through the FortiGate above were measured. The 29 port-state/error rows and 28 configured VLAN rows are the captured scope of these switches; port counts and naming on other models are unmeasured. MCLAG ICL, trunk and consistency were measured on one pair in one topology (2026-11-07, task 14, build 1.0.6); other peer counts, stacks and standalone FortiSwitch operation are unqualified. The dated 2026-11-10 endpoint evidence is one FortiAP on port3; the later 1.0.8 development-build reads (source 96ea561, 2026-11-12) located two hosts by IP and MAC on EXOS edge ports against fresh CLI. Neither result qualifies endpoint location behind a FortiSwitch trunk or in MCLAG. Other FortiSwitch models and firmware remain unmeasured.
1.0.8 additions (development builds before the release candidate, read-only accounts): table="cdp_neighbor" (CDP neighbours of Cisco IOS, IOS XE and NX-OS from the opt-in cdp_neighbors query) returned the correct local and remote port, neighbour name and management IP for the CDP output of IOS (two images), IOS XE and NX-OS lab images (4, 4, 3 and 3 neighbours, compared with the CLI). The five Linux tables above matched independent CLI reads on the Ubuntu host (3, 6, 4, 17 and 13 rows), and six further checks of the per-address default gateway also passed; that build read ip_interface from ip address show, and the released ip -brief address form is covered by the CLI captures of 2026-11-13. The forwarding database of that host held only static entries; in the tests a bridge port from a synthetic dynamic FDB row is returned as unverified with the result incomplete, never as a located edge. Linux has no VLAN, LLDP, OSPF, BGP, LAG or STP table and no IPv6 routes. FortiOS routes with recursive BGP next hops and summary/Null routes, the route code legends of FortiOS 7.6 and 8.0 and VLAN interfaces with a nested config ipv6 node are parsed from the stored CLI captures of a FortiGate 60F (FortiOS 7.6.8; 13 routes, 9 VLAN interfaces) and an 80F (FortiOS 8.0.2; 32 routes, 7 VLAN interfaces) with no unparsed line; this is replay, not a new live run, and the 80F VLAN capture is reconstructed from its independent get system interface output.
Fortinet verification on 2026-11-10: acceptance of candidate source 51840b1
returned FortiSwitch MAC, LLDP, 29 port-state/error rows and 28 configured
port-VLAN rows per switch. The AP was live located on port3, VLAN 100
untagged, with link up and 1000 Mb/s, in eight reads (about 45 s); the second
switch was transit over the ICL. VLAN membership is source: configuration,
not forwarding evidence. FortiSwitch firmware was not captured in that run; the separate 2026-11-07 measurement records 8.0.1 on both 224E-POE units.
The local interface, VLAN and LLDP tables were verified through live MCP on
2026-11-11: 11 physical interfaces, eight VLAN interfaces and two LLDP neighbors,
compared with independent CLI reads on the same 80F/build. The enrolled local
internal bridge read succeeded but was empty; populated local FDB layouts
remain unparsed. Without an enabled and enrolled bridge, local mac_entry is
not_applicable (clients: ARP/FortiSwitch). Local LLDP has no management
IP/capabilities; CRC and flap counters stay null.
⁸ port_vlan is tested by offline replay of read-only captures: IOSvL2 15.2(20200924), Nexus 9300v 9.3(12), cEOS 4.36.1F, vJunos-switch 26.2R1.7, EXOS-VM 33.6.1.14, X435-8P-4S 33.7.1.6 (booted secondary image) and X440G2 33.7.1.6. The 2026-11-09 PTY captures add EXOS show vlan detail; transport echo, prompt and pager artefacts were removed before anonymization. NX-OS and Junos success uses the existing captures of the exact catalogue commands (show interface trunk, show ethernet-switching interface | no-more); the new plural-command refusals are negative fixtures. IOL XE 17.18.2 is a router image that refuses the switching commands, so positive IOS XE membership remains a shared-parser synthetic test, not live evidence. Membership describes allowed VLANs, independently of forwarding or link state.
interface_errors evidence added on 2026-11-09: live captures replayed in
test_port_errors.py verify cEOS 4.36.1F (16 error-counter rows), EXOS-VM
33.6.1.14 and physical X435-8P-4S / X440G2-12p-10G4 33.7.1.6 (CRC and TX Errors),
and vJunos-switch 26.2R1.7 (extensive errors/drops, CRC/Align, Last flapped,
Carrier transitions). Common Junos replays the same switch output; no Junos
router was measured. Earlier stored canonical NX-OS 9.3(12) and EOS 4.36.1F discard captures
are also replayed; they are distinct from the supplied captures. On 2026-11-10,
new read-only show interfaces captures from IOSv 15.9(3)M12 (7 interfaces),
IOSvL2 15.2(20200924) (7) and IOL XE 17.18.2 (19) verify offline replay of the
authorized whole-port fallback, including RX/CRC/TX and queue/total output
drops. Refused or empty counter-table sources remain negative fixtures; the
authorized fallback was also verified through live MCP on IOSv, IOSvL2 and
IOL XE on 2026-11-11. Nonzero IOS/XE counters remain synthetic coverage. The NX-OS 9.3(12) supplied capture refused the plural
command; the catalogue uses singular show interface counters errors.
The new cEOS 4.36.1F LLDP capture verifies all nine neighbors, including seven
with day-old discovery/change ages, with complete parser coverage. EXOS direct
routes replay with next_hop: null and their VLAN interface, while static
routes keep their gateway. These parser replays do not establish support for
other firmware or hardware; device configuration was unchanged.
¹ Earlier SSH captures on 2026-11-09 recorded IOL XE Active and NX-OS Idle under temporary lab configuration (real fixtures). In the later MCP run, 14:10–14:20 UTC that day, NX-OS BGP was disabled (show feature; summary returned unsupported). IOSv, IOSvL2, IOL XE (without a CLI comparison), cEOS and vJunos returned inactive BGP (not_applicable); vJunos also reported a missing BGP licence. EXOS has no normalized BGP table. No BGP peer or established session with prefix counts was verified in that later run; established output remains docs. ² Only the neighbour on the management port appeared; LLDP neighbours on data ports were not shown by the Nexus 9300v and are docs. ³ The common Junos commands were captured earlier on vJunos-switch only; juniper_junos was not separately enrolled in the later MCP run. MX, SRX and PTX are not measured. In the 1.0.7 switch/router measurements described here, populated IPv6 ND layouts were documentation-only and the later MCP run verified no populated returned ND record. The later Ubuntu 24.04.5 Linux capture includes a populated IPv6 neighbour and is replayed by the tests; this does not establish a live IPv6 endpoint-location result on a dynamic Linux bridge port.
⁴ EXOS provides table="aggregate" using show lacp (name, member_count) and table="lag" using the explicitly enrolled lag_summary query (show sharing; name, protocol, status, members). No EXOS-VM show sharing output was captured; the empty case replays the empty output of the physical X435 with the EXOS-VM identity. A populated physical X440G2 33.7.1.6 sharing group with members was captured on 2026-11-10 and is replayed by the engine tests. Populated LACP aggregates were also captured on physical EXOS switches on 2026-11-08.
⁵ Live acceptance on 2026-11-11 located GNS3 end hosts behind IOSvL2 Gi0/3 (VLAN 10), NX-OS Ethernet1/2 (VLAN 20), EXOS-VM port 2 (VLAN 10) and vJunos ge-0/0/1 (VLAN 20), each by IP and MAC in two rounds across all seven enrolled targets, and 13 physical end hosts on ExtremeXOS X440G2 switches by MAC; 11 also by IP. All 24 executed searches matched the CLI forwarding table; two IP searches were not run because no ARP mapping was available. cEOS was observed as transit in a completed live search; IOSv and IOL XE were included as router ARP readers. No access-host result on these router images is claimed. Endpoint parsers are also tested on real captures. The physical NAS case was live located behind X440G2; the enrolled inter-switch link is transit. FortiLink acceptance on candidate source 51840b1 located the AP on port3, VLAN 100 untagged (edge_behind_ap, eight reads), and the second switch MAC as own_interface_of_target (three reads). An enrolled device's own address is not an access-host result. Phones remain unverified. Common Junos was not separately enrolled; IOS XE switch layouts remain documentation-only.
⁶ Earlier IOS/EOS/NX-OS LAG captures remain dated evidence. In the later MCP run, LAG was empty on IOSvL2, NX-OS and cEOS, refused (permission_denied) on IOSv and IOL XE, and LACP was not running on vJunos; EXOS-VM aggregate was empty. No populated LAG/aggregate table was verified on any of the seven OS in that 2026-11-09 run; this does not negate the later physical EXOS sharing capture. The 2026-11-10 acceptance also exercised OSPF/LAG; exact per-OS populated row counts are unavailable, so no additional per-OS positive LAG claim is made here. vJunos RSTP port output was captured earlier on 2026-11-09 with temporary configuration; in the later run STP was disabled (Spanning-tree is not enabled at global level., not_applicable).
⁷ Measurement quality: sequential reads are not an atomic snapshot (cEOS FDB changed from 10 to 7 rows); IOL XE reports normalized model=null; identity responses based only on ssh_read version carry warnings because the restricted inventory did not enable the additional identity queries; IOSvL2 is an experimental image and cEOS an engineering build. These limits bound the evidence above.
⁹ ip_interface (IPv4 address, prefix length, SVI VLAN, state) was added on 2026-11-09 and is parsed from the anonymised live outputs of show ip interface brief with show ip route (IOS, IOS XE, NX-OS), show ip interface brief (EOS), show ipconfig with show vlan (EXOS), show interfaces terse (Junos) and get system interface (FortiGate 80F, FortiOS 8.0.2 build0251, read-only account, 2026-11-09); FortiOS gives no link state, so oper_status stays null there. On the IOL XE router image the interface table comes from show ip interface brief (name, status, protocol) when the target declares device_types: ["router"] without switch; the IOSv router uses the same rule.
IOS / IOS XE IPv4 route lookups use the authorized whole routing table as a fallback when the direct lookup is empty.
Catalogue, triage, Wi-Fi, Auditor and Admin:
FortiLink capacity is bounded by the 5-second connection spacing on each FortiGate: at the observed ~5.6 seconds per read, an IP lookup with all edge queries fits roughly four managed switches (N + 6 reads) into 59.5 seconds; larger sites can return partial findings with incomplete coverage. Startup, latency and multiple matching switches reduce this capacity.
Platform |
| Run live for 1.0.7¹⁰ | Triage and Wi-Fi | Auditor | Admin |
FortiOS (FortiGate) | 108 → 119 | the 7 new Wi-Fi reads, | new: | 37 rules | address, address group, DHCP reservation, firewall policy (unchanged) |
FortiADC | 33 → 33 | Selected catalogue reads, nine diagnostic recipes and |
| 8 rules on an exported configuration | new in 1.0.10: pool member status (enable/disable/maintain), add (created disabled) and remove (disabled/maintain, not the last member) through MCP |
FortiSwitch 224E-POE (FortiLink) | existing FortiOS catalogue reads | MAC/LLDP, port-stats and configured VLANs; live AP located, 2026-11-10, through FortiGate 80F 8.0.2 build0251 |
| – | – |
ExtremeXOS | 48 → 65 | 63 earlier catalogue reads plus VLAN detail on EXOS-VM; VLAN detail also on physical X435/X440G2; | – | 9 rules | VLAN, port display string, port VLAN membership; new in 1.0.9: port admin state (CLI and MCP) and PoE cycle (CLI only), 33.7.1.6 only (patch level and model are not checked; measured only on 33.7.1.6-patch1-11 on X435-8P-4S/X440G2) |
Cisco IOS | 27 → 49 | 43, docs-only 6 (error counters, environment, optics, PoE, stack) | – | – | new in 1.0.10: interface description and admin state (IOSv 15.9(3)M12, IOSvL2 15.2(20200924:215240)) and access VLAN (IOSvL2 only), CLI and MCP; GNS3 lab images only; safeguard = |
Cisco IOS XE | 27 → 50 | 32, docs-only 18 (switch and platform reads) | – | – | new in 1.0.10: interface description and admin state (IOL XE and IOL-L2 XE 17.18.2) and access VLAN (IOL-L2 XE only), CLI and MCP; GNS3 lab images only, no hardware platform measured; same safeguard as IOS (details) |
Cisco NX-OS | 30 → 61 | 58, docs-only 3 (HSRP, VRRP, DHCP snooping) | – | – | new in 1.0.10: interface description, admin state and access VLAN (CLI and MCP), Nexus 9000v NX-OS 9.3(12) only, a physical Nexus 9000 is not verified; safeguard = checkpoint and a one-time |
Arista EOS | 33 → 54 | 53, docs-only 1 (PoE) | – | – | new in 1.0.10: interface description, admin state and access VLAN (CLI and MCP), cEOSLab 4.36.1F only; safeguard = configure session with commit timer, whose expiry returns the whole running configuration; write account with privilege 15 at login (details) |
Junos ELS (EX/QFX) | 29 → 55 | 51, docs-only 4 (Virtual Chassis, PoE) | – | – | new in 1.0.10: interface description, admin state and access VLAN by VLAN name (CLI and MCP), vJunos-switch 26.2R1.7 only (physical EX not measured); safeguard = |
Junos (common) | 25 → 41 | 41, on the vJunos-switch | – | – | – |
Linux | 16 → 16 |
| – | – | – |
Ruckus Unleashed | 4 → 4 | – | – | – | – |
Total | 380 → 547 |
¹⁰ The template was sent to the device with the read-only account (on FortiADC, with the admin-bounded account for the queries that require it). This includes empty and "not configured" answers and the reads that the built-in read-only role refuses: show logging and stp_inconsistent on IOS and IOS XE privilege 1, stp_summary on the IOSv router, and the two Junos log reads, which need more than the built-in read-only class. The per-template results are in the Cisco, Arista, Junos and ExtremeXOS notes; device roles in Accounts and least privilege, details in Verified platform support.
Highlights
One product, one image. A single multi-architecture image for
linux/amd64andlinux/arm64, pinned by digest in the releaseenv.example. Core, Helper, Auditor and Admin share one dependency closure and one product version.One MCP endpoint. HTTPS only, bearer token, instance-local certificate authority with name constraints and an automatically renewed short-lived server certificate.
Audit before action. MCP requests are durably recorded before dispatch and responses before delivery. The local diagnostic
/healthzendpoint remains available during an audit failure; successful health checks are not audited. If the audit cannot be written, the operation is refused (audit_unavailable). The audit goes to a TLS syslog receiver (recommended) or to a local, size-limited log.Role isolation. Gateway and roles run as separate long-running processes under their own UID/GID (51000–51003), with no Linux capabilities,
no-new-privileges, a read-only root filesystem and CPU, memory and process limits. A short start-up bootstrap uses the capabilities listed incompose.yamland then drops all of them.Explicit device scope. No device is enrolled implicitly. Each role has its own inventory and credentials; MCP clients pass enrolled aliases, never device credentials.
Device output is untrusted data, never instructions.
Safeguarded changes. MCP Admin changes on FortiOS, ExtremeXOS, Cisco IOS, IOS XE, NX-OS, Arista EOS and Juniper Junos run behind an on-device safeguard with prediction, independent readback and verified return. FortiADC pool-member changes have prediction and independent readback too, but no on-device safeguard: Admin returns an unverified change with a compensating inverse write in the same run, or with
admin recoverafter an interruption. Unknown writes are never retried automatically.Errors stay visible. Refused, failed or uncertain operations are MCP errors (
isError) with their full structured result.Signed releases. The checksum list is signed with Sigstore; SBOMs, vulnerability scans with written assessments and acceptance reports are covered by it.
Roles and what they can do
netops selftest prints the MCP tool names of each role: 26 Helper, 8 Auditor and 7 Admin tools. Core has no MCP tools.
Core
The shared engine used by the other roles: inventory and credential-vault schemas and the SSH/SFTP transport with host-key pinning. See Core inventory and Core vault.
Helper — read-only diagnostics
Read-only queries against enrolled targets, using a named query catalogue of 549 query templates across 11 platform profiles (linux, fortinet, extreme_exos, cisco_ios, cisco_xe, cisco_nxos, arista_eos, juniper_junos, juniper_junos_els, ruckus_unleashed, fortiadc). The ssh_read catalogue excludes running/startup/full configuration, arbitrary CLI, debug activation, packet capture, shells and every write or lifecycle action. The two explicitly enabled FortiSwitch VLAN queries read only the selected managed-switch configuration and the VLAN interface mapping. Separately, fortios_diagnostics offers bounded sniffer and flow diagnostics, and config_read offers opt-in configuration capture. Query parameters are accepted only when their value is listed in the target's read_inventory, except the literal VLAN and MAC parameters and Wi-Fi event line counts (checked for their form), lookup prefixes inside an enrolled lookup_prefixes entry, access point ids returned by an earlier wifi_ap_status, and the flow of one triage_flow call (exceptions).
Tool | Behavior |
MCP prompts | Five text-only troubleshooting runbooks when Helper is enabled; see Helper tools |
| Enrolled aliases, validation and rate state; no device contact |
| Public enrollment boundary for one alias; no device contact |
| Named typed queries and metadata; not automatic authorization |
| Enrolled DNS resolution with address scope checks |
| Enrolled TCP port reachability |
| Explicitly permitted bounded diagnostics |
| Verified peer certificate and enrolled SNI/port |
| Normalized interface, IP interface, interface error counters, port VLAN tagging/mode, VLAN, MAC, ARP/ND, LLDP, route, OSPF neighbour, BGP peer, LAG and STP records for EXOS, IOS/IOS XE, NX-OS, EOS and Junos (the tables of each OS in What's new), CDP neighbour records of IOS, IOS XE and NX-OS, interface, IP interface, IPv4 route, ARP/ND and bridge FDB records of a Linux host, ARP/ND, IPv4 routes, IP interfaces, physical interfaces, VLAN interfaces, LLDP and bridge MAC of a FortiGate and managed FortiSwitch MAC/LLDP, link/speed, errors/drops and configured VLANs via an enrolled |
| One IP/MAC literal across 1–64 enrolled targets (including managed-switch slots), 8 concurrent readers, 40 CLI reads including identity for at most 8 aliases and otherwise 8 per alias, shared 59.5-second deadline; edge/transit port, LLDP, VLAN and vantage, with missing evidence (guide) |
| Enabled named query, pinned SSH host key, bounded/paginated output; FortiOS and FortiADC targets are first checked to be the selected product ( |
| Metadata within enrolled roots; no file content |
| Not a supported workflow in 1.0 (see Known limitations) |
| Enrolled bounded recipes, no schema registry needed. FortiOS: verified single-VDOM mode without a selector, or an explicit |
| Opt-in redacted configuration capture of a FortiOS, FortiADC, ExtremeXOS, Cisco IOS, IOS XE, NX-OS or Arista EOS target and comparison of two captures of the same target; see Helper tools |
| SNMPv3 authPriv GET (SHA256, AES128) with the |
| FTP and FTPS refused in the shipped profile |
| Fixed read-only FortiOS health chain (resources, sessions, HA, NTP, updates, links) with findings and a verdict that never says healthy; FortiGate-60F 7.6.8 build 3744 and FortiGate-80F 8.0.2 build 0251 only |
| Fixed read-only FortiOS route chain for one enrolled IPv4 address (route, policy routes, SD-WAN, ARP) with sourced findings and an explicit list of what is not simulated; FortiGate-60F 7.6.8 build 3744 and FortiGate-80F 8.0.2 build 0251 (read live on an HA primary); other identities, including FortiGate-VM64 8.0.2 build 0251, are refused |
| One IPv4 flow ( |
| One named FortiOS IPsec tunnel: selector state, data and error counters, routes through it and IKE error counters (context), with findings and a verdict that never says healthy; FortiGate-60F 7.6.8 build 3744 and FortiGate-80F 8.0.2 build 0251 only |
| Live FortiOS clients with RSSI/SNR, managed AP state and rogue/interfering observations through a separate RO REST token; fixed GETs, certificate pin or CA, no writes; see setup and security |
| One Wi-Fi client by MAC, IPv4 or exact hostname |
| One enrolled FortiADC virtual server through pool, members, health checks, TLS, WAF and DoS (configuration and runtime) with sourced findings and a verdict that never says healthy; FortiADC 7.6.7 build 0676 only; see Helper tools |
Each target has its own scope (enabled queries, egress addresses and ports, optional SFTP roots) and a per-target rate limit (default 30 requests per 60 seconds; the triage tools also have a sublimit of the same size; triage_health, triage_routing, triage_vpn and triage_slb report progress). The account must be independently verified as read-only on the device; the JSON declaration alone does not restrict it.
Docs: Helper configuration · Helper tools · Query catalogue · Account boundaries
Auditor — configuration audit
Evaluates FortiOS, ExtremeXOS and FortiADC configurations against a rule catalogue (37 FortiOS, 9 EXOS and 8 FortiADC rules) and stores finished findings in a private store.
Operator commands (run with the instance stopped):
auditor runevaluates a configuration snapshot from standard input offline, without contacting a device; output as text,--jsonor--sarif.auditor collectreads the configuration from an explicitly configured device through one pinned channel (sshorfortios-rest, with host-key or TLS fingerprint verification); the Auditor never changes a device, but on FortiOS it collects with asuper_adminadministrator, which can write (see Known limitations).auditor import-snapshotandauditor import-policyplace reusable snapshots and operator management policies into private state.--baseline-acceptaccepts the findings of a run into the device baseline; later runs report them asopen-known.
The eight MCP tools only read stored findings; they contact no device, start no collection and write nothing:
Tool | Behavior |
| Per device: |
| Rules of the configured catalog with ID, version, class, severity, title and references |
| One rule with remediation, evidence fields and known false positives |
| Findings of the last run with state ( |
| One finding with its baseline and suppression record |
|
|
| Brief filtered findings across the devices of the tenant (rule, object, severity, state; no evidence), with counts before and after the filter |
| Refused in 1.0 (no schema report manifest is configured) |
Docs: Auditor operator workflows · Auditor tools · Collection channels · Management policy
Admin — bounded, reversible changes
Admin is enabled by default (init --disable-admin omits its worker and MCP tools) and refuses device changes until it is configured and the device is enrolled. Supported change scope:
FortiOS: firewall address, address group and DHCP reservation; firewall policy as an opt-in table, disabled by default per device.
ExtremeXOS: VLAN, port display string, port admin state and port VLAN membership; PoE cycle of one port with the operator command
admin poe-cycle(ExtremeXOS port admin state and PoE cycle).FortiADC: load-balance pool member status, add (created disabled) and remove (disabled or maintain, never the last member), FortiADC-KVM 7.6.7 build0676 only; returned by a compensating write, not by an on-device safeguard (FortiADC pool member). The older
pool-member*operator commands are deprecated.Cisco IOS and IOS XE: interface description and admin state; access VLAN on the switch images (Cisco IOS and IOS XE).
Cisco NX-OS: interface description, admin state and access VLAN (Cisco NX-OS).
Arista EOS: interface description, admin state and access VLAN, cEOSLab 4.36.1F only (Arista EOS).
Juniper Junos: interface description, admin state and access VLAN by VLAN name, vJunos-switch 26.2R1.7 (ELS) only (Juniper Junos).
FortiOS, ExtremeXOS, Cisco IOS, IOS XE, NX-OS, Arista EOS and Juniper Junos MCP changes run behind an on-device safeguard (60–900 seconds; on IOS and IOS XE the device revert timer in whole minutes, at least 2; on NX-OS a one-time feature scheduler job, which needs at least 180 seconds with the default margin; on EOS a configuration session commit timer, whose expiry returns the whole running configuration; on Junos commit confirmed 10 in configure exclusive with safeguard_seconds 600, whose expiry returns the whole configuration), with protected objects, per-device/hour and daily limits, an independent check account, a change journal and a notification over trusted HTTPS (ntfy). A device whose operation ends unknown or revert-failed, or with a blocking reason, stays blocked through that workflow until a person investigates. FortiADC pool-member changes go through the same MCP tools and operator commands, with enrollment, journal, audit and check-account readback, but FortiADC 7.6.7 has no on-device timed return: Admin writes the inverse in the same run when the write or a readback fails, and admin recover returns an interrupted change. If the Admin process, the host or the management path is lost after the write, nothing on the device returns the change until admin recover runs.
MCP tool | Behavior |
| Readiness report without a device change; optional |
| Every check of apply without a change: proposed commands, prediction and refusal reasons |
| One change behind the device safeguard (on FortiADC behind the compensating return in the same run); result |
| Every check of |
| The stored operation record by |
| Schema transactions; not a supported workflow in 1.0 |
Operator commands (instance stopped), not MCP tools:
admin enrollperforms a real temporary probe change and lets the on-device safeguard return it (on FortiADC, the compensating delete of a disabled probe member);admin doctorthen has to report"ready": true. Withadmin doctor --local, exit 0 means only local readiness; remote readiness remains unverified.admin undoreturns a confirmed change as a new safeguarded operation with its own change ID.admin recoverinspects and settles an interrupted or unknown operation using its saved safeguard and original state.admin status,admin notify-retryandadmin unblock(for a person who has inspected the record and the device).
There is no MCP tool to perform an undo (admin_undo_preview only shows it; the undo itself is the operator command admin undo, run by a person), unblock a device, cancel a safeguard or edit a plan.
Docs: Admin configuration · Admin MCP tools
Supported devices and firmware
Compatibility is scoped to the exact platform, firmware build, model, account policy and operation documented by each component. Catalogue presence does not qualify every deployment, and software-image results do not establish physical forwarding or hardware behavior.
Platform | Documented scope |
FortiOS | 7.6.8 build3744 and 8.0.2 build0251, the measured FortiOS releases; 7.6.7 build3704 and 8.0.0 build0167 remain only as contracts of earlier measurements (verified support); model scopes FortiGate 60F, FortiGate 80F and FortiGate-VM64-KVM kept separate; Admin profiles |
FortiADC | FortiADC-KVM 7.6.7 build0676 (virtual image, standalone): Helper catalogue of thirty-three queries; Auditor audits an exported configuration ( |
ExtremeXOS | 33.7.1.6, 33.7.1.6-patch1-11 and the 33.6.1.14 virtual-image scope; model identifiers X435-8P-4S, X440-G2-12p and X440-G2-12p-10G4; Helper catalogue, |
Arista EOS | 4.36.1F (Helper catalogue, |
Cisco | NX-OS 9.3(12), IOS-XE 17.18.2 (router image; switch reads only from the vendor documentation), IOS 15.9(3)M12 and IOS 15.2(20200924) (Helper catalogue, |
Juniper Junos | 26.2R1.7 on vJunos-switch, ELS (Helper catalogue, |
Ruckus Unleashed | Explicit administrator-bounded role and catalogue boundary (Helper) |
Linux | Documented distribution, architecture and permission requirements (Helper); the |
Auditor catalogs cover FortiOS, ExtremeXOS and FortiADC. Admin MCP execution (MCP tools and the profile command netops-admin apply) is limited to the FortiOS, ExtremeXOS, Cisco IOS, IOS XE, NX-OS, Arista EOS, Juniper Junos and FortiADC profiles listed above; on FortiADC the return is a compensating write in the same run or by admin recover, not an on-device safeguard, and the older command-line pool-member, pool-member-add and pool-member-remove commands are deprecated (FortiADC bounds). A read catalogue on another platform does not imply Admin support there. The opt-in FortiOS managed_switch_stacking and managed_switch_poe queries are unverified on stacking- or PoE-capable hardware. The seven wifi_* reads for a read-only FortiOS account (wifi_ap_status, wifi_vap_status, wifi_neighbors, wifi_controller_status, wifi_controller_statistics, wifi_rf_analysis, wifi_events) and wifi_triage were measured on FortiGate-80F 8.0.2 build0251 with two FortiAP only, on 2026-11-08; the SSH reads list no live client and no client RSSI; optional read-only Wi-Fi REST enrollment adds wifi_clients, wifi_aps_live, wifi_rogue and live RSSI/SNR in triage, and the five diagnose wireless-controller queries remain for an admin-bounded account (measurement).
Live verification of NetOps 1.0.11 on 2026-11-16: a locally built image of the development 1.0.11 source before the release candidate, Admin with its separately enrolled write and check accounts; no other change of 1.0.11 was verified live. On vJunos-switch 26.2R1.7 (ELS) in the GNS3 lab (test port ge-0/0/2), the expiry of commit confirmed after an immediate return and after an interrupted session was measured through the device command line: it returns the configuration before the newest commit confirmed. After the fix, Admin passed the operator command line scenarios on the same switch, including a forced readback failure returned at once with a plain commit (reverted), with the configuration equal before and after; the MCP tools were not called in these runs. The quickstart cosign block without sudo was run once on Debian 13 lab machines (amd64 and arm64) under an account that also had sudo rights; an account without them was not used. Details are in verified support and the release notes.
Live verification of NetOps 1.0.10 on 2026-11-16: development builds of the 1.0.10 source before the release candidate, Admin with its separately enrolled write and check accounts, measured on 2026-11-15 and 2026-11-16 as dated in each sentence. On 2026-11-15, Admin on cEOSLab 4.36.1F in the GNS3 lab passed the operator command line scenarios. On 2026-11-16, Admin on IOSv 15.9(3)M12, IOSvL2 15.2(20200924:215240), IOL XE 17.18.2 and IOL-L2 XE 17.18.2, on a Nexus 9000v with NX-OS 9.3(12) and on vJunos-switch 26.2R1.7 (ELS) in the GNS3 lab passed the operator command line scenarios and, after the safeguard fixes, repeated runs including a forced readback failure (IOS and IOS XE on IOSvL2 and IOL XE); the MCP tools were not called in these runs. On 2026-11-16, Admin on FortiADC-KVM 7.6.7 build0676 (standalone) changed pool members through the common Admin path, including MCP admin_preview, admin_apply with expected_plan_sha256 and admin_undo_preview, SIGKILL and admin recover, with the full configuration equal before and after. Details, and later fixes covered by automated tests only, are in verified support and the release notes.
Live verification of NetOps 1.0.9 on 2026-11-15: development builds of the 1.0.9 source before the release candidate, measured from 2026-11-13 to 2026-11-15 as dated in each sentence. On 2026-11-15, a lab FortiGate-60F with FortiOS 7.6.8 build3744 in multi-VDOM mode: per-VDOM ARP, routing and IPsec matched independent CLI reads, reads beyond that account's VDOM were refused, and root-scoped reads and global health triage passed their control checks (112/112, source 7bec0b7). On 2026-11-14, FortiADC 7.6.7 build0676 on FortiADC-KVM: triage_slb schedule-list references, candidate pools and the unavailable/recovered virtual-server states matched CLI reads (76/76, source 6d50417), without claiming the active pool or calculating schedule-window activity. On 2026-11-13 at 23:42 UTC, two physical X440G2-12p-10G4 switches with ExtremeXOS 33.7.1.6-patch1-11 supplied read-only DOM captures, one LX 1310 nm SFP each; X435 optics and virtual hardware sensors remain unqualified. On 2026-11-14, IOSv 15.9(3)M12, IOL XE 17.18.2, N9300v 9.3(12) and cEOS 4.36.1F passed the corrected configuration-diff scenarios; X440G2 33.7.1.6-patch1-11 and IOSv 15.9(3)M12 passed the later hidden-line diff checks (33/33, source 2984f96). On 2026-11-14, cEOS 4.36.1F supplied inactive MLAG and empty member results, and N9300v 9.3(12) refused vPC commands with the feature disabled; these results do not verify active peers (verified support).
Live verification of NetOps 1.0.8 on 2026-11-12: development builds of the 1.0.8 source before the release candidate, read-only device accounts, and Admin with its separately enrolled accounts. The CDP output of IOSv 15.9(3)M12, IOSvL2 15.2(20200924), IOL XE 17.18.2 and Nexus 9300v with NX-OS 9.3(12) in the GNS3 lab (table="cdp_neighbor"), and the five Linux tables of an Ubuntu 24.04.5 host (ip_interface then from ip address show; the released ip -brief address form is covered by CLI captures of 2026-11-13), compared with independent CLI reads. A FortiGate with two FortiAP: the Wi-Fi REST reads and wifi_triage, and two FortiSwitch 224E-POE behind it. FortiOS routes and VLANs of a FortiGate 60F with FortiOS 7.6.8 build3744 and a FortiGate 80F with FortiOS 8.0.2 build0251 were read live; the fixes of their parsing are verified on the stored CLI captures, not on a new live run (verified support). Admin doctor --local and full doctor passed on runtime 1.0.8 configured for a FortiGate 60F.
Live verification of NetOps 1.0.7 on 2026-11-08: development builds of the 1.0.7 source before the release candidate, read-only accounts only. A physical FortiGate 80F in active-passive HA mode (primary unit, single VDOM) with FortiOS 8.0.2 build0251: the reads of triage_routing and triage_flow (routes, policy routes, SD-WAN, ARP, policy lookup, sessions of a flow), the seven Wi-Fi reads for a read-only account, wifi_triage and the read-only Wi-Fi REST endpoints of wifi_clients, wifi_aps_live and wifi_rogue; the other HA member was not read. Four physical ExtremeXOS switches (X435-8P-4S and three X440G2-12p-10G4) with 33.7.1.6-patch1-11 (X435 booted the secondary image), and a GNS3 lab with IOSv 15.9(3)M12, IOSvL2 15.2(20200924), cEOS 4.36.1F and EXOS-VM 33.6.1.14: the catalogue templates available on that date, with gaps. Physical EXOS ipv6_neighbor_address was not run because no IPv6 neighbour was available. EXOS vlan_detail and lag_summary, and IOS interfaces counters errors, were captured on 2026-11-09/10. The anonymised outputs are the fixtures of the automated tests of switch_read, locate_endpoint and the triage tools (verified support).
Live verification of NetOps 1.0.7 on 2026-11-09: earlier SSH captures in the same GNS3 lab, IOL XE 17.18.2, Nexus 9300v with NX-OS 9.3(12) and vJunos-switch 26.2R1.7 (read-only accounts; IOL XE interfaces counters errors was captured on 2026-11-09/10), and on the FortiGate 80F with FortiOS 8.0.2 build0251 the IP range syntax of the sessions and flow filters (filter set and cleared, no traffic test). Hardware Cisco, Arista and Juniper devices were not tested.
Later that day (14:10–14:20 UTC), direct HTTPS MCP calls measured 67 normalized tables on all seven GNS3 OS. The lab had no independent end host; IP/MAC endpoint runs returned transit evidence and incomplete, with seven-target runs reaching the 59.5-second limit. Later runs with lab end hosts on 2026-11-10/11 located them on the correct edge port and VLAN (verified support). BGP on NX-OS and STP on vJunos were disabled. Historical fixture samples and these later feature states are distinguished in the coverage notes above and verified support.
Live verification of NetOps 1.0.6 on 2026-11-07: FortiGate 60F with FortiOS 7.6.8 build3744, standalone (Admin firewall policy create, update and undo of an accept policy and of a deny policy, with two firewall address objects created and deleted through Admin), a physical FortiGate 80F in active-passive HA mode (primary unit) with FortiOS 8.0.2 build0251, managing two FortiSwitch 224E-POE with 8.0.1 and FortiAP 231K and 23JK with 8.0.0 (Helper system_status, FortiSwitch status, switch_dhcp_bindings returning an empty binding table, MCLAG ICL, trunk and consistency status, and wifi_access_points, wifi_ap_detail, wifi_clients with no associated station and wifi_ssid_mapping under an administrator-bounded account; wifi_client_detail was not measured), and SNMPv3 snmp_get of the system name on a FortiGate 80F and on FortiADC-KVM 7.6.7, measured with development builds of the 1.0.6 source before the release candidate (verified support).
Live verification of NetOps 1.0.5 on 2026-11-01: FortiGate 60F with FortiOS 7.6.8 build3744 (Admin firewall policy create, update and undo; Helper switch_dhcp_bindings), a physical FortiGate 80F active-passive HA pair with FortiOS 8.0.2 build0251 (Helper switch_dhcp_bindings with a client binding, FortiSwitch MCLAG status and the five Wi-Fi reads under an administrator-bounded account), FortiGate-VM64 with FortiOS 8.0.2 build0251 (Helper ping and sessions in a selected VDOM) and FortiADC-KVM 7.6.7 build0676, standalone (Helper triage_slb for a healthy, degraded and recovered pool with WAF deny events, and tls_probe with an enrolled certificate authority through a FortiADC virtual server; on 2026-10-31 Admin pool-member, disabling and re-enabling one member and refusing to disable the last healthy member), measured with development builds of the 1.0.5 source before the release candidate; the final 1.0.4 image was verified on 2026-10-28 (verified support).
Details: Verified platform support · Compatibility boundaries
Minimum requirements
Host: 64-bit Linux on
linux/amd64orlinux/arm64with Docker Engine and the Compose plugin (Supported platforms).CPU: 1 vCPU.
compose.yamllimits the container toNETOPS_CPUSCPUs (default 2); on a host with one CPU Docker refuses the default, so setNETOPS_CPUS=1in.env(seeenv.example).Memory: 2 GiB RAM. In the measurement NetOps used about 295 MiB idle and up to about 350 MiB during MCP calls and the self-test, within the container limit of 1 GiB; the rest is for the host and Docker.
Disk: 2 GiB free. The image is about 53 MB compressed and 166–170 MB unpacked per architecture (
docker image lsshows about 240 MB); the state volume starts at about 116 KiB and grows with the audit and the stores. Backups, the audit history and the syslog queue need additional space.Network: the host reaches
github.comfor the release files andghcr.iofor the image. MCP clients connect to the published HTTPS port (default 8443, bound to the address inNETOPS_BIND_IP). The enrolled devices must be reachable from the host on the ports their enrolled reads and operations use (SSH; HTTPS for REST, such as the optional Wi-Fi REST token; SNMP forsnmp_get). With syslog audit the host connects out to the receiver, by default on TCP 6514 (TLS).
Measured on an Ubuntu 24.04.5 virtual machine with 1 vCPU and 2 GiB or 1 GiB RAM (Docker Engine 29.9.3, a Compose copy with cpus: 1), where the instance started and passed the measurement run, and on amd64 with Docker Engine 29.1.3 for the memory figures. This is not a throughput or long-run load test; a deployment with many concurrent clients or many targets needs more.
Supported platforms
Host: Linux with Docker Engine and the Compose plugin. The complete quickstart installation (Docker installation, signature and checksum verification,
init,up, MCP and audit checks, refusal of foreign UIDs with an unchanged volume, host restart except in the rootless Ubuntu run) was exercised with the released NetOps 1.0.7 image, and every run passed, on the virtual-machine platforms below. The physical arm64 run is described separately.Ubuntu 26.04.1 LTS and Ubuntu 24.04.5 LTS (amd64), Docker Engine;
Ubuntu 24.04.5 LTS (amd64) and Debian 13 (amd64) with rootless Docker; the Debian run includes a restart of the host (lingering user session);
Raspberry Pi OS Lite 64-bit (arm64) userland in a virtual machine with a Debian kernel;
Raspberry Pi OS 64-bit on physical arm64 hardware, a single-board computer (vendor kernel 6.12, 4 KiB pages): a separate run verified signature/checksum validation, initialization, MCP/authentication/audit checks, UID refusals and project recreation. Docker 29.8.0 was already installed; Compose 2.39.4 and cosign 3.1.4 were supplied locally for the test. Docker installation, group setup and a host reboot were not exercised on this host.
Also qualified for 1.0.7: Debian 13 (amd64, arm64) and Fedora 44 (amd64 Server, arm64 Cloud Edition), with local state volumes. Fedora requires SELinux enforcing and SELinux support enabled in the Docker daemon.
Not verified: kernels with 16 KiB pages, 32-bit Raspberry Pi OS, and the Docker installation steps on physical hardware (run in the virtual machine only). The runs were performed by the maintainer's test workflow, without an independent tester.
Architectures:
linux/amd64andlinux/arm64.Not supported as runtime: Docker Desktop. Network-backed state storage, including NFS, is not qualified.
Clients: macOS and Windows are MCP client hosts only. Claude Code was tested there for 1.0.1; Codex was tested on Linux only. MCP clients connect over the network.
Security model
Endpoint: HTTPS only with a bearer token. The token is checked before any request body is read; unauthenticated rejections are only counted, not stored.
Instance CA: private, constrained to the configured DNS subtree, all IPv4/IPv6 names excluded (so the server name must be a DNS name). The server leaf lasts seven days and renews automatically; the CA is valid for 730 days from init or its last rotation (
connectionshows the remaining whole days, so 729 right after init) and is rotated explicitly withnetops ca rotate.Audit boundary: every supported MCP request, notification, response and connection boundary is audited, with requests durable before dispatch and responses before delivery. A successful authenticated
GET /healthzis not audited (local state only, no device contact); its query-string rejection and failure (HTTP 503) are. A failed audit refuses the operation; a failed response audit reports that the operation may have completed and forbids automatic retry. Helper, Auditor and Admin configuration workflows, Admin operator workflows, Auditor imports and Auditorrunandcollectrecord an allowlisted intent through a gateway-UID preflight;runandcollectalso record their result (exit code andrun_id) and may run inside the running instance viadocker compose execunder an interprocess audit lock; Auditorstatusand token rotation do not emit that preflight event, and CA rotation and audit recovery use their own audit records.Redaction: explicit. Known token values, secret-bearing fields, private-key blocks and documented password forms are redacted; worker-side credentials are removed before reaching the gateway. Audit is parsed protocol content, not a raw byte transcript, and output is escaped for terminals. Device output remains sensitive after redaction.
Untrusted device output: device text is data, never instructions; a diagnostic finding does not authorize a write, retry or another target.
UID separation: gateway, Helper, Auditor and Admin have separate UID/GID, private state and credentials; local IPC authenticates the peer UID in both directions. This is process and filesystem isolation inside one container, not a boundary against the host administrator or the container runtime. The runtime never mounts the Docker socket or uses host networking.
TLS probe trust:
tls_probeverifies the peer chain and the hostname/SAN with TLS 1.2 or newer, against the system store or, per target, only against a CA file enrolled astls_ca_certificatefrom a read-only directory; verification cannot be switched off. After failed verification, a second, unverified handshake only retrieves certificate details for diagnosis. No application data is sent, and the result stayscertificate_verified: false.Syslog over TLS: the bounded, durable syslog queue sends to a verified TLS receiver. A successful delivery is a TLS transport hand-over, not a receiver acknowledgement; a full queue blocks new operations.
Fail-closed: an unwritable audit, an incomplete final local audit record, a full syslog queue, a second instance on the same state or state of another product version or state schema stops operations instead of continuing silently. The one exception is the state of the immediately preceding release: the first start of the new release converts it under the instance lock and changes only its recorded product version. There is no downgrade.
CIS: the container architecture and the release tests are inspired by the recommendations of the CIS Docker Benchmark; NetOps does not claim compliance with CIS.
Details: Architecture · Security policy · CIS Docker Benchmark mapping
Quick start
This is a shortened version of the quickstart. Follow the full document for a new host: it installs the prerequisites step by step for Debian, Ubuntu, Fedora Server and Raspberry Pi OS, and covers rootless Docker, syslog receivers, backup, restore, upgrades and removal.
0. Prerequisites. The host meets the minimum requirements. Docker Engine with the Compose plugin from Docker's repository, and an account that can run docker info (root, the docker group or rootless Docker); on Fedora, SELinux support enabled in the Docker daemon ("selinux-enabled": true) before the first start, so that docker info lists name=selinux. Further curl, jq and cosign 2.5 or newer; the quickstart installs the official Sigstore 3.x release (checked with v3.1.4) and says what to do when its download from GitHub fails. See quickstart steps 1–4, which also say how steps 3 and 4 run without a terminal. Without sudo rights, the host administrator prepares Docker and jq, and cosign runs as a program of your account (step 4).
1. Download and verify. In the instance directory ~/netops download the five release files and verify them. The block stops at the first failed download or check, and it downloads nothing into a directory that already holds the .env of an instance. The block sets the instance directory to mode 700, including an existing directory:
mkdir -p -m 700 ~/netops && cd ~/netops &&
if test -e .env; then echo 'netops: ~/netops already holds .env; nothing downloaded' >&2; false; fi &&
chmod 700 . &&
(
for f in compose.yaml env.example netops-1.0.11-manifest.json netops-1.0.11-SHA256SUMS netops-1.0.11-SHA256SUMS.sigstore.json; do
curl -fLO "https://github.com/radek-cerny-soukr/netops/releases/download/v1.0.11/$f" || exit 1
done
) &&
cosign verify-blob --bundle netops-1.0.11-SHA256SUMS.sigstore.json \
--certificate-identity 325383355+radek-cerny-soukr@users.noreply.github.com \
--certificate-oidc-issuer https://github.com/login/oauth netops-1.0.11-SHA256SUMS &&
sha256sum -c --ignore-missing netops-1.0.11-SHA256SUMScosign must print Verified OK, and sha256sum OK for compose.yaml, env.example and the release manifest; cosign authenticates the checksum list using the signature bundle. After a failed download or check, run the same block again: it downloads all five files again and overwrites those of the failed attempt. An empty ~/netops left by a failed first attempt does no harm: the block reuses the directory, and nothing needs to be deleted.
2. Configure. Create .env and keep NETOPS_IMAGE exactly as pinned by digest in the env.example of the release; the env.example in the source repository has a placeholder instead, which Compose refuses with pull access denied (step 5). For an MCP client on the same host, bind to the loopback address and use the name localhost:
umask 077
cp env.example .env
sed -i -e 's/^NETOPS_BIND_IP=.*/NETOPS_BIND_IP=127.0.0.1/' -e 's/^NETOPS_SERVER_NAME=.*/NETOPS_SERVER_NAME=localhost/' .envFor clients on other machines, set NETOPS_BIND_IP to the host address you explicitly want to expose and NETOPS_SERVER_NAME to the exact DNS name the clients will use instead (IP certificate names and the unedited env.example placeholders are refused); see step 6.
3. Initialize and start. docker compose pull --quiet downloads the image first, without download progress:
cd ~/netops &&
docker compose pull --quiet && docker compose run --rm netops init && docker compose up -d --wait && docker compose psinit asks for the audit target: a TLS syslog receiver (recommended), or, when you leave it blank, local audit, which you accept by typing LOCAL. docker compose ps must show the service as healthy.
Without a terminal, for example in a script or over ssh without a terminal, choose the audit explicitly, add -T to every docker compose run and docker compose exec, redirect every other docker compose command with < /dev/null, and run the commands from a file, not from standard input. For local audit the block is the following; for a TLS syslog receiver replace --audit local --accept-local-audit with --audit syslog --syslog-host <host> [--syslog-port <port>]:
cd ~/netops &&
docker compose pull --quiet < /dev/null && docker compose run --rm -T netops init --audit local --accept-local-audit < /dev/null && docker compose up -d --wait < /dev/null && docker compose ps < /dev/null4. Export the CA and the token. The block is the same in a terminal and in a script. Compose messages between its lines go to standard error and do not enter netops-ca.pem or NETOPS_TOKEN:
cd ~/netops &&
umask 077 &&
docker compose run --rm -T netops ca < /dev/null > netops-ca.pem &&
NETOPS_TOKEN="$(docker compose run --rm -T netops token show < /dev/null)" &&
export NETOPS_TOKEN &&
test -n "$NETOPS_TOKEN" && printf 'NETOPS_TOKEN is set (%s characters)\n' "${#NETOPS_TOKEN}" &&
docker compose run --rm -T netops connection < /dev/nullThe block prints NETOPS_TOKEN is set (64 characters) and the MCP URL, without printing the token. The token stays in the shell: in a script, run this block and the token requests of quickstart step 9 in the same script file.
5. Check without an MCP client.
cd ~/netops
docker compose exec -T netops netops health < /dev/null
docker compose exec -T netops netops version < /dev/null
curl -sS -o /dev/null -w '%{http_code}\n' --cacert netops-ca.pem \
-H 'Content-Type: application/json' -H 'Accept: application/json, text/event-stream' \
-X POST https://localhost:8443/mcp -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'They print ready, 1.0.11 and 401: a request without the token is refused. Use the URL printed by connection when it is not https://localhost:8443/mcp. Step 9 adds requests with the token, including the MCP tool list, and how to find them in the audit.
6. Connect a client. Use the URL printed by connection.
Claude Code:
export NODE_EXTRA_CA_CERTS="$PWD/netops-ca.pem"
claude mcp add-json -s user netops '{"type":"http","url":"https://<server-name>:<port>/mcp","headers":{"Authorization":"Bearer ${NETOPS_TOKEN}"}}'
claude mcp listCodex (~/.codex/config.toml, token kept in the environment):
export CODEX_CA_CERTIFICATE="$PWD/netops-ca.pem"[mcp_servers.netops]
url = "https://<server-name>:<port>/mcp"
bearer_token_env_var = "NETOPS_TOKEN"The quickstart adds the Codex settings, the commands for a first non-interactive helper_status call with either client and how to find that call in the audit.
Other MCP clients must enable normal CA/SAN verification. Never disable TLS verification.
Tested MCP clients
NetOps 1.0.11: the client acceptance (Codex CLI and Claude Code) runs once on the signed release candidate image; its results are in the release notes. Until 1.0.11 is released, this acceptance is deferred to the release candidate: the release notes describe the required checks and hold no client results yet; the results are added there with the release.
Tested for NetOps 1.0.9 (2026-11-15) against a local amd64 build of the 1.0.9 source at commit 243c14f, which differs from the final source only in tests, documentation and the evidence text of one Admin profile; the release image is checked again by the release acceptance:
Client | Version | Platform | Model | Result |
Codex CLI | 0.169.0 | Linux (Debian 13, amd64) | Client default (no model override) | PASS: Helper, Auditor and Admin roles, 9 calls matched in the audit, wrong token and missing CA rejected |
Claude Code | 2.1.325 | Linux (Debian 13, amd64) | claude-haiku-4-5-20251001 | PASS: Helper, Auditor and Admin roles, 9 calls matched in the audit, wrong token and missing CA rejected |
Tested for NetOps 1.0.8 (2026-11-13) against pre-release builds of the 1.0.8 source; the release image is checked again by the release acceptance:
Client | Version | Platform | Model | Result |
Codex CLI | 0.168.0 | Linux (Debian 13, amd64) | Client default (no model override) | PASS: Helper, Auditor and Admin roles, 9 calls matched in the audit, wrong token and missing CA rejected |
Claude Code | 2.1.323 | Linux (Ubuntu 24.04.5 LTS, amd64) | claude-haiku-4-5-20251001 | PASS: Helper, Auditor and Admin roles, 9 calls matched in the audit, wrong token and missing CA rejected |
Tested for NetOps 1.0.7 (2026-11-12) against the released image ghcr.io/radek-cerny-soukr/netops@sha256:e04b19091819897e1bb4dec11416253b1dd598c18d5567325583b7e7e5fb8dfc:
Client | Version | Platform | Model | Result |
Codex CLI | 0.167.2 | Linux (Debian 13, amd64) | Client default (no model override) | PASS 69/69 |
Claude Code | 2.1.322 | Linux (Ubuntu 24.04.5 LTS, amd64) | claude-haiku-4-5-20251001 | PASS 2/2 |
Each listed client called helper_status over MCP with the instance bearer token and CA; its successful request and response were matched in the audit. Negative checks verified rejection of a wrong token and a missing CA.
Tests of NetOps 1.0.1–1.0.6 are documented in the release history; Open WebUI v0.12.3 was last tested with 1.0.1.
Other MCP clients supporting Streamable HTTP, bearer tokens and normal TLS verification can be used; see the quickstart.
7. Enroll devices. Start with helper_status and read_query_catalog. Enrollment is an operator action with the instance stopped, using private JSON files (mode 600) outside the source repository:
cd ~/netops
docker compose stop
docker compose run -T --rm netops configure helper < helper-private.json
docker compose run -T --rm netops configure admin < admin-private.json
docker compose up -d --waitSee Helper configuration, Admin configuration and the Auditor operator workflows.
Releases and upgrades
This README describes NetOps 1.0.11, the current release. What changed is in the 1.0.11 release notes and the changelog, which also lists the earlier releases. To upgrade a 1.0.10 instance, follow Upgrade from the previous release; to return to the unchanged 1.0.10 instance after an upgrade, follow Rollback. Only 1.0.10 is accepted as the previous release: upgrade 1.0.9 to 1.0.10 first.
Existing inventory and credentials need no manual edits. For the upgrade from 1.0.10 to 1.0.11, Admin enrollments from 1.0.10 stay valid when device and Admin configuration, accounts, firmware and notification settings stay unchanged. The upgrade guide explains keyboard-interactive authentication and connection spacing; the 1.0.11 release notes list the changes.
Verification and release
A release is the maintainer's personally signed checksum list together with the assets it covers. A candidate branch, digest, build or CI run without that signature is not a release.
Signature:
netops-1.0.11-SHA256SUMSis signed with Sigstore (netops-1.0.11-SHA256SUMS.sigstore.json); certificate identity325383355+radek-cerny-soukr@users.noreply.github.com, OIDC issuerhttps://github.com/login/oauth.Covered assets:
compose.yaml,env.example, the release manifest (image index and per-architecture digests), the acceptance manifest, the per-architecture SBOMs, vulnerability scans and scan gate results, the vulnerability assessments and the acceptance reports (acceptance-*.json). The signed checksum list itself is the complete list of covered files.Build once: every release candidate is built once in GitHub Actions and the same digests are tested, accepted and published without a rebuild. The wheel inside the image is built with
SOURCE_DATE_EPOCHset to the time of the source commit (git log -1 --format=%ct), so two builds of the same commit produce a byte-identical wheel; the Dockerfile refuses to build the wheel without it.Building behind TLS inspection: if a proxy or firewall decrypts TLS (for example FortiGate deep inspection),
docker buildstops at the first download:apkprintsTLS: server certificate not trustedandERROR: Not continuing due to stale/unavailable repositories., and pip printsERROR: Could not find a version that satisfies the requirement <package>==<version> (from versions: none). Pass a CA bundle that contains the inspection CA as a BuildKit secret, for example the system bundle of a Debian or Ubuntu host that trusts that CA:docker build --secret id=extra_ca,src=/etc/ssl/certs/ca-certificates.crt --build-arg SOURCE_DATE_EPOCH="$(git log -1 --format=%ct)" .The file is added to the image's own bundle only while the download steps run and is not stored in any image layer. Without the secret the build runs the same commands as before, and with or without it the wheel is byte-identical. The tester image of Qualification accepts the same secret; see Source checkout problems.Vulnerabilities: each architecture is scanned; a fixable High or Critical finding blocks the release unless a dated assessment records that the fixed version is not yet released, and every other finding ships with a written assessment (
netops-1.0.11-vulnerability-assessments.json). Open findings without a fix available for the base image are listed in the release notes (Known dependency findings) with their assessments. The digests of the latest release are rescanned daily against its assessments.Acceptance of 1.0.11: the acceptance is proportional to the change, and the release notes list its checks. Their results are the acceptance reports (
acceptance-*.json) covered by the signed checksum list; the maintainer signs only a release whose required reports pass. The acceptance of 1.0.10 is described in its release notes.
Use the image digest and configuration files from one signed release manifest. Qualification from a source checkout is described in Qualification.
Documentation
Topic | Document |
Installation, clients, audit, lifecycle, backup and restore | |
Helper inventory/vault input and first device operation | |
Admin device, safeguard, notification, enrollment, preview, apply and undo | |
MCP tool references | |
Role UIDs, peer authentication, audit durability and redaction, certificates, syslog delivery | |
Exact host, firmware and model scope | |
Security policy and vulnerability reporting | |
CIS Docker Benchmark v1.6.0 self-assessment | |
Qualification from a source checkout | |
Product changes |
Known limitations
1.0 starts from a clean installation; it does not upgrade or migrate 0.x installations or data.
NetOps runs as one instance in one container (
compose.yamldefines the single servicenetops). There is no high-availability or clustering mode and no state shared between instances, and there is no graphical user interface: access is through MCP clients and the operator commands.On FortiOS the Auditor collects with a
super_adminadministrator, which can also write; restrict it withtrusthost. A read-only profile hides other accounts' entries without saying so. See account model.Each role reads its device credentials only from its own private vault, a single JSON document (see Core vault); the same device login can be enrolled in several roles, and NetOps does not compare them (account model).
The roles are isolated as processes and files inside one container, not against the host administrator or the container runtime.
Authenticated requests with bodies above 64 KiB or uncertain body framing are processed one at a time across roles, so they can queue behind another large request; other authenticated requests share the remaining slots within the limit of 16.
The request body has a 60-second receipt deadline. Since 1.0.3 the gateway has a separate 60-second deadline for the whole buffered, audited MCP response send sequence, not for each chunk. This does not bound execution time or prove that the client application read the response. During body delivery a receive watcher also detects ASGI disconnect events. An observed disconnect, timeout, cancellation, receive-channel or send-channel failure attempts an interruption record when the audit is writable, and the operation slot is released. A small buffered send or a close after the monitored phase may go unobserved; inspect
audit pendingbefore repeating an operation. See the 1.0.3 response-delivery notes.An incomplete local audit write blocks further operations until
netops audit recoverruns while the instance is stopped. A full syslog queue blocks new operations, and an interrupted send can deliver records to the receiver more than once.Syslog records remain bounded at 8 MiB and use numbered 1024-byte parts with a persistent record ID and whole SHA256. Messages are at most 1618 bytes including their header. Configure a dedicated receiver archive filtered by RFC5424 APP-NAME
netops, preserving exact MSG+LF, before the first start. Offlineaudit reassemble --record-idfreezes the first complete SHA-valid set in archive order: later conflicts or invalid rows preserve its bytes and produce typed warnings/exit 3; earlier validation or input-read errors give exit 2 without record output. Keep older 1.0 full-record archives separately. Native default-limit storage checks verified rsyslog 8.2504 and 8.2512 with gtls and ossl and syslog-ng 4.12 on arm64 and amd64, each receiver running in a container.There is no supported provisioning path for the schema registry/library files of Helper
schema_read, the extra input files of Auditor--suppressions,merge-sarifandschema-check, or file-based Admin offline and schema workflows.ftp_listis refused before any device contact, and no configuration enables it. Its engine checks the requested path against the target'ssftp_rootsonly lexically, as a canonical absolute path equal to a root or below it; unlikesftp_stat, it does not let the server resolve the path, so a symbolic link below a root that leads out of it would not be refused.The opt-in FortiOS
managed_switch_stackingandmanaged_switch_poequeries have no positive result on stacking- or PoE-capable hardware. Virtual device images do not establish physical hardware behavior.The process-profile acceptance check samples at a nominal 50 ms interval and can miss short-lived processes; see the 1.0.1 release notes for the exact attribution rule.
Supported releases and distribution
Only the shared NetOps 1.0.x product is supported. The earlier standalone 0.x components have no support, no migration path and no security monitoring; NetOps 1.0.x does not migrate 0.x data or modify 0.x volumes. NetOps is distributed exclusively through GitHub: the source repository, GitHub Releases, and container images in GitHub Container Registry (GHCR). It is not distributed through PyPI.
License
NetOps is an open-source project by Radek Černý, distributed under the MIT license. Compatible MCP clients remain vendor-neutral.
Disclaimer
NetOps is open-source software provided "as is", without warranty of any kind, as stated in the MIT license. You use it entirely at your own risk. The author currently has no plans to offer a commercial NetOps product or paid support. The MIT license permits commercial use, forks and redistribution.
No liability. The MIT license disclaims liability for the software's authors or copyright holders for claims, damages or other liability arising from the software or its use, including changes that the Admin role makes to network devices.
No obligation to support or fix. There is no service-level agreement and no commitment to provide support, answer questions, fix defects or security issues, publish updates or keep the project maintained. Any fix or release is voluntary and may never happen.
Your responsibility. Before any production use, you are responsible for evaluating NetOps in your environment, verifying device accounts and permissions, keeping configuration backups, testing changes, and following your organization's policies and applicable law.
Not a vendor product. NetOps is not a product of Fortinet, Extreme Networks, Cisco, Arista, Juniper, Ruckus or any other vendor whose devices or software it supports, nor of the vendors of the MCP clients and models named in this documentation. These vendors bear no responsibility for defects or errors in NetOps or for its effects on their devices, and they provide no support for it. Product and company names are trademarks of their respective owners and are used only to describe compatibility.
No certification. Published tests, qualification results and supported-platform lists describe their documented scope and observations. They are not a guarantee, certification or fitness-for-purpose statement for your deployment.
Forks and redistributions. Anyone may fork or redistribute NetOps under the MIT license, including commercially. Such versions are not provided, endorsed or supported by the author, and they create no obligation on the author's part toward their users.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Scoped, audited SSH exec, sessions, and SFTP on your saved servers without exposing credentials
Manage remote servers, SSH terminals, files, databases and proxies with scoped access and approvals.
Let AI operate servers without SSH. Choose actions, approve risky changes, and audit every step.
SSH client, server management and one remote MCP URL for your machines, with human approvals.
Related MCP Servers
- AlicenseAqualityCmaintenanceEnables remote server administration via SSH, supporting command execution, SFTP file transfers, and multi-profile management. It features security safeguards like destructive command detection and audit logging to ensure safe interaction with remote Linux/Unix environments.178 npmMIT
- AlicenseNot gradedqualityDmaintenanceEnables AI assistants to execute SSH commands on network devices using natural language, supporting multiple vendors and authentication methods for automated network management.GPL 3.0
- FlicenseNot gradedqualityCmaintenanceEnables agents to access network device management interfaces via SSH, keeping credentials on the server side. Supports both interactive terminal sessions and command execution on devices like Huawei VRP, MikroTik, and OpenWrt.2-
- AlicenseNot gradedqualityDmaintenanceEnables persistent SSH connections to Linux hosts and network devices, with secure credential storage, configuration backup/restore, SFTP, and SSH tunneling.2MIT