Return the current map state: all nodes, manual connections, stickies and notes. NOTE: only manual connections are included — use map_get_all_connections to also get auto-generated connections (DNS→server, project→server, service→node).

Add a new node to the map. Returns the new node id.

Update fields of an existing node by id.

FIELD SCHEMA BY NODE TYPE All types: name, ip, x, y, w, h, notes ips: [{address, label}] — extra IP addresses

server / pc / nas / ap / camera / printer / router / switch / firewall / other: ports: [{port, protocol("tcp"|"udp"|"icmp"), service, url, bindIp}] dockerServices: [{name, image, hostPort, containerPort, protocol("tcp"|"udp"), url}]

project: parentServer — id of the parent server node (creates auto-connection) repoUrl — Git/GitLab URL deployPath — deployment directory cicdUrl — CI/CD pipeline URL dockerServices (same as server)

domain (DNS Zone): ip — registrar name (e.g. "Cloudflare") registrarUrl — registrar control panel URL domains: [{name, record("A"|"AAAA"|"CNAME"|"MX"|"TXT"|"NS"|"SRV"), target, url}] target IP in 'target' triggers auto-connection to matching server node

service (External Service): provider — provider name (e.g. "Supabase", "Vercel") dashboardUrl — link to service dashboard serviceConns: [{toId, label}] — links to other nodes (creates auto-connections) servedDomains: [string]

Delete a node and all its connections.

Add a manual connection between two nodes. Returns the new connection id.

Delete a connection by id.

Add a sticky note to the map. Returns the new sticky id.

Move a node to new canvas coordinates without changing any other fields.

Move a sticky note to new canvas coordinates without changing its text or color.

Remove all nodes, connections and stickies from the current sheet.

Auto-arrange all nodes in a grid or circle layout.

Update label or color of an existing connection.

Update text, color or size of a sticky note.

Delete a sticky note by id.

List all sheets with their id, name, createdAt, updatedAt and which is active.

Return nodes/connections/stickies/notes for a specific sheet (defaults to active sheet).

Create a new empty sheet and switch to it. Returns new sheet id.

Switch the active sheet. Saves current sheet state first.

Rename a sheet.

Delete a sheet. Cannot delete the last remaining sheet.

Set canvas zoom level (0.1–3.0).

Pan canvas to an absolute pixel offset.

Auto-fit all nodes into the viewport by adjusting zoom and pan.

Return the sheet-level notes text.

Set the sheet-level notes text.

Lock or unlock a sheet. A locked sheet rejects all MCP mutations and disables manual editing in the UI. Pass locked: false to unlock.

Return current app settings (sshMode, dblClickAction, perfMode, showGrid, showZoomSlider).

Update one or more app settings.

Return all connections including auto-generated ones (DNS→server, project→server, service→node). Auto connections have auto:true flag. Use this instead of map_get_state.connections when you need the full topology picture.

Return current canvas zoom level and pan offset.

Search nodes by name, IP, type, or free-text query. Returns id, name, type, ip, x, y for each match. Use this to locate a node before updating it.

Full-text search across nodes (name/ip/notes), stickies, connection labels, and ports (port-number/service). Returns categorized hits with a total count. Use map_find_node for structured node-only filtering.

Parse nmap scan output (XML from nmap -oX) and create nodes with their open ports. Auto-infers node type from OS fingerprint + port profile (router/switch/firewall/server/printer/etc.). Provide either raw xml OR pre-parsed hosts[] — hosts takes priority when both are given. Nodes are auto-arranged in a grid. Returns {count, ids}.

Smart auto-layout: force-directed (organic, deterministic with seed), cluster-by-type (horizontal lanes per node type), or cluster-by-connection (BFS components → separate zones). Different from map_arrange (naive grid/circle). Mutates node positions in-place.

Import nodes from CSV. Auto-detects columns from the header row (name/ip/type/ports/notes — case-insensitive, aliases like hostname/description/host_ip accepted). Ports field accepts 'port/protocol,port/protocol' (e.g. '22/tcp,80/tcp') or bare port numbers (default tcp). Nodes laid out in a 6-column grid. Returns {count, ids}.

Return all nodes of a given type with FULL field data (ports, dockerServices, domains, ips, notes, parentServer, etc.). For stripped projection or multi-criteria filtering use map_find_node instead.

Replace active sheet content with provided JSON data. Useful for loading a prepared topology in one call.

Export sheet data as JSON including auto-connections. Defaults to active sheet.

Export current or specified sheet as JSON / PNG / PDF. PNG and PDF return base64-encoded blobs with mimeType — the client decodes and saves to a file. Server raises the response timeout to 30s for PNG/PDF since large maps can take several seconds to render.

Clone a node with all its properties (ports, services, domains, etc.). Returns new node id.

Return currently selected node/sticky ids and connection id. Result shape: { nodeIds: string[], nodeId: string|null (= nodeIds[0], legacy single-id), connId: string|null }.

Programmatically select node(s)/sticky(s) and/or a connection. Pass node_ids (array) for multi-select; node_id (string) is legacy single-select. Empty array or null deselects. Connection selection remains single (multi-select connections out of scope v1).

Add multiple nodes in a single call. Each node accepts the same fields as map_add_node plus all type-specific fields (ports, dockerServices, domains, parentServer, etc.). Returns array of created ids.

Add multiple connections in a single call. Returns array of created ids.