CML Administration
MCP Server
- Command:
cml-mcp (pip-installed, stdio transport)
- Requires:
CML_URL, CML_USERNAME, CML_PASSWORD environment variables
Available Tools
User Management
| Tool |
Parameters |
What It Does |
get_users |
none |
List all CML users |
create_user |
username, password, fullname?, email?, admin? |
Create a new CML user |
get_user |
user_id/username |
Get user details (labs, resource usage) |
update_user |
user_id/username, fields to update |
Update user properties |
delete_user |
user_id/username |
Delete a CML user |
Group Management
| Tool |
Parameters |
What It Does |
get_groups |
none |
List all CML groups |
create_group |
name, description?, members? |
Create a new group |
update_group |
group_id/name, fields to update |
Update group properties |
delete_group |
group_id/name |
Delete a group |
System Information
| Tool |
Parameters |
What It Does |
get_system_info |
none |
CML version, uptime, resource usage (CPU, RAM, disk) |
get_node_defs |
none |
List all available node definitions and their resource requirements |
get_licensing |
none |
License status, node count, expiration |
get_resource_usage |
none |
Current resource utilization across all labs |
Workflow: Onboard a New Lab User
When an admin wants to add a new team member:
- Check existing users:
get_users to see current user list
- Create the user:
create_user with their credentials
- Add to group (optional):
update_group to add user to a team group
- Verify:
get_user to confirm creation
- Share credentials: Report the username and CML URL to the admin (never share the password in Slack)
Workflow: Resource Capacity Check
Before building a large lab:
- Check system resources:
get_system_info for CPU, RAM, disk
- Check licensing:
get_licensing for available node count
- Check node definitions:
get_node_defs for per-node resource requirements
- Calculate: Does the planned lab fit within available resources?
- Report: "You have X GB RAM free, Y CPU cores available, Z node licenses remaining. Your planned lab needs A GB RAM and B nodes."
Workflow: System Health Report
For CML server health monitoring:
- System info:
get_system_info — version, uptime, resource usage
- Licensing:
get_licensing — license status and node count
- Resource usage:
get_resource_usage — breakdown by lab/user
- Active labs:
get_labs (from cml-lab-lifecycle) — list running labs
- Generate report: Summary of CML platform health
Resource Planning Guide
Typical per-node resource requirements:
| Node Type |
vCPUs |
RAM |
Disk |
| IOSv |
1 |
512 MB |
2 GB |
| IOSv L2 |
1 |
768 MB |
2 GB |
| CSR1000v / Cat8000v |
1 |
3 GB |
8 GB |
| NX-OS 9000v |
2 |
6 GB |
8 GB |
| IOS-XR 9000v |
2 |
8 GB |
16 GB |
| ASAv |
1 |
2 GB |
8 GB |
| Ubuntu Server |
1 |
512 MB |
8 GB |
| Unmanaged Switch |
0 |
0 |
0 |
| External Connector |
0 |
0 |
0 |
Rule of thumb: Plan for the CML host to have at least 2x the total RAM needed by all concurrent labs, plus 8 GB for the CML OS itself.
User Roles
| Role |
Capabilities |
| Admin |
Full access: create/delete users, manage all labs, system settings |
| User |
Create/manage own labs, view shared labs |
Workflow: Audit CML Usage
For tracking who's using what:
- List all users:
get_users
- For each user:
get_user to see their labs and resource usage
- List all labs:
get_labs with ownership info
- Check resource usage:
get_resource_usage for allocation breakdown
- Report: Table of users, their labs, running state, and resource consumption
- Identify stale labs: Labs that have been stopped for days — candidates for cleanup
Important Rules
- Admin operations require admin credentials — user management needs admin-level CML access
- Never share passwords in Slack — report usernames only, instruct admin to share credentials securely
- Check resources before big labs — don't let users build labs that exceed server capacity
- Monitor licensing — CML has node count limits; stay within license boundaries
- Record in GAIT — log all admin operations for audit trail
Environment Variables
CML_URL — CML server URL
CML_USERNAME — CML username (admin for full access)
CML_PASSWORD — CML password
CML_VERIFY_SSL — Verify SSL certificate (true/false)
1---
2name: cml-admin
3description: "CML administration — user/group management, system info, licensing, resource monitoring. Use when creating CML users, checking license status, monitoring CML server resources, or auditing lab usage across teams."
4version: 1.0.0
5license: Apache-2.0
6tags: [cml, admin, users, groups, system, licensing]
7metadata:
8 source: https://skillmd.com/skills/automateyournetwork/cml-admin
9---
10
11# CML Administration
12
13## MCP Server
14
15- **Command**: `cml-mcp` (pip-installed, stdio transport)
16- **Requires**: `CML_URL`, `CML_USERNAME`, `CML_PASSWORD` environment variables
17
18## Available Tools
19
20### User Management
21
22| Tool | Parameters | What It Does |
23|------|-----------|-------------|
24| `get_users` | none | List all CML users |
25| `create_user` | `username`, `password`, `fullname?`, `email?`, `admin?` | Create a new CML user |
26| `get_user` | `user_id`/`username` | Get user details (labs, resource usage) |
27| `update_user` | `user_id`/`username`, fields to update | Update user properties |
28| `delete_user` | `user_id`/`username` | Delete a CML user |
29
30### Group Management
31
32| Tool | Parameters | What It Does |
33|------|-----------|-------------|
34| `get_groups` | none | List all CML groups |
35| `create_group` | `name`, `description?`, `members?` | Create a new group |
36| `update_group` | `group_id`/`name`, fields to update | Update group properties |
37| `delete_group` | `group_id`/`name` | Delete a group |
38
39### System Information
40
41| Tool | Parameters | What It Does |
42|------|-----------|-------------|
43| `get_system_info` | none | CML version, uptime, resource usage (CPU, RAM, disk) |
44| `get_node_defs` | none | List all available node definitions and their resource requirements |
45| `get_licensing` | none | License status, node count, expiration |
46| `get_resource_usage` | none | Current resource utilization across all labs |
47
48## Workflow: Onboard a New Lab User
49
50When an admin wants to add a new team member:
51
521. **Check existing users**: `get_users` to see current user list
532. **Create the user**: `create_user` with their credentials
543. **Add to group** (optional): `update_group` to add user to a team group
554. **Verify**: `get_user` to confirm creation
565. **Share credentials**: Report the username and CML URL to the admin (never share the password in Slack)
57
58## Workflow: Resource Capacity Check
59
60Before building a large lab:
61
621. **Check system resources**: `get_system_info` for CPU, RAM, disk
632. **Check licensing**: `get_licensing` for available node count
643. **Check node definitions**: `get_node_defs` for per-node resource requirements
654. **Calculate**: Does the planned lab fit within available resources?
665. **Report**: "You have X GB RAM free, Y CPU cores available, Z node licenses remaining. Your planned lab needs A GB RAM and B nodes."
67
68## Workflow: System Health Report
69
70For CML server health monitoring:
71
721. **System info**: `get_system_info` — version, uptime, resource usage
732. **Licensing**: `get_licensing` — license status and node count
743. **Resource usage**: `get_resource_usage` — breakdown by lab/user
754. **Active labs**: `get_labs` (from cml-lab-lifecycle) — list running labs
765. **Generate report**: Summary of CML platform health
77
78## Resource Planning Guide
79
80Typical per-node resource requirements:
81
82| Node Type | vCPUs | RAM | Disk |
83|-----------|-------|-----|------|
84| IOSv | 1 | 512 MB | 2 GB |
85| IOSv L2 | 1 | 768 MB | 2 GB |
86| CSR1000v / Cat8000v | 1 | 3 GB | 8 GB |
87| NX-OS 9000v | 2 | 6 GB | 8 GB |
88| IOS-XR 9000v | 2 | 8 GB | 16 GB |
89| ASAv | 1 | 2 GB | 8 GB |
90| Ubuntu Server | 1 | 512 MB | 8 GB |
91| Unmanaged Switch | 0 | 0 | 0 |
92| External Connector | 0 | 0 | 0 |
93
94**Rule of thumb**: Plan for the CML host to have at least 2x the total RAM needed by all concurrent labs, plus 8 GB for the CML OS itself.
95
96## User Roles
97
98| Role | Capabilities |
99|------|-------------|
100| **Admin** | Full access: create/delete users, manage all labs, system settings |
101| **User** | Create/manage own labs, view shared labs |
102
103## Workflow: Audit CML Usage
104
105For tracking who's using what:
106
1071. **List all users**: `get_users`
1082. **For each user**: `get_user` to see their labs and resource usage
1093. **List all labs**: `get_labs` with ownership info
1104. **Check resource usage**: `get_resource_usage` for allocation breakdown
1115. **Report**: Table of users, their labs, running state, and resource consumption
1126. **Identify stale labs**: Labs that have been stopped for days — candidates for cleanup
113
114## Important Rules
115
116- **Admin operations require admin credentials** — user management needs admin-level CML access
117- **Never share passwords in Slack** — report usernames only, instruct admin to share credentials securely
118- **Check resources before big labs** — don't let users build labs that exceed server capacity
119- **Monitor licensing** — CML has node count limits; stay within license boundaries
120- **Record in GAIT** — log all admin operations for audit trail
121
122## Environment Variables
123
124- `CML_URL` — CML server URL
125- `CML_USERNAME` — CML username (admin for full access)
126- `CML_PASSWORD` — CML password
127- `CML_VERIFY_SSL` — Verify SSL certificate (true/false)