# aditya0252/juniper-mist-mcp-server architecture

> Architecture diagram of the GitHub repository aditya0252/juniper-mist-mcp-server, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-19). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/aditya0252/juniper-mist-mcp-server
- Repository: https://github.com/aditya0252/juniper-mist-mcp-server

## Overview

Juniper Mist MCP is a single-module server that exposes Mist network queries as tools for Claude. The principal workflow is Claude requesting a tool through MCP, the server querying Mist, and the result returning through MCP. Tool capabilities span organization and sites, device management, monitoring, client and wireless operations, and NAC troubleshooting and audit. The only runtime source file is a large monolith; the README documents the tool areas, while the excerpts show selected API handling and formatting. Specific tool-to-endpoint calls are not established by the excerpts, so they are not mapped individually.

Main entry points: [`src/juniper_mist_mcp/__init__.py`](https://github.com/aditya0252/juniper-mist-mcp-server/blob/main/src/juniper_mist_mcp/__init__.py) (Mist MCP server)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_server["MCP server"]
  node_mcp["Mist MCP server<br/>[__init__.py]"]
end

subgraph group_inventory["Organization and inventory"]
  node_org_sites["Organizations and sites<br/>[__init__.py]"]
  node_devices["Device management<br/>[__init__.py]"]
end

subgraph group_monitoring["Network monitoring"]
  node_monitor["Network monitoring<br/>[__init__.py]"]
end

subgraph group_access["Client and access"]
  node_clients["Clients and wireless<br/>[__init__.py]"]
  node_nac["NAC and authentication<br/>[__init__.py]"]
  node_audit["Audit logs<br/>[__init__.py]"]
end

node_claude(("Claude"))
node_mist["Juniper Mist API"]

node_claude -->|"requests tools"| node_mcp
node_mcp -->|"queries API"| node_mist
node_mcp -->|"exposes tools"| node_org_sites
node_mcp -->|"exposes tools"| node_devices
node_mcp -->|"exposes tools"| node_monitor
node_mcp -->|"exposes tools"| node_clients
node_mcp -->|"exposes tools"| node_nac
node_mcp -->|"exposes tools"| node_audit

click node_mcp "https://github.com/aditya0252/juniper-mist-mcp-server/blob/main/src/juniper_mist_mcp/__init__.py"
click node_org_sites "https://github.com/aditya0252/juniper-mist-mcp-server/blob/main/src/juniper_mist_mcp/__init__.py"
click node_devices "https://github.com/aditya0252/juniper-mist-mcp-server/blob/main/src/juniper_mist_mcp/__init__.py"
click node_monitor "https://github.com/aditya0252/juniper-mist-mcp-server/blob/main/src/juniper_mist_mcp/__init__.py"
click node_clients "https://github.com/aditya0252/juniper-mist-mcp-server/blob/main/src/juniper_mist_mcp/__init__.py"
click node_nac "https://github.com/aditya0252/juniper-mist-mcp-server/blob/main/src/juniper_mist_mcp/__init__.py"
click node_audit "https://github.com/aditya0252/juniper-mist-mcp-server/blob/main/src/juniper_mist_mcp/__init__.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_mcp toneBlue
class node_org_sites,node_devices toneAmber
class node_monitor,node_mist toneMint
class node_clients,node_nac,node_audit toneRose
class node_claude toneIndigo
```

## Components

### MCP server

- [Mist MCP server](https://github.com/aditya0252/juniper-mist-mcp-server/blob/main/src/juniper_mist_mcp/__init__.py): `src/juniper_mist_mcp/__init__.py`

### Organization and inventory

- [Organizations and sites](https://github.com/aditya0252/juniper-mist-mcp-server/blob/main/src/juniper_mist_mcp/__init__.py): `src/juniper_mist_mcp/__init__.py`
- [Device management](https://github.com/aditya0252/juniper-mist-mcp-server/blob/main/src/juniper_mist_mcp/__init__.py): `src/juniper_mist_mcp/__init__.py`

### Network monitoring

- [Network monitoring](https://github.com/aditya0252/juniper-mist-mcp-server/blob/main/src/juniper_mist_mcp/__init__.py): `src/juniper_mist_mcp/__init__.py`

### Client and access

- [Clients and wireless](https://github.com/aditya0252/juniper-mist-mcp-server/blob/main/src/juniper_mist_mcp/__init__.py): `src/juniper_mist_mcp/__init__.py`
- [NAC and authentication](https://github.com/aditya0252/juniper-mist-mcp-server/blob/main/src/juniper_mist_mcp/__init__.py): `src/juniper_mist_mcp/__init__.py`
- [Audit logs](https://github.com/aditya0252/juniper-mist-mcp-server/blob/main/src/juniper_mist_mcp/__init__.py): `src/juniper_mist_mcp/__init__.py`

### Other components

- **Claude**
- **Juniper Mist API**

## Connections

- Claude → Mist MCP server: requests tools (evidence: `README.md`)
- Mist MCP server → Juniper Mist API: queries API (evidence: `README.md`)
- Mist MCP server → Organizations and sites: exposes tools (evidence: `README.md`)
- Mist MCP server → Device management: exposes tools (evidence: `README.md`)
- Mist MCP server → Network monitoring: exposes tools (evidence: `README.md`)
- Mist MCP server → Clients and wireless: exposes tools (evidence: `README.md`)
- Mist MCP server → NAC and authentication: exposes tools (evidence: `README.md`)
- Mist MCP server → Audit logs: exposes tools (evidence: `README.md`)
