eos-mcp demonstrates solid naming conventions (verb_noun pattern: get_*, push_*, confirm_*, abort_*) and comprehensive parameter descriptions. All 17 tools have clear, detailed docstrings (avg ~150 chars, well above 10-char minimum). Input schemas are present with type declarations and descriptions for all parameters. However, output schemas are entirely undocumented, tools return strings or dicts without specifying field structure, forcing LLMs to parse unstructured text. Error handling is minimal: most tools catch exceptions and return error strings rather than structured error objects with recovery guidance. No tool annotations (readOnlyHint, destructiveHint, idempotentHint) despite clear risk stratification (READ_ONLY, WRITE, REVERSIBLE). Batch tools (get_device_facts_batch, run_command_batch, run_commands_batch, daily_brief) lack pagination/limit enforcement, no documented caps on result size, risking context window exhaustion.
Abort a pending configure session. Use this to discard uncommitted changes from a push_config call. Can be called on any pending session, whether or not you created it.
Collect tech-support bundle from an EOS device. Returns show tech-support output (large — may take 30+ seconds). Useful for troubleshooting and support escalation.
Confirm (finalize) a pending configure session commit timer. Use this after push_config with dry_run=False to commit the changes permanently. Without this call, the timer will auto-rollback after the configured duration.
Morning patrol: device health summary with recent syslog anomalies. Scans syslog for interface/BGP/OSPF/STP/MLAG/ARP anomalies over the past N hours (default 24) and reports per-device status (OK / WARNING / CRITICAL) with a health summary. Useful for daily standup or automated alerting. Returns markdown-formatted brief with per-device sections.
Return running-config from an EOS device.
Output schemas completely undocumented. Tools return strings or dicts without specifying field structure (e.g., get_device_facts returns formatted text, daily_brief returns markdown). LLMs cannot parse unstructured output reliably or plan downstream tool calls.
Batch tools (get_device_facts_batch, run_command_batch, run_commands_batch, daily_brief) lack documented result limits or pagination. No cap on max_workers default (5) or result size, large fleets could exhaust context window.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | D | 58 | 2025-06-18+ | v2 |
Show config diff on an EOS device. rollback_id=1 (default) → diff vs most recent rollback checkpoint. rollback_id=N → diff vs Nth rollback checkpoint. Note: diff vs startup-config requires EOS 4.30+; older versions fall back gracefully.
Return structured device facts: hostname, model, serial, EOS version, uptime, memory.
Return device facts (model, serial, EOS version, uptime) for multiple devices in parallel.
List EOS devices registered in config, optionally filtered by tags.
Return EOS version string for a device (quick connectivity check).
Report server version and configuration status (lightweight). Call this at session start (or after a tool-call timeout) to confirm the MCP is up, see which version is running, and verify the device inventory config loads. Lightweight: it only reads and parses config.ini — it does NOT open any eAPI/pyeapi connection to EOS devices, so it is safe to call against a large fleet without touching the network. Always returns the same keys: ``status`` (healthy / degraded / error), ``service``, ``version``, ``config_path`` (resolved config.ini path), ``device_count`` (EOS hosts in config), ``tags`` (sorted distinct tags), and ``config`` (ok / error / missing). On a degraded or error result, ``detail`` carries the reason.
List configure sessions and their state on an EOS device. Shows pending, pendingCommitTimer, and completed sessions. Useful for tracking in-flight push_config operations.
Apply config lines via a named configure session with optional commit timer. When dry_run=True the session is aborted after showing diffs (safe preview). When dry_run=False the session is committed with a rollback timer (default 300s). Use confirm_config_session to finalize, or let the timer expire to auto-rollback. Returns session name, diffs, committed flag, and timer seconds.
Run a single enable-mode command on an EOS device and return text output.
Run a single enable-mode command on multiple EOS devices in parallel and return labelled output.
Run multiple enable-mode commands on one EOS device and return labelled output.
Run multiple enable-mode commands on multiple EOS devices in parallel and return labelled output.
No tool annotations despite clear risk stratification. push_config is WRITE (destructive), confirm_config_session and abort_config_session are REVERSIBLE, others are READ_ONLY. Missing destructiveHint/idempotentHint prevents LLMs from reasoning about safety.
Error handling returns plain strings ('Error: ...') instead of structured error objects. No recovery guidance, error classification (retryable vs fatal), or actionable next steps for LLMs.
push_config accepts dry_run and commit_timer but lacks explicit confirmation step for non-dry-run commits. Agents could accidentally commit config changes without explicit user approval.