Tools
- Read MCP Server Settings
- Describe Editable MCP Settings
- Validate and Preview MCP Settings
- Safely Update MCP Settings
- Keep a Pending MCP Settings Change
- Revert a Pending MCP Settings Change
get_mcp_settings
Read MCP Server Settings · Risk: read
Read the MCP host's editable settings, opaque revision and pending change. Covers tool presentation, SSH pooling, dashboard recording, Memory enablement and startup update checks. Contains no credentials; never contacts a router. These are configured values, not proof a startup-only component has restarted. Read before preview_mcp_settings or update_mcp_settings.
No tool-specific parameters.
get_mcp_settings_schema
Describe Editable MCP Settings · Risk: read
Get the exact JSON Schema for the partial changes accepted by preview_mcp_settings and update_mcp_settings. Unknown/protected fields are rejected, omitted fields stay unchanged. Credentials, listeners, file paths, device inventory and permission ceilings are operator-managed. No device or file changes.
No tool-specific parameters.
preview_mcp_settings
Validate and Preview MCP Settings · Risk: read
Validate a partial MCP settings change against live configuration and return changed paths, a secret-free diff, revision and restart requirements. No file writes or router contact. Show the preview and obtain user approval before applying; never guess setting names.
| Parameter | Required | Definition |
|---|---|---|
changes | Yes | Only the fields to change; omitted values are preserved. {"type":"object","properties":{"mcp":{"type":"object","properties":{"toolPageSize":{"type":"integer","minimum":0,"maximum":9007199254740991},"appViews":{"type":"boolean"},"capabilityGating":{"type":"string","enum":["off","annotate","filter"]}},"additionalProperties":false},"ssh":{"type":"object","properties":{"keepAlive":{"type":"boolean"},"keepAliveInterval":{"type":"integer","minimum":0,"maximum":9007199254740991},"idleTimeout":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"additionalProperties":false},"dashboard":{"type":"object","properties":{"maxEvents":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"captureBody":{"type":"boolean"},"redactInput":{"description":"May enable redaction, never disable it.","type":"boolean","const":true},"maxBodyBytes":{"type":"integer","minimum":0,"maximum":9007199254740991},"feedLimit":{"type":"integer","exclusiveMinimum":0,"maximum":10000}},"additionalProperties":false},"memory":{"type":"object","properties":{"enabled":{"type":"boolean"}},"additionalProperties":false},"disableUpdateCheck":{"type":"boolean"}},"additionalProperties":false} |
update_mcp_settings
Safely Update MCP Settings · Risk: write
Apply explicitly user-approved MCP host settings, not RouterOS configuration. First get_mcp_settings_schema and preview_mcp_settings; supply that revision and confirm=true. Backs up the source JSON, persists the full config and arms a 30–600s in-process rollback (default 60s). Normal files use atomic replacement; a single-file Docker bind mount uses a backed-up in-place write that is not crash-atomic. Conflicts with another pending dashboard/tool edit are rejected. Verify configured values with get_mcp_settings, then confirm_mcp_settings before the deadline or rollback_mcp_settings. Never restart while pending: the rollback timer does not survive process exit. Restart-required settings are only fully activated after confirmation and a separate operator-controlled restart. Does not widen access scopes or change router addresses/credentials.
| Parameter | Required | Definition |
|---|---|---|
changes | Yes | {"type":"object","properties":{"mcp":{"type":"object","properties":{"toolPageSize":{"type":"integer","minimum":0,"maximum":9007199254740991},"appViews":{"type":"boolean"},"capabilityGating":{"type":"string","enum":["off","annotate","filter"]}},"additionalProperties":false},"ssh":{"type":"object","properties":{"keepAlive":{"type":"boolean"},"keepAliveInterval":{"type":"integer","minimum":0,"maximum":9007199254740991},"idleTimeout":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"additionalProperties":false},"dashboard":{"type":"object","properties":{"maxEvents":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"captureBody":{"type":"boolean"},"redactInput":{"description":"May enable redaction, never disable it.","type":"boolean","const":true},"maxBodyBytes":{"type":"integer","minimum":0,"maximum":9007199254740991},"feedLimit":{"type":"integer","exclusiveMinimum":0,"maximum":10000}},"additionalProperties":false},"memory":{"type":"object","properties":{"enabled":{"type":"boolean"}},"additionalProperties":false},"disableUpdateCheck":{"type":"boolean"}},"additionalProperties":false} |
revision | Yes | Current revision from get_mcp_settings or preview_mcp_settings. {"type":"string","minLength":64,"maxLength":64} |
confirm | Yes | Only set after the user authorizes these exact changes. {"type":"boolean","const":true} |
rollback_seconds | Yes | {"default":60,"type":"integer","minimum":30,"maximum":600} |
confirm_mcp_settings
Keep a Pending MCP Settings Change · Risk: write
Keep the exact pending change created by update_mcp_settings after reading back its values. Cancels its rollback timer. Requires the current revision and pending_id; cannot confirm dashboard-owned, expired or superseded changes. Does not restart the MCP server or contact routers.
| Parameter | Required | Definition |
|---|---|---|
pending_id | Yes | {"type":"string","minLength":1} |
revision | Yes | Revision returned by update_mcp_settings or get_mcp_settings. {"type":"string","minLength":64,"maxLength":64} |
rollback_mcp_settings
Revert a Pending MCP Settings Change · Risk: write
Restore the host-side config backup for a still-pending update_mcp_settings change. Requires its pending_id and current revision. Refuses dashboard-owned transactions or changes that would overwrite newer configuration. Restores configured values only; no router changes, server restart or deletion of knowledge data.
| Parameter | Required | Definition |
|---|---|---|
pending_id | Yes | {"type":"string","minLength":1} |
revision | Yes | Revision returned by update_mcp_settings or get_mcp_settings. {"type":"string","minLength":64,"maxLength":64} |