Nutanix MCP Server
This server provides AI assistants with tools to manage and monitor Nutanix infrastructure via Prism Central and Prism Element APIs. Key capabilities include:
VM Management: List, get, create, update, delete, clone, power on/off VMs, and manage snapshots (create, list, restore)
Cluster & Host Operations: List/get clusters, hypervisor hosts with hardware specs, and storage containers
Networking & Images: List/get subnets/VLANs (with CIDR, VLAN IDs, IP pool/DHCP details) and disk images (ISOs, QCOW2)
Category & Resource Tagging: List category keys/values, assign/remove categories to VMs, and find resources by category
Alerts & Tasks: List, get, and acknowledge alerts; list and get async tasks from Prism Central
Prism Element (Direct Cluster Access): Cluster info, hosts, CVMs, disks, NICs, health checks, alerts, storage containers, pools, volume groups, and per-cluster VM/network/image listings
Data Protection: Manage protection domains, list snapshots, view remote sites, check replication status, and identify unprotected VMs
System Configuration (PE): Retrieve auth, SMTP, SNMP, syslog, alert email, NFS whitelists, licensing, and Metro Availability witness settings
AsBuilt Reports: Generate comprehensive HTML/Markdown reports (with interactive TOC, topology diagrams, and PDF support) for the entire environment, specific clusters, or individual VMs
URI-based Browsing: Browse entities (VMs, clusters, hosts, subnets, images) via
nutanix://URIsInteractive Prompts: Guided credential setup and high-level environment overview
Generates Excalidraw JSON diagrams for visual topology representation of Nutanix environments as part of as-built reports.
Allows managing Nutanix Prism Central and Prism Element resources including VMs, clusters, hosts, storage, networking, images, categories, alerts, protection domains, and generating as-built reports.
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Nutanix MCP Serverlist all VMs in cluster Production"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Nutanix MCP Server
Use at your own risk. MCP servers grant AI models the ability to execute actions against your infrastructure. AI-driven management of production environments carries inherent risk — models can misinterpret intent, hallucinate parameters, or trigger destructive operations. This software is provided "as is" without warranty of any kind. The authors accept no liability for data loss, downtime, or any damages arising from use of this tool. Always review AI-proposed actions before execution and maintain proper backups.
An MCP (Model Context Protocol) server that exposes Nutanix Prism Central and Prism Element APIs as tools for AI assistants like GitHub Copilot, Claude, and others.
Features
65 tools — Full coverage of Prism Central v4 and Prism Element v2 APIs
Prism Central (v4 API) — VM lifecycle, snapshots, clusters, hosts, networking, categories, alerts, tasks
Prism Element (v2 API) — Direct cluster access for storage, disks, data protection, system config, health checks
AsBuilt Reports — Generate comprehensive HTML reports with interactive TOC, Mermaid topology diagrams, and print-to-PDF support
API version routing — Prefers v4, falls back to v3/v2 when needed
Async — Non-blocking HTTP client using httpx
Available Tools (65)
VM Management — Prism Central v4
Tool | Description |
| List all VMs with OData filtering (auto-paginates) |
| Get full VM config — CPU, memory, disks, NICs |
| Power on a VM |
| Power off a VM (ACPI guest shutdown or force) |
| Create a new VM with name, cluster, CPU, memory, disk |
| Update VM config — CPU, memory, name, description |
| Permanently delete a VM (requires confirmation) |
| Clone a VM with a new name |
VM Snapshots — Prism Central v4
Tool | Description |
| Create an on-demand recovery point of a VM |
| List all recovery points for a VM |
| Restore a VM to a previous recovery point |
Cluster & Host Management — Prism Central v4
Tool | Description |
| List all registered Nutanix clusters |
| Get cluster config, network, storage, and health details |
| List all hypervisor hosts across clusters |
| Get host hardware specs, hypervisor info, and resource usage |
| List storage containers across clusters |
Networking & Images — Prism Central v4
Tool | Description |
| List subnets/VLANs with CIDR, VLAN ID, and cluster |
| Get subnet details including IP pools and DHCP config |
| List disk images (ISOs, QCOW2) in the image library |
| Get image details — size, type, source, cluster placement |
| List all category keys and values |
| Get all values for a specific category key |
Categories & Tagging — Prism Central v4
Tool | Description |
| Tag a VM with a category key:value pair |
| Remove a category assignment from a VM |
| Find all VMs tagged with a specific category |
Alerts & Tasks — Prism Central v4
Tool | Description |
| List all alerts from Prism Central |
| Get full alert details — entities, resolution guidance |
| Acknowledge or resolve an alert |
| List recent async tasks with status |
| Get task completion status and error details |
Prism Element — Cluster & Hosts (v2 direct access)
Tool | Description |
| Cluster AOS version, capacity, and health |
| Hosts with hardware specs and CVM info |
| Per-host physical disk inventory (model, serial, firmware, tier) |
| Per-host NIC details — speed, link state, MAC, LLDP |
| Controller VMs — IP, memory, power state |
| Data resiliency and fault tolerance status |
| NCC-style health check results |
| Active/resolved alerts on a PE cluster |
Prism Element — Storage
Tool | Description |
| Storage containers with replication factor and policies |
| Storage pools and disk composition |
| Physical disk inventory — type, status, capacity |
| Volume groups — iSCSI IQN, attached VMs, CHAP |
| Detailed volume group config |
Prism Element — VMs, Networks & Images
Tool | Description |
| VMs on a specific cluster |
| VLANs — managed/unmanaged, IP pool config |
| Disk images and ISOs on a cluster |
Prism Element — Data Protection
Tool | Description |
| Protection domains — schedules, replication state |
| Detailed PD config — consistency groups, VMs, schedules |
| Snapshots for a protection domain |
| DR partner clusters — addresses, capabilities |
| Active replication progress, lag, and bandwidth |
| DR snapshots across remote sites |
| All active PD replications cluster-wide |
| VMs not in any protection domain (compliance gaps) |
Prism Element — System Configuration
Tool | Description |
| Auth types, directory services (LDAP/AD) |
| SMTP relay server configuration |
| SNMP traps, users, and community strings |
| Remote syslog targets and severity levels |
| Alert email recipients and notification rules |
| Global NFS export ACLs |
| License type (Starter/Pro/Ultimate) and features |
| Metro Availability witness server config |
AsBuilt Reports
Tool | Description |
| Generate a comprehensive infrastructure report from a PE cluster — overview, system config, hosts, storage, VMs, networks, data protection, alerts, health checks, and Mermaid topology diagram |
| Convert AsBuilt Markdown to self-contained HTML with interactive TOC sidebar and print-optimized CSS for PDF export |
| Get the Nutanix MCP Server project architecture documentation |
AsBuilt reports include 9 sections: overview, system, hosts (with per-host disk inventory), VMs, networks, storage, data protection (with remote sites and unprotected VM detection), alerts, and health checks. Hypervisor names are mapped automatically (kKvm → AHV). The HTML export features an interactive table of contents with scroll-spy that is hidden when printing to PDF.
MCP Resources (URI-based browsing)
The server exposes resources via nutanix:// URIs, allowing LLMs to browse
entities without explicit tool calls:
URI Pattern | Description |
| Browse all VMs |
| Get a specific VM |
| Browse all clusters |
| Get a specific cluster |
| Get a specific host |
| Get a specific subnet |
| Get a specific image |
MCP Prompts
Prompt | Description |
| Interactive credential configuration (for clients without env var support) |
| Guided environment overview — clusters, hosts, storage, alerts |
Setup
Prerequisites
Python 3.10+
Network access to your Prism Central instance (port 9440)
Nutanix credentials with API access
Install
cd mcp/nutanix-mcp-server
pip install -e .Or with dev dependencies:
pip install -e ".[dev]"Configure
Copy .env.example to .env and fill in your credentials:
cp .env.example .envNUTANIX_HOST=your-prism-central.example.com
NUTANIX_PORT=9440
NUTANIX_USERNAME=your-username
NUTANIX_PASSWORD=your-password
NUTANIX_VERIFY_SSL=true
NUTANIX_TIMEOUT=30Run
nutanix-mcpOr directly:
python -m nutanix_mcpMCP Client Configuration
This server uses stdio transport — it communicates via stdin/stdout. Each client configures a command to launch the server process.
Tip: Store credentials in environment variables or a
.envfile, never in config files committed to source control.
Claude Code (CLI)
Add the server to your project with the claude mcp add command:
claude mcp add nutanix -- python -m nutanix_mcpOr manually create/edit .mcp.json in your project root:
{
"mcpServers": {
"nutanix": {
"type": "stdio",
"command": "python",
"args": ["-m", "nutanix_mcp"],
"cwd": "/path/to/mcp/nutanix-mcp-server",
"env": {
"NUTANIX_HOST": "your-prism-central.example.com",
"NUTANIX_USERNAME": "your-username",
"NUTANIX_PASSWORD": "your-password",
"NUTANIX_VERIFY_SSL": "true"
}
}
}
}For user-wide availability (all projects), add to ~/.claude.json instead.
Claude Desktop
Edit the config file at:
macOS:
~/Library/Application Support/Claude/claude_desktop_config.jsonWindows:
%APPDATA%\Claude\claude_desktop_config.jsonLinux:
~/.config/Claude/claude_desktop_config.json
{
"mcpServers": {
"nutanix": {
"type": "stdio",
"command": "python",
"args": ["-m", "nutanix_mcp"],
"cwd": "/path/to/mcp/nutanix-mcp-server",
"env": {
"NUTANIX_HOST": "your-prism-central.example.com",
"NUTANIX_USERNAME": "your-username",
"NUTANIX_PASSWORD": "your-password",
"NUTANIX_VERIFY_SSL": "true"
}
}
}
}Restart Claude Desktop fully after editing.
GitHub Copilot (VS Code)
Add to .vscode/mcp.json in your workspace:
{
"servers": {
"nutanix": {
"type": "stdio",
"command": "python",
"args": ["-m", "nutanix_mcp"],
"cwd": "${workspaceFolder}/mcp/nutanix-mcp-server",
"env": {
"NUTANIX_HOST": "your-prism-central.example.com",
"NUTANIX_USERNAME": "your-username",
"NUTANIX_PASSWORD": "your-password",
"NUTANIX_VERIFY_SSL": "true"
}
}
}
}OpenCode (sst/opencode)
Add to opencode.json (or opencode.jsonc) in your project root:
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"nutanix": {
"type": "local",
"command": ["python", "-m", "nutanix_mcp"],
"environment": {
"NUTANIX_HOST": "your-prism-central.example.com",
"NUTANIX_USERNAME": "your-username",
"NUTANIX_PASSWORD": "your-password",
"NUTANIX_VERIFY_SSL": "true"
},
"enabled": true
}
}
}Note: OpenCode uses "command" as an array and "environment" instead of "env".
Docker MCP Gateway
The Docker MCP Gateway can proxy this server inside a container. Two approaches:
Option A: Run directly via Docker
Build a container image and reference it in your MCP client config:
FROM python:3.12-slim
WORKDIR /app
COPY mcp/nutanix-mcp-server/ .
RUN pip install --no-cache-dir -e .
CMD ["python", "-m", "nutanix_mcp"]Then in any MCP client config:
{
"mcpServers": {
"nutanix": {
"type": "stdio",
"command": "docker",
"args": [
"run", "-i", "--rm",
"-e", "NUTANIX_HOST=your-prism-central.example.com",
"-e", "NUTANIX_USERNAME=your-username",
"-e", "NUTANIX_PASSWORD=your-password",
"-e", "NUTANIX_VERIFY_SSL=true",
"nutanix-mcp-server"
]
}
}
}Option B: Register with Docker MCP Gateway
If you have Docker Desktop with the MCP Toolkit:
docker mcp gateway runConfigure the gateway profile to include the nutanix server. The gateway then exposes all registered MCP servers as a single unified endpoint.
In your AI client, point to the gateway:
{
"mcpServers": {
"MCP_DOCKER": {
"command": "docker",
"args": ["mcp", "gateway", "run"]
}
}
}The gateway handles routing, lifecycle management, and credential isolation.
API Version Strategy
Version | Endpoint Pattern | Use Case |
v4 (preferred) |
| VMs, clusters, hosts, networking |
v3 (fallback) |
| Resources not yet in v4 |
v2 (PE direct) |
| Per-cluster storage, disks, alerts |
Discovering Prism Element Hosts
Use list_clusters to find cluster UUIDs, then list_hosts to find CVM IPs.
Those CVM IPs can be used as pe_host in the Prism Element tools.
Development
# Lint
ruff check src/
# Type check
mypy src/
# Test
pytestReferences
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Latest Blog Posts
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/jkmills/nutanix-mcp-server'
If you have feedback or need assistance with the MCP directory API, please join our Discord server