Oxidized MCP

Install

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

npx agentmarket install connector/mhajder-oxidized-mcp

About

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

Permissions

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

Tools

9 read · 2 write · 0 delete

Secrets

1 (API keys, tokens or passwords)

Install scripts

None found

Runs as

Python package

Tools (11)

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

• diff_node_versionsread-only

  Show what changed in a node's configuration between two versions. Returns a unified diff from 'base_oid' (older) to 'oid' (newer). With no arguments besides the node it shows the most recent change. Args: node: Node name or IP address oid: Newer version oid; defaults to the latest version base_oid: Older version oid; defaults to the version before 'oid' group: Node group; looked up automatically when omitted context_lines: Unchanged lines of context around each change max_lines: Maximum diff lines to return offset: Zero-based first diff line to return; when 'trunc…

• find_nodesread-only

  Find nodes by partial name, full name or IP address. Useful to resolve an ambiguous device name before calling other tools. Exact matches are listed first, then prefix matches, then other substring matches (all case-insensitive). Args: query: Part of a node name, full name or IP address limit: Maximum nodes to return Returns: Dictionary with the total match count and compact node summaries

• get_backup_statsread-only

  Summarise backup health across Oxidized nodes. Computed from the node list (oxidized-web's own stats JSON is not usable): counts per last-run status, per group and per model, the success rate, and lists of failed nodes, nodes never backed up and stale nodes. Optionally limited to one group or model, filtered by Oxidized itself. "Stale" means Oxidized has not *attempted* a backup within the threshold (e.g. it is not polling the node); nodes that are attempted but keep failing are listed under failed_nodes instead. Oxidized does not expose the time of the last *successful* backup, and its run …

• get_noderead-only

  Get details of a single Oxidized node. Returns the node's name, full name, IP, group, model, vars and details of its last backup run (start, end, status, duration). Args: node: Node name or IP address Returns: Dictionary containing the node details

• get_node_configread-only

  Get the latest backed-up configuration of a node. Large configurations are paged by lines: when 'truncated' is true, call again with offset set to 'next_offset' to read the rest. Args: node: Node name or IP address group: Node group; looked up automatically when omitted offset: Zero-based first line to return max_lines: Maximum lines to return (0 = whole configuration) Returns: Dictionary with size information and the configuration 'content'

• get_node_versionread-only

  Get the configuration of a node as it was at a specific version. Large configurations are paged by lines: when 'truncated' is true, call again with offset set to 'next_offset' to read the rest. Args: node: Node name or IP address oid: Version oid (full or unique prefix) group: Node group; looked up automatically when omitted offset: Zero-based first line to return max_lines: Maximum lines to return (0 = whole configuration) Returns: Dictionary with the version, size information and 'content'

• list_node_versionsread-only

  List the stored configuration versions of a node, newest first. Each version has its git oid, date, author and commit message. Requires the Oxidized 'git' (or 'gitcrypt') output. Args: node: Node name or IP address group: Node group; looked up automatically when omitted limit: Maximum versions to return Returns: Dictionary with the node identity, total version count and versions

• list_nodesread-only

  List nodes (network devices) managed by Oxidized. Returns each node's name, full name (group/name), IP, group, model, last run status and time, and last run details. Node vars are redacted unless redaction is disabled in the server configuration. Pass a group or model on large installations: they are filtered by Oxidized itself, so only matching nodes are transferred. The group must match exactly; use find_nodes when unsure of the name. Args: group: Only nodes in this group model: Only nodes of this Oxidized model status: Only nodes whose last run had this status name_contain…

• reload_nodes

  Reload the Oxidized node list from its source (router.db, SQL, HTTP, ...). Use after devices were added, removed or changed in the source so Oxidized picks up the change without waiting for its next refresh. Always reloads every node: oxidized-web's per-node reload (/reload?node=X) replaces the whole in-memory node list with just the matching nodes, so it is deliberately not offered. Returns: Dictionary with Oxidized's response message

• search_configsread-only

  Search the latest configurations of all nodes for a pattern. oxidized-web first finds the nodes whose configuration matches, then those configurations are fetched to return the matching lines with line numbers. Use this to answer questions such as "which devices still have telnet enabled" or "where is VLAN 42 configured". The pattern must be valid in both Ruby (oxidized-web) and Python regular expressions - stick to common syntax. Lines are matched one at a time, so patterns spanning several lines find nodes but no lines. Args: pattern: Regular expression or literal text to search for …

• trigger_node_backup

  Queue an immediate configuration backup of a node. Oxidized moves the node to the head of its queue; the backup itself runs asynchronously. Check get_node afterwards for the run result, and list_node_versions for a new version if the configuration changed. Oxidized picks the node by name or IP only (no group), so node names must be unique - otherwise the first node with that name is queued. Args: node: Node name or IP address message: Commit message recorded if a new version is created user: Author name recorded if a new version is created Returns: Dictionary confirming the …

Compare and alternatives

Featured in

• Best MCP servers for networking

Signals

Stars

0

Forks

0

Open issues

0

Weekly downloads

230

Last commit

Oct 23, 2026 (5 days ago)

Last release

Oct 23, 2026 (5 days ago)

Last package publish

Oct 23, 2026 (5 days ago)

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

Details

Registry name

io.github.mhajder/oxidized-mcp

Version

0.2.1

Auth

API key

Packages

pypi oxidized-mcppypi oxidized-mcpoci ghcr.io/mhajder/oxidized-mcp:0.2.1

License

MIT

Repository

github.com/mhajder/oxidized-mcp

Website

github.com/mhajder/oxidized-mcp

First seen

Oct 24, 2026

Last checked

Oct 24, 2026

Source

Official MCP Registrygithub-graphql