Skip to main content
Glama
MCP-OpenStack-Ops

MCP-OpenStack-Ops

by call518

English | Korean

MCP-OpenStack-Ops

MCP OpenStack Operations Server: A comprehensive MCP (Model Context Protocol) server providing OpenStack project management and monitoring capabilities with built-in safety controls and single-project scope.

MCPVault: claimed

License: MIT Python Docker Pulls BuyMeACoffee

Deploy to PyPI with tag PyPI PyPI - Downloads


What is MCP-OpenStack-Ops?

MCP-OpenStack-Ops lets an AI assistant such as Claude or a model in OpenWebUI inspect and operate an OpenStack project in plain language. It is an MCP server that turns requests like "which instances are stopped?" into OpenStack API calls and returns the results.

  • Read-only by default: tools that create, change or delete resources are not even registered unless you enable them.

  • One project at a time: each server works inside one OpenStack project and checks resource ownership.

  • Broad coverage: 121 tools (61 read-only, 60 management) for Nova, Neutron, Cinder, Glance, Keystone, Heat, Octavia, Barbican, and Gnocchi/Aodh telemetry.

For an AI-generated walkthrough of the code, see Ask DeepWiki.

Related MCP server: mcpdeployment

What can you do with it?

Showcase: a Heat autoscaling stack created from natural language alone

Web servers scaling out and in on CPU load

No Heat template was written by hand: the stack was created from this two-line natural-language request.

Use the test-rockylinux-9 VM (web server) as the source for a new base image. Create and bring up a Heat stack with a TLS-terminating load balancer and autoscaling web servers.
- Run 2 web servers under normal conditions, with a maximum of 4. Scale out by 1 when average CPU utilization stays above 60% for 5 minutes, and scale in by 1 when it stays below 40% for 5 minutes, down to a minimum of 2. Use a 900-second cooldown and set the stack's timeout_mins to 60.

Using this server's tools, the MCP client snapshotted a web server VM into a base image, generated a self-signed certificate and stored it in Barbican, and created a Heat stack with an Octavia load balancer that terminates HTTPS and an autoscaling group driven by Aodh CPU alarms. Under CPU load the group grew from two to four web servers and shrank back to two when the load ended. The request, templates and a walkthrough of the chart are in the Heat autoscaling tutorial.

Then ask how it is doing, in one line

Per-member CPU queried in natural language

A one-line request for the members' CPU over the last hour, at 1-minute intervals, returned per-member data from Gnocchi through this server's tools; the client drew the chart, summary and CSV. It shows the group mean above 60% for five minutes and the third member added right after. (The session was in Korean; the screenshot shows it translated into English.)

Ask questions and give instructions in natural language, for example:

Show me the overall cluster status
Find instances in SHUTOFF state
Show all networks and their subnets
List all volumes and their status
Show the vCPUs and memory allocated to my project and the remaining quota
Show CPU usage of web-01 over the last hour
Stop all instances with name containing 'test'

The last request changes resources, so it works only after you enable modification tools. Telemetry requests need Ceilometer and Gnocchi in the cloud.

More requests to try: Example queries by area lists copy-ready requests, with the tools each one uses, for cluster status, instances, networks, storage, images, identity, Heat, load balancers, Barbican secrets and TLS listeners, allocation and quotas, Gnocchi telemetry, Aodh alarms, troubleshooting, security, batch actions, and multi-tool reports.

Example: cluster status in Claude Desktop

Example Cluster Status

The same project in the OpenStack Dashboard (Epoxy 2025.1)

OpenStack Dashboard (Epoxy 2025.1)

Quick Start

You need an OpenStack account (Keystone host, project, user name, password) whose APIs are reachable from the computer that runs the server. Pick one of the two paths below; both start read-only.

Option A: Claude Desktop with the extension bundle (fastest)

  1. Download mcp-openstack-ops-<version>.mcpb from the latest GitHub Release.

  2. In Claude Desktop, open Settings > Extensions > Advanced settings > Install Extension… and select the file.

  3. Fill in the settings form: Keystone host, project, user name and password are required; ports, domains and region are prefilled. Leave Allow modify operations off.

  4. Ask Claude: List the instances in my OpenStack project.

Other Claude Desktop setups (uvx, a source checkout, the Docker server through mcp-remote, a remote connector) are in the Claude Desktop guide.

Option B: OpenWebUI with Docker Compose

Requirements: Git, Docker with the Compose plugin, and a model provider for OpenWebUI whose model supports tool calling.

1. Configure

git clone https://github.com/call518/MCP-OpenStack-Ops.git
cd MCP-OpenStack-Ops
cp .env.example .env
cp mcp-config.json.http mcp-config.json.http.local
chmod 600 mcp-config.json.http.local
openssl rand -hex 32   # use the output as WEBUI_SECRET_KEY
vi .env                # set WEBUI_SECRET_KEY and the OS_* values for your cloud

2. Start

docker compose up -d
docker compose ps      # wait until mcp-server is healthy

This starts OpenWebUI (http://localhost:3000), the MCP server (http://localhost:8000/mcp) and MCPO (http://localhost:8080).

3. Connect a model provider

These steps apply to both the direct MCP connection and MCPO.

  1. Open http://localhost:3000 and create the administrator account.

  2. Under Settings β†’ Admin β†’ Connections, add an OpenAI connection with URL https://api.openai.com/v1, Auth Bearer with your OpenAI API key, and API Type set to Chat Completions, then save it. For another provider, see the OpenWebUI guide.

  3. The Quick Start calls tools through Chat Completions with model reasoning turned off, using this default already present in .env.example:

    DEFAULT_MODEL_PARAMS={"reasoning_effort":"none"}

    This value requires API Type: Chat Completions. With Responses, OpenWebUI 0.13.0 still sends reasoning_effort, and every request fails with Unsupported parameter: 'reasoning_effort'. If the open-webui-data volume already exists, set the same value under Settings β†’ Admin β†’ Models β†’ Model Defaults β†’ Model Parameters because its saved database value takes precedence. To keep model reasoning through Responses instead, see the OpenWebUI guide.

4. Connect the MCP server

  1. Under Settings β†’ Admin β†’ Tools β†’ Integrations β†’ External Tool Servers, add a connection of type MCP (Streamable HTTP) with URL http://mcp-server:8000/mcp and authentication None.

  2. Under Settings β†’ Admin β†’ System β†’ Interface β†’ Chat, turn on Tool Search and Defer Built-in Tools, and set Deferral Threshold to 0 so that the full tool list fits the model's limits.

  3. In a new chat, enable the connection under Integrations β†’ Tools and ask: Use mcp-openstack-ops to list the instances in my OpenStack project.

MCPO is optional. MCPO is a proxy that exposes the MCP tools as an OpenAPI (REST) server; OpenWebUI does not need it to use this server. The Compose file starts it so that you can choose either connection. To run without it, start only docker compose up -d mcp-server open-webui.

The OpenWebUI guide explains the direct and MCPO connections, every OpenWebUI setting, OpenAI reasoning models, and troubleshooting.

Other ways to install

Setup

Guide

Claude Desktop with uvx, a source checkout, mcp-remote, or a remote connector

Claude Desktop guide

Claude Code

Claude Code guide

OpenWebUI through MCPO (OpenAPI)

OpenWebUI guide

Each user signs in with their own OpenStack Application Credential (experimental)

Multi-user guide

Several projects, HTTPS and private CAs, custom endpoints and ports

Configuration guide

To let the assistant create, change or delete resources, set ALLOW_MODIFY_OPERATIONS=true (or turn on Allow modify operations in the Claude Desktop form) and restart the server. OpenStack policy still decides what the account may do.

Features

  • βœ… Project-Scoped Operations: Every tool enforces the configured OS_PROJECT_NAME, validating resource ownership so actions stay inside a single tenant.

  • βœ… Safety-Gated Writes: Modify (set_*) tooling only registers when ALLOW_MODIFY_OPERATIONS=true, keeping default deployments read-only and auditable.

  • βœ… Broad Tool Coverage: 121 tools across compute, networking, storage, images, identity, Heat, Octavia load balancing, Barbican secrets and telemetry. Project resources are scoped to the active project; cloud-wide administrative APIs remain subject to OpenStack policy.

  • βœ… Bulk & Filtered Actions: Instance, volume, network, image, snapshot, and keypair managers accept comma-delimited targets or filter criteria to orchestrate bulk changes intentionally.

  • βœ… Post-Action Feedback & Async Guidance: Management tools report per-resource results, the status read back after the action, and timing notes for asynchronous operations.

  • βœ… Monitoring & Usage Insights: get_service_status, get_resource_monitoring, get_usage_statistics, and quota tools report service probes, project allocations, separate quota limits, and API-backed compute allocation-hours. These tools do not collect live utilization or trends; read-only get_gnocchi_* tools return telemetry time series when Ceilometer and Gnocchi are deployed.

  • βœ… Unified Instance Queries: The get_instance tool consolidates name, ID, status, and free-form search paths with pagination plus summary/detailed modes.

  • βœ… Server Insight & Audit Trail: Dedicated tools expose server events, hypervisor details, availability zones, quotas, and resource ownership to speed diagnostics.

  • βœ… Load Balancer Management: Octavia tools cover listeners, pools, members, health monitors, flavors, quotas, and amphora operations with the same safety gates. TERMINATED_HTTPS listeners take certificates stored in Barbican, and pools support non-terminated HTTPS (TLS passthrough) and backend re-encryption, including client authentication (mTLS).

  • βœ… Barbican Secrets Without Payloads: Barbican tools manage secret metadata, containers, key-generation orders, ACLs and self-signed TLS certificates. Secret payloads are never accepted or returned, so key material cannot reach the LLM; register your own certificates outside MCP (Barbican and TLS guide).

  • βœ… Connection & Deployment Flexibility: Connection caching, configurable service endpoints, Docker packaging, a Claude Desktop extension, and both stdio/streamable-http transports support proxy/bastion and multi-project setups.

  • 🧭 Advanced: Cross-Project Reads: Administrators can ask about every project at once ("List VMs per project"), and operators can give read-only, cloud-wide views to non-admin teams through OpenStack policy. Off by default; see the cross-project reads guide.

Safety and security

  • Read-only by default. Management tools are registered only with ALLOW_MODIFY_OPERATIONS=true.

  • One project per server. Resources are filtered by the current project and checked for ownership; run one server per project to manage several. Reading across projects is an advanced, opt-in feature; see the cross-project reads guide.

  • Protect HTTP access. Over streamable-http, enable Bearer token authentication (REMOTE_AUTH_ENABLE=true) and HTTPS before exposing the server beyond localhost.

Details: security guide and multi-user guide.

Authentication support by client

Each server authenticates to OpenStack with either one account's password (the default) or per-user Application Credentials (multi-user mode, streamable-http only). Support differs by client; for example, the Claude Desktop extension bundle supports only the password, while Claude Desktop with mcp-remote in claude_desktop_config.json supports both. See Authentication support by client.

Compatibility

⚠️ Compatibility Notice: This MCP server is developed and optimized for OpenStack Epoxy (2025.1) as the primary target environment. However, it is compatible with most modern OpenStack releases (Dalmatian, Caracal, Bobcat, etc.) as the majority of APIs remain consistent across versions. Only a few specific API endpoints may require adaptation for full compatibility with older releases.

🚧 Coming Soon: Dynamic multi-version OpenStack API compatibility is actively under development and will be available in upcoming releases, providing seamless support for all major OpenStack deployments automatically.

Officially Supported Releases:

  • βœ… OpenStack Epoxy (2025.1) - Fully tested

  • βœ… OpenStack Dalmatian (2024.2) - Fully tested

OpenStackSDK Version Reference:

OpenStack Release

Recommended SDK Version

Notes

Epoxy (2025.1)

>=4.1.0,<=4.22.0

Current default range; uv.lock pins 4.22.0. Unit tests pass with 4.1.0, 4.9.0 and 4.22.0

Dalmatian (2024.2)

>=3.2.0

Fully compatible

Caracal (2024.1)

>=3.1.0

May require testing

Bobcat (2023.2)

>=3.0.0

May require testing

Wallaby (2021.1)

==3.1.1

Downgrade required

To change the SDK version for an older release, see OpenStack SDK version for older releases.

Documentation

Guide

Contents

Usage guide

Example queries by area, bulk and filtered actions, post-action status, pagination

OpenWebUI guide

Docker Compose stack, direct MCP versus MCPO, OpenWebUI settings, troubleshooting

Claude Desktop guide

Extension bundle, uvx, source checkout, mcp-remote, remote connector

Claude Code guide

Registering the HTTP server in Claude Code

Configuration guide

Command-line options, environment variables, access modes and .env settings, endpoints, HTTPS, multiple projects, SDK version

Security guide

Authentication support by client, project isolation, read-only default, Bearer authentication

Multi-user guide

Per-user Application Credential authentication (experimental)

Cross-project reads guide

Advanced, opt-in: reading across projects, setups, required OpenStack policy

Barbican and TLS guide

Barbican prerequisites, why secret payloads are excluded, self-signed certificates, TERMINATED_HTTPS listeners, non-terminated HTTPS (TLS passthrough) and backend re-encryption, step-by-step client authentication (mTLS)

Heat autoscaling tutorial

Heat stack with a TERMINATED_HTTPS load balancer and Aodh-driven autoscaling web servers: request, templates, verification, scaling walkthrough

Development guide

Tests, live tool checks, adding tools, contributing

TODO

Outstanding implementation and live-validation work

OpenStack CLI vs MCP tools mapping

Every tool, its CLI equivalent, and its validation status

Validation evidence

Dates, revisions, conditions and counts of the live and unit-test checks


πŸ“Š OpenStack CLI vs MCP Tools Mapping

βœ… denotes an implemented API path, not certification of every action or OpenStack deployment. ⚠️ Live unverified identifies paths without successful live validation; ❌ Not implemented identifies unavailable capabilities. Service availability, permissions, and asynchronous completion affect results. See API prerequisites and result semantics and the multi-user setup guide.

Validation evidence: the live checks, Claude Code prompt checks and unit-test results behind the Status values below are recorded in docs/validation.md.

Detailed Mapping by Category

1. πŸ–₯️ Compute (Nova)

OpenStack CLI Command

MCP Tool

Status

Notes

openstack server list

get_instance

βœ…

Separate reader projects each returned exactly ten owned VMs; bounded lab validation only. One call returns at most LIST_MAX_LIMIT items (default 100, previously a fixed 200; 2026-11-17, unit-tested only)

openstack server show

get_instance

βœ…

Own fixture queries completed; foreign private ID returned no details; no 16-owned-ID batch claim. Each instance reports boot_source (image or volume); summary mode shows a volume-backed instance's image as unknown, and detailed=true resolves it from the boot volume. 2026-11-10 OpenStack 2026.1 check (3.7.6): volume for volume-backed servers in summary and detailed modes, image otherwise; detailed mode resolved the image name from the boot volume

openstack server create

set_instance (action="create")

βœ…

ENHANCED - Bulk creation support. Boots the image on the flavor's local disk unless a volume option below is given. 2026-11-10 targeted check: a server reached ACTIVE

openstack server create --boot-from-volume <size>

set_instance (action="create", boot_from_volume, volume_size)

βœ…

Root disk on a new Cinder volume created from the image; optional volume_type and delete_on_termination; bulk creation supported. 2026-11-10 targeted check: three servers created in one call reached ACTIVE, each on a bootable 10 GB volume at /dev/vda. 2026-11-10 OpenStack 2026.1 check (3.7.6): 1 GB root volumes with volume_type; the root volume was deleted with the server, and kept with delete_on_termination=false

openstack server create --volume

set_instance (action="create", boot_volume)

βœ…

Boots one server from an existing available, bootable volume, without an image. 2026-11-10 OpenStack 2026.1 check (3.7.6): the server reached ACTIVE on that volume; an in-use, non-bootable or missing volume, and two server names, were refused without creating a server

openstack server start/stop/reboot

set_instance

βœ…

Tool schema exposes all actions and reboot_type; bulk stop/start final states verified for two test VMs per project, but reboot was not retested in this round

openstack server delete

set_instance (action="delete")

βœ…

Tool schema exposes delete and optional force deletion; bulk deletion with name_contains filtering. Every given filter must match (name_contains with status previously selected the union), and more matches than INSTANCE_FILTER_MAX_MATCHES (default 100) are refused without acting on any instance (2026-11-17, unit-tested only). force=true uses openstacksdk delete_server(force=True) (previously a non-existent SDK method); 2026-11-10 targeted check: forced deletion removed the server

openstack server backup create

set_server_backup

βœ…

Nova backup action with rotation; asynchronous, no custom metadata

openstack server image create

set_instance (action="snapshot")

βœ…

Accepts optional snapshot_name and JSON metadata; parameter forwarding is locally tested, not live-retested in this change

openstack server shelve/unshelve

set_instance

βœ…

Actions are exposed in the tool schema; instance shelving was not live-retested in this change

openstack server lock/unlock

set_instance

βœ…

Instance locking. get_instance_details reports locked from the SDK is_locked field (previously always false); 2026-11-10 targeted check: reported true after lock and false after unlock, matching Nova

openstack console url show

set_instance (action="console")

βœ…

Uses the Nova remote-consoles API (the legacy console actions return 404 on current Nova). console_type: novnc (default), spice-html5, rdp-html5, serial, webmks, spice-direct, subject to cloud support. 2026-11-10 targeted check: a noVNC URL was returned

openstack server pause/unpause

set_instance

βœ…

Instance pausing

openstack server suspend/resume

set_instance

βœ…

Instance suspension

openstack server resize

set_instance (action="resize")

βœ…

Uses the existing flavor parameter as the target flavor; action exposure is locally tested

openstack server resize confirm

set_instance (action="confirm_resize")

βœ…

Resize confirmation

openstack server resize revert

set_instance (action="revert_resize")

βœ…

Resize revert

openstack server rebuild

set_instance (action="rebuild")

βœ…

Uses image and supports optional new_name, JSON metadata, and preserve_ephemeral. The image is passed as openstacksdk expects (previously the rebuild failed), and metadata is sent only when given because Nova replaces server metadata on rebuild. 2026-11-10 targeted check: rebuilt to ACTIVE and existing metadata was kept

openstack server rescue/unrescue

set_instance

βœ…

Tool schema exposes both actions and optional rescue_image_id; not live-retested in this change

openstack server migrate

set_server_migration (action="migrate")

βœ…

Live migration

openstack server evacuate

set_server_migration (action="evacuate")

⚠️ Live unverified

Server evacuation. on_shared_storage is sent only when explicitly true; Nova rejects that field from compute microversion 2.14. 2026-11-10 targeted check: on a single host whose compute service was up, Nova refused the request for that reason, not for a schema error, and the server stayed ACTIVE; an actual evacuation needs a failed host and a second compute host

openstack server migration list

set_server_migration (action="list")

βœ…

Migration listing. With instance_name, lists that server's migrations (previously always empty); a listing failure is reported instead of an empty success, and the all-migrations listing reads the SDK server_id. 2026-11-10 targeted check: per-server listing returned and an unknown server returned an error

openstack server migration show

set_server_migration (action="show")

βœ…

Migration details

openstack server migration abort

set_server_migration (action="abort")

βœ…

Migration abort

openstack server migration confirm

set_server_migration (action="confirm")

βœ…

Migration confirmation

openstack server migration force complete

set_server_migration (action="force_complete")

βœ…

Force migration completion

openstack server add network

set_server_network (action="add_network")

βœ…

Network attachment. Nova creates the interface port, so removing the network deletes it again. 2026-11-10 targeted check: attached

openstack server remove network

set_server_network (action="remove_network")

βœ…

Network detachment. 2026-11-10 targeted check: no interface port was left, and the network could be deleted afterwards

openstack server add port

set_server_network (action="add_port")

βœ…

Port attachment by port name or ID (a name was previously reported as not found). 2026-11-10 targeted check: attached by name

openstack server remove port

set_server_network (action="remove_port")

βœ…

Port detachment by name or ID; detaching does not delete a port you created. 2026-11-10 targeted check: detached by name and the port was kept

openstack server add floating ip

set_server_floating_ip (action="add")

βœ…

Floating IP association

openstack server remove floating ip

set_server_floating_ip (action="remove")

βœ…

Floating IP disassociation

openstack server add fixed ip

set_server_fixed_ip (action="add")

βœ…

Fixed IP addition through a new interface whose port Nova creates. 2026-11-10 targeted check: an address from the requested network was assigned

openstack server remove fixed ip

set_server_fixed_ip (action="remove")

βœ…

Detaches the whole interface that holds the address, which can be the primary interface. 2026-11-10 targeted check: removed and no interface port was left

openstack server add security group

set_server_security_group (action="add")

βœ…

Security group addition

openstack server remove security group

set_server_security_group (action="remove")

βœ…

Security group removal

openstack server add volume

set_server_volume (action="attach")

βœ…

Member attach reached in-use via set_server_volume; guest I/O not tested. The multiattach precheck reads the SDK is_multiattach field. 2026-11-10 targeted check (administrator): reached in-use

openstack server remove volume

set_server_volume (action="detach")

βœ…

Member detach reached available via set_server_volume. 2026-11-10 targeted check (administrator): reached available

openstack server set

set_server_properties (action="set")

βœ…

Server property setting

openstack server unset

set_server_properties (action="unset")

βœ…

Server property unsetting

openstack server dump create

set_server_dump

❌ Not implemented

Nova's trigger-crash-dump action (microversion 2.17, openstacksdk trigger_server_crash_dump) is not exposed. The tool returns an explicit unsupported result; no dump is created

openstack server event list

get_server_events

βœ…

Pass the server name or UUID via instance_name, not server_id. The action list has no completion time; set include_event_details=true to fetch per-action event results and derive the latest finish time. Detailed lookup is capped at 10 actions. Event visibility follows Nova policy

openstack server group list

get_server_groups

βœ…

Server group listing. Reads member_ids and, from compute microversion 2.64, policy instead of policies; a listing failure is reported instead of an empty list. 2026-11-10 targeted check: listed with its policy

openstack server group create/delete

set_server_group

βœ…

Server group management. 2026-11-10 targeted check: create and show reported the policy and members, then the group was deleted

openstack flavor list

set_flavor (action="list")

βœ…

Requires modification tools to be enabled for registration

openstack flavor create/delete

set_flavor

βœ…

Flavor management

openstack keypair list

get_keypair_list

βœ…

Empty scoped read completed; member keypair creation/deletion read-back tested separately

openstack keypair create/delete

set_keypair

βœ…

Explicit member MCP create/delete read-back passed; no successful Claude write workflow claimed

openstack hypervisor list

get_hypervisor_details

βœ…

Administrator lookup verified; missing per-host capacity and incomplete totals are null, not zero. Global enhanced statistics remain separate; when /os-hypervisors/statistics is unavailable (removed at compute microversion 2.88), enhanced_stats_note explains why. That note is unit-tested only; in the 2026-11-10 targeted check the statistics API still returned data

openstack availability zone list

get_availability_zones

βœ…

Compute/Cinder availability reads the SDK state mapping; missing availability is null. Actual available zones verified

2. 🌐 Network (Neutron)

OpenStack CLI Command

MCP Tool

Status

Notes

openstack network list

get_network_details

βœ…

Two owned private networks plus one policy-visible shared external network per reader; no other test project private networks

openstack network show

get_network_details (network_name)

βœ…

Foreign-ID negative checked. A name that matches nothing returns an explicit error (previously an empty success). 2026-11-10 targeted check (administrator): named lookup returned the network and a missing name returned the error; a dual-project positive lookup by reader roles is still not asserted

openstack network create

set_networks (action="create")

βœ…

Default mtu=0 omits the wire field: backend MTU 1450 verified; explicit 1400 retained in both member projects

openstack network delete

set_networks (action="delete")

βœ…

Both default/explicit-MTU test networks removed through actual TCP MCP, API absence confirmed

openstack network set

set_networks (action="update")

βœ…

ENHANCED - Bulk updates

openstack subnet list

get_network_details (includes subnets)

βœ…

Owned and shared external network subnets returned; three visible subnets per test reader

openstack subnet create/delete

set_subnets

⚠️ Live unverified

Create omits an unset gateway_ip, so Neutron assigns the first address of the CIDR (previously it sent null, which creates a subnet without a gateway), and forwards description (previously dropped). This 2026-11-17 change is unit-tested only. Earlier live check: member TCP MCP subnet create read back; deletion allowed parent network removal in both projects

openstack router list

get_routers

⚠️ Live unverified

Only part of composite error requests in this round; no independent reader result attribution

openstack router create/delete

set_routers

βœ…

Project-owned routers; attached interfaces are not removed automatically

openstack floating ip list

get_floating_ips

βœ…

Floating IP listing. A failed query returns an error instead of a placeholder address. 2026-11-10 targeted check: listed

openstack floating ip create

set_floating_ip (action="create")

βœ…

Floating IP creation. description, port_id and floating_ip_address are forwarded (previously dropped). 2026-11-10 targeted check: created with its description; port_id and floating_ip_address on create were not live-tested

openstack floating ip delete

set_floating_ip (action="delete")

βœ…

Floating IP deletion. 2026-11-10 targeted check: released

openstack floating ip set

set_floating_ip (action="set")

βœ…

Floating IP property setting

openstack floating ip show

set_floating_ip (action="show")

βœ…

Floating IP details. 2026-11-10 targeted check: shown by ID

openstack floating ip unset --port

set_floating_ip (action="disassociate"), set_server_floating_ip (action="remove")

βœ…

Detaches the port and keeps the floating IP. set_server_floating_ip (action="remove") is the same path as openstack server remove floating ip; disassociate has no separate dated live check

openstack floating ip unset --qos-policy / --tag / --all-tag

β€”

❌ Not implemented

No tool clears a floating IP's QoS policy or tags. set_floating_ip (action="unset") exposes no parameter that selects what to clear and always returns an error; use disassociate to detach the port

openstack floating ip pool list

get_floating_ip_pools

βœ…

Available global pool capacity remains unknown (available_ips=null). A failed query returns an error instead of a placeholder pool. 2026-11-10 targeted check: the external network pool was listed

openstack floating ip port forwarding create

set_floating_ip_port_forwarding (action="create")

⚠️ Live unverified

Implemented; test platform port-forwarding endpoint returns HTTP 404

openstack floating ip port forwarding delete

set_floating_ip_port_forwarding (action="delete")

⚠️ Live unverified

Implemented; test platform port-forwarding endpoint returns HTTP 404

openstack floating ip port forwarding list

set_floating_ip_port_forwarding (action="list")

⚠️ Live unverified

Implemented; test platform port-forwarding endpoint returns HTTP 404

openstack floating ip port forwarding set

set_floating_ip_port_forwarding (action="set")

⚠️ Live unverified

Implemented; test platform port-forwarding endpoint returns HTTP 404

openstack floating ip port forwarding show

set_floating_ip_port_forwarding (action="show")

⚠️ Live unverified

Implemented; test platform port-forwarding endpoint returns HTTP 404

openstack security group list

get_security_groups

βœ…

Scoped reader list completed; default and test groups visible. A failed query returns an error instead of a placeholder default group

openstack security group create/delete

set_security_groups

βœ…

Project-owned security groups

openstack security group rule create/delete

set_security_group_rules

⚠️ Live unverified

Implemented for project-owned groups. Create requires an explicit CIDR or project-owned remote group; delete verifies the rule belongs to the selected group. Not live-tested in this change

openstack port list

set_network_ports (action="list")

⚠️ Live unverified

Implemented list action requires modification-tool registration; not exercised in this round

openstack port create/delete

set_network_ports

⚠️ Live unverified

Create omits unset security_groups, so Neutron applies the project's default group (previously it sent an empty list, which creates a port without any security group), and forwards description (previously dropped). This 2026-11-17 change is unit-tested only

openstack network qos policy list

get_network_qos_policies

⚠️ Live unverified

Implemented; test platform QoS endpoint returns HTTP 404

openstack network qos policy create

set_network_qos_policies

⚠️ Live unverified

Implemented; test platform QoS endpoint returns HTTP 404. Policy containers only; no bandwidth rules

openstack network agent list

get_service_status (includes agents)

⚠️ Live unverified

Reader service-policy restrictions; partial data is not proof of global health. 2026-11-10 targeted check returned agents as administrator only

openstack network agent set

set_network_agents

⚠️ Live unverified

Enable/disable cloud-wide agents; usually admin-only. The live tool check called only action="list"; enable and disable were not exercised

3. πŸ’Ύ Storage (Cinder)

When the Block Storage service is not deployed, the Cinder volume, snapshot, type, backup, group, QoS, transfer and server-volume paths report an explicit "Block Storage (Cinder) service is not available" error with endpoint URLs redacted. This was checked live on OpenStack 2026.1 without Cinder with release 3.7.3 (see validation); the storage code is unchanged since.

OpenStack CLI Command

MCP Tool

Status

Notes

openstack volume list

get_volume_list

βœ…

Exactly ten owned volumes per reader; no other test project volume IDs returned. multiattach and source_volid read the SDK is_multiattach and source_volume_id fields. 2026-11-10 targeted check: listed with those fields

openstack volume show

get_volume_list

βœ…

Listing-based client filtering; no dedicated get_volume_list filter argument

openstack volume create/delete

set_volume

βœ…

Volume creation/deletion. 2026-11-10 targeted check: a 1 GB volume reached available and two volumes were deleted

openstack volume create --source, openstack volume migrate, openstack volume transfer request create

β€”

❌ Not implemented

set_volume rejects source_volume, transfer_name, host, force_host_copy, lock_volume, backup_name and incremental before any API call (previously ignored while the action ran). Use set_volume_backups for backups

openstack volume set --size

set_volume (action="extend")

βœ…

Positive new_size takes precedence over size; size remains a fallback. A test volume reached the requested size and available state; API acceptance alone is not completion

openstack volume set (other properties)

β€”

❌ Not implemented

set_volume has no modify/update action; do not send this unsupported action

openstack volume type list

get_volume_types

βœ…

Volume type listing. A failed query returns an error instead of a placeholder standard type. 2026-11-10 targeted check: listed

openstack volume type create/delete

set_volume_types

βœ…

Volume type management; usually admin-only

openstack volume snapshot list

get_volume_snapshots

βœ…

Two owned base snapshots per reader; API final states checked

openstack volume snapshot create/delete

set_snapshot

βœ…

Explicit member MCP snapshots reached available and were deleted. Post-action status resolves snapshots instead of reporting an unknown resource type; no restore/I/O claim. 2026-11-10 targeted check (administrator): reached available and was deleted

openstack backup list

get_volume_backups

βœ…

Three owned available backups per reader; base backup creation used real Cinder APIs

openstack backup create/delete

set_volume_backups

βœ…

Volume backup management. 2026-11-10 targeted check: a backup reached available and was deleted

openstack volume backup restore

set_volume_backups (action="restore")

βœ…

Restores to a new volume named by volume_name, or to volume_id. Works with both the volume_id= and the volume= (openstacksdk 4.14+) restore signatures. 2026-11-10 targeted check (openstacksdk 4.22.0): restored to a new volume that reached available; restoring into an existing volume was not tested

openstack volume transfer request list

get_volume_transfers

βœ…

Request listing only; authorization keys are excluded

openstack server volume list

get_server_volumes

βœ…

Server volume listing. A server that does not exist returns an explicit error (previously an empty success). 2026-11-10 targeted check: listed the attached volume; a missing server returned the error

openstack server add/remove volume

set_server_volume / set_volume (action="attach"/"detach")

βœ…

Both paths reached in-use then available in both member projects; foreign endpoints rejected; guest I/O not tested

openstack volume group list

get_volume_groups

βœ…

Requires Cinder generic groups (API >= 3.13)

openstack volume group create

set_volume_groups

βœ…

Create/list/show/delete; create requires group_type and volume_types

openstack volume qos list

get_volume_qos

βœ…

Cinder QoS specifications; subject to cloud policy

openstack volume qos show

get_volume_qos (qos_name)

⚠️ Live unverified

Shows one specification and its current volume type associations. Added 2026-11-17; unit tests only

openstack volume qos create

set_volume_qos

βœ…

Create/list/show/set/delete specifications. Creation does not automatically associate a volume type; use the explicit associate action

openstack volume qos associate

set_volume_qos (action="associate")

⚠️ Live unverified

Associates a specification with a volume type by name or ID, then reads the associations back and reports accepted separately from confirmed. Added 2026-11-17; unit tests only

openstack volume qos disassociate

set_volume_qos (action="disassociate")

⚠️ Live unverified

Disassociates one volume type by name or ID and reads the associations back. Added 2026-11-17; unit tests only

openstack volume qos disassociate --all

set_volume_qos (action="disassociate_all")

⚠️ Live unverified

Disassociates every volume type and reads the associations back. Added 2026-11-17; unit tests only

4. πŸ–ΌοΈ Image (Glance)

OpenStack CLI Command

MCP Tool

Status

Notes

openstack image list

get_image_detail_list

βœ…

Image listing. A failed query returns an error instead of an empty list. 2026-11-10 targeted check: listed

openstack image show

get_image_detail_list (filtering)

βœ…

Specific image query

openstack image create

set_image (action="create")

βœ…

Creates the image record with min_disk, min_ram and properties only. No image data is uploaded, so the image stays queued and cannot boot servers

openstack image create --file / --import

β€”

❌ Not implemented

No tool uploads or imports image data

openstack image delete

set_image (action="delete")

⚠️ Live unverified

Only images owned by the current project; other projects' public, shared or community images are refused (previously allowed). This 2026-11-17 change is unit-tested only

openstack image set

set_image (action="update")

⚠️ Live unverified

Only images owned by the current project (previously any visible image). This 2026-11-17 change is unit-tested only

openstack image save

β€”

❌ Not implemented

set_image supports create, delete, update and list only; there is no download action

openstack image add project

set_image_members (action="add")

βœ…

Add a project to an image with shared visibility

openstack image member list

get_image_members

βœ…

Image member listing

openstack image member create

set_image_members

βœ…

Image member management

openstack image set --property

set_image_metadata

⚠️ Live unverified

show reads any visible image; set applies only to images owned by the current project (previously any visible image). This 2026-11-17 change is unit-tested only

openstack image set --public/private

set_image_visibility

⚠️ Live unverified

show reads any visible image; set applies only to images owned by the current project (previously any visible image). This 2026-11-17 change is unit-tested only

5. πŸ‘₯ Identity (Keystone)

OpenStack CLI Command

MCP Tool

Status

Notes

openstack user list

get_user_list

⚠️ Live unverified

Reader denied by Keystone; explicit MCP failure observed; successful listing not validated in this round

openstack user show

get_user_list

⚠️ Live unverified

Depends on policy-limited user listing; not independently validated for the new readers

openstack user create/delete

set_users

βœ…

Password from a server environment variable; no role grants

openstack project list

get_project_details (all_projects=true)

βœ…

Without all_projects, only the current project with its resource counts. With all_projects=true and ALLOW_CROSS_PROJECT_READ=true, a summary of every project Keystone policy allows. 2026-11-13 targeted check: administrator listed three projects; a member received an explicit Keystone policy-denial failure

openstack project show

get_project_details (name param)

βœ…

Without all_projects, only the current project. With all_projects=true and a name or ID that matches one project, that project's details and resource counts, including another project's. 2026-11-13 targeted check: administrator's counts for two other projects matched direct API counts; a member received the Keystone policy-denial failure

openstack project create/delete

set_project

βœ…

Project management

openstack project create --parent, openstack project set --tag

β€”

❌ Not implemented

set_project rejects parent and tags before any API call (previously ignored while the action ran)

openstack role list

get_role_assignments

βœ…

Role listing

openstack role assignment list

get_role_assignments

βœ…

A failed query returns an error instead of a placeholder assignment. 2026-11-10 targeted check: listed as administrator; reader roles were denied by Keystone policy in an earlier round

openstack role create

set_roles (action="create")

βœ…

Role creation; set_roles also lists roles

openstack role delete

β€”

❌ Not implemented

set_roles supports list and create only

openstack domain list

get_domains

βœ…

Subject to Keystone policy

openstack domain create/delete

set_domains

βœ…

Disable explicitly with update before delete

openstack group list

get_identity_groups

βœ…

Subject to Keystone policy

openstack group create/delete

set_identity_groups

βœ…

Group management

openstack service list

get_service_status

⚠️ Live unverified

Reader service-policy restrictions; partial data is not proof of global health. Compute and volume service zones read the SDK availability_zone field (previously always unknown); 2026-11-10 targeted check confirmed this as administrator only

openstack service list (Keystone catalog)

set_services (action="list")

βœ…

Reads the SDK is_enabled field (previously every service showed enabled). 2026-11-10 targeted check: enabled flags matched Keystone

openstack service create/delete

β€”

❌ Not implemented

set_services supports list only

openstack endpoint list

get_service_status (includes endpoints)

⚠️ Live unverified

Reader service-policy restrictions; partial data is not proof of global health

6. πŸ”₯ Orchestration (Heat)

OpenStack CLI Command

MCP Tool

Status

Notes

openstack stack list

get_heat_stacks

βœ…

The stack's project ID or Heat self link must match the current project; unknown and foreign owners are excluded. Own and foreign test stacks were checked. owner reads the SDK owner_id field, and a failed query returns an error instead of a placeholder stack. 2026-11-10 targeted check: an owned test stack was listed

openstack stack show

get_heat_stacks

βœ… Partial

Select the target from the returned list; no name/filter parameter. Resource/event/template/output queries use get_heat_stack_details

openstack stack create

set_heat_stack (action="create")

βœ…

Stack creation. 2026-11-10 targeted check: reached CREATE_COMPLETE. files (JSON object of file name to content, for provider/nested templates): 2026-11-15 targeted check with 3.9.1, an AutoScalingGroup whose members came from a nested template in files was created and scaled out and in by Aodh alarms. timeout_mins: the same check read back 90 on the stack. environment is ⚠️ Live unverified (unit tests only). The server never reads local paths or URLs for files. An OS::Heat::Stack member of an AutoScalingGroup fails to scale from an Aodh alarm (Keystone forbids trust redelegation); use a nested template in files

openstack stack delete

set_heat_stack (action="delete")

βœ…

Foreign-project deletion rejected; owned stack deletion completed after the ownership change. 2026-11-10 targeted check: deleted

openstack stack update

set_heat_stack (action="update")

βœ…

Requires matching stack ownership. The default PUT replaces the stack definition: omitted parameters revert to template defaults. The result reads the SDK status field (previously the tool reported a failure after Heat accepted the update). 2026-11-10 targeted check: an owned stack update was reported as accepted and reached UPDATE_COMPLETE. files, environment and timeout_mins are ⚠️ Live unverified (added 2026-11-15)

openstack stack update --existing

set_heat_stack (action="update", existing=true)

⚠️ Live unverified

PATCH that keeps the stored template, parameters, files and environment and changes only the supplied fields; template is optional. Added 2026-11-15; unit tests only

openstack stack suspend/resume

β€”

❌ Not implemented

set_heat_stack supports create, delete, update and validate only

openstack orchestration template validate

set_heat_stack (action="validate")

βœ…

Posts the template with files and environment to Heat's /validate; the stack name is only a label. 2026-11-15 targeted check with 3.9.1: a template with a nested member template in files passed

openstack stack resource list

get_heat_stack_details (section="resources")

βœ…

Actual Heat resources. nested_depth (like -n) is ⚠️ Live unverified (added 2026-11-15)

openstack stack event list

get_heat_stack_details (section="events")

βœ…

Owned stack events retrieved after the ownership change. nested_depth is ⚠️ Live unverified (added 2026-11-15)

openstack stack template show

get_heat_stack_details (section="template")

βœ…

Owned stack template retrieved after the ownership change

openstack stack output list

get_heat_stack_details (section="outputs")

βœ…

Owned stack outputs retrieved after the ownership change

7. βš–οΈ Load Balancer (Octavia)

The Octavia tools read the openstacksdk attribute names (is_admin_state_up, is_enabled, the listener load_balancer_id, the L7 rule rule_value and plural quota fields), list pool members with members(pool), create L7 rules with create_l7_rule(policy, ...), and filter listeners by load balancer. These corrections are unit-tested against real openstacksdk resource objects only; Octavia was not available in any live test cloud.

OpenStack CLI Command

MCP Tool

Status

Notes

openstack loadbalancer list

get_load_balancer_list

⚠️ Live unverified

Implemented; Octavia unavailable in the test platform. Load balancer listing with pagination; one call returns at most LIST_MAX_LIMIT items (default 100, previously a fixed 200)

openstack loadbalancer show

get_load_balancer_details

βœ…

2026-11-12 targeted Octavia read check passed. Load balancer detailed information; pools are matched to listeners from each pool's listeners references

openstack loadbalancer create

set_load_balancer (action="create")

⚠️ Live unverified

Implemented; Octavia unavailable in the test platform. Load balancer creation

openstack loadbalancer delete

set_load_balancer (action="delete")

⚠️ Live unverified

Implemented; Octavia unavailable in the test platform. Load balancer deletion

openstack loadbalancer set

set_load_balancer (action="update")

⚠️ Live unverified

Implemented; Octavia unavailable in the test platform. Load balancer property update

openstack loadbalancer stats show

set_load_balancer (action="stats")

⚠️ Live unverified

Implemented; Octavia unavailable in the test platform. Load balancer statistics

openstack loadbalancer status show

set_load_balancer (action="status")

βœ…

Octavia status tree (GET /lbaas/loadbalancers/{id}/status): listeners, pools, members and health monitors with their states. Previously returned only the load balancer's own state. 2026-11-16 targeted check: returned a load balancer with two listeners sharing one pool of two members, all ACTIVE/ONLINE

openstack loadbalancer failover

set_load_balancer (action="failover")

⚠️ Live unverified

Implemented; Octavia unavailable in the test platform. Load balancer failover

openstack loadbalancer unset

set_load_balancer (action="unset")

⚠️ Live unverified

Implemented; Octavia unavailable in the test platform. Load balancer property unset

Listener Management

openstack loadbalancer listener list

get_load_balancer_listeners

⚠️ Live unverified

Implemented; Octavia unavailable in the test platform. Listener listing for load balancer; reports provisioning_status, operating_status, default_tls_container_ref and sni_container_refs

openstack loadbalancer listener create

set_load_balancer_listener (action="create")

⚠️ Live unverified

Implemented; Octavia unavailable in the test platform. Listener creation (HTTP/HTTPS/TCP/UDP)

openstack loadbalancer listener create --protocol TERMINATED_HTTPS --default-tls-container-ref --sni-container-refs

set_load_balancer_listener (action="create"/"set", default_tls_container_ref, sni_container_refs)

βœ…

Barbican secret or certificate container by name, ID or href (names resolved to hrefs); default_tls_container_ref required for TERMINATED_HTTPS; certificate errors carry a prerequisite hint. See the Barbican and TLS guide 2026-11-15 targeted check (OpenWebUI, single account): a TERMINATED_HTTPS listener on port 443, given a self-signed secret by name and the existing HTTP pool, reached ACTIVE/ONLINE beside the HTTP listener. A later run on the same day, through a Claude client, created a new secret and listener the same way; curl -vk to the floating IP and the VIP completed a TLSv1.3 handshake with that certificate (h2 negotiated) and got HTTP 200 from each of the two HTTP members. Not checked: sni_container_refs and set.

openstack loadbalancer listener delete

set_load_balancer_listener (action="delete")

⚠️ Live unverified

Implemented; Octavia unavailable in the test platform. Listener deletion

openstack loadbalancer listener show

get_load_balancer_listeners

⚠️ Live unverified

Implemented; Octavia unavailable in the test platform. Listener detailed information

openstack loadbalancer listener set

set_load_balancer_listener (action="update")

⚠️ Live unverified

Implemented; Octavia unavailable in the test platform. Listener property update

openstack loadbalancer listener stats show

set_load_balancer_listener (action="stats")

⚠️ Live unverified

Implemented; Octavia unavailable in the test platform. Listener statistics

openstack loadbalancer listener unset

set_load_balancer_listener (action="unset")

⚠️ Live unverified

Implemented; Octavia unavailable in the test platform. Listener property unset

Pool Management

openstack loadbalancer pool list

get_load_balancer_pools

βœ…

2026-11-12 targeted Octavia read check passed. Pool listing (all or by listener); reports listener_ids, loadbalancer_ids and health_monitor_id from the Octavia response

openstack loadbalancer pool create

set_load_balancer_pool (action="create")

⚠️ Live unverified

Implemented; Octavia unavailable in the test platform. Pool creation with algorithms

openstack loadbalancer pool delete

set_load_balancer_pool (action="delete")

⚠️ Live unverified

Implemented; Octavia unavailable in the test platform. Pool deletion

openstack loadbalancer pool set

set_load_balancer_pool (action="set")

⚠️ Live unverified

Implemented; Octavia unavailable in the test platform. Pool property update

openstack loadbalancer pool create/set --enable-tls --ca-tls-container-ref --crl-container-ref --tls-version --tls-ciphers --alpn-protocol

set_load_balancer_pool (action="create"/"set", tls_enabled, ca_tls_container_ref, crl_container_ref, tls_versions, tls_ciphers, alpn_protocols)

⚠️ Live unverified

Unit-tested only. Backend re-encryption; certificate references by Barbican name, ID or href. Pool results report these fields. See the Barbican and TLS guide

openstack loadbalancer pool create/set --tls-container-ref

set_load_balancer_pool (tls_container_ref)

⚠️ Live unverified

Unit-tested only. Client authentication for backend re-encryption: the client certificate for members that require mutual TLS (mTLS). openstacksdk 4.22.0 has no such pool field, so a request with it goes to the Octavia API directly; show reads it from the Octavia response

openstack loadbalancer pool show

get_load_balancer_pools

βœ…

2026-11-12 targeted Octavia read check passed. Pool detailed information, including listener_ids, loadbalancer_ids and health_monitor_id

openstack loadbalancer pool stats show

N/A

❌ Not implemented

No registered tool/action for this CLI operation

openstack loadbalancer pool unset

N/A

❌ Not implemented

No registered tool/action for this CLI operation

Member Management

openstack loadbalancer member list

get_load_balancer_pool_members

⚠️ Live unverified

Implemented; Octavia unavailable in the test platform. Pool member listing

openstack loadbalancer member create

set_load_balancer_pool_member (action="create")

⚠️ Live unverified

Implemented; Octavia unavailable in the test platform. Pool member creation

openstack loadbalancer member delete

set_load_balancer_pool_member (action="delete")

⚠️ Live unverified

Implemented; Octavia unavailable in the test platform. Pool member deletion

openstack loadbalancer member set

set_load_balancer_pool_member (action="set")

⚠️ Live unverified

Implemented; Octavia unavailable in the test platform. Pool member property update

openstack loadbalancer member show

get_load_balancer_pool_members

⚠️ Live unverified

Implemented; Octavia unavailable in the test platform. Pool member detailed information

openstack loadbalancer member unset

N/A

❌ Not implemented

No registered tool/action for this CLI operation

Health Monitor Management

openstack loadbalancer healthmonitor list

get_load_balancer_health_monitors

βœ…

2026-11-12 targeted Octavia read check passed. Health monitor listing (all or by pool); reports pool_ids from the Octavia response

openstack loadbalancer healthmonitor create

set_load_balancer_health_monitor (action="create")

⚠️ Live unverified

Implemented; Octavia unavailable in the test platform. Health monitor creation; types include TLS-HELLO for non-terminated HTTPS (TLS passthrough) pools

openstack loadbalancer healthmonitor delete

set_load_balancer_health_monitor (action="delete")

⚠️ Live unverified

Implemented; Octavia unavailable in the test platform. Health monitor deletion

openstack loadbalancer healthmonitor set

set_load_balancer_health_monitor (action="set")

⚠️ Live unverified

Implemented; Octavia unavailable in the test platform. Health monitor update

openstack loadbalancer healthmonitor show

get_load_balancer_health_monitors

βœ…

2026-11-12 targeted Octavia read check passed. Health monitor detailed information, including pool_ids

openstack loadbalancer healthmonitor unset

N/A

❌ Not implemented

No registered tool/action for this CLI operation

L7 Policy Management

openstack loadbalancer l7policy list

get_load_balancer_l7_policies

⚠️ Live unverified

Implemented; Octavia unavailable in the test platform. L7 policy listing

openstack loadbalancer l7policy create

set_load_balancer_l7_policy (action="create")

⚠️ Live unverified

Implemented; Octavia unavailable in the test platform. This management tool supports create/delete only

openstack loadbalancer l7policy delete

set_load_balancer_l7_policy (action="delete")

⚠️ Live unverified

Implemented; Octavia unavailable in the test platform. L7 policy deletion

openstack loadbalancer l7policy set

N/A

❌ Not implemented

No registered tool/action for this CLI operation

openstack loadbalancer l7policy show

get_load_balancer_l7_policies

⚠️ Live unverified

Implemented; Octavia unavailable in the test platform. L7 policy details

openstack loadbalancer l7policy unset

N/A

❌ Not implemented

No registered tool/action for this CLI operation

L7 Rule Management πŸ†•

openstack loadbalancer l7rule list

get_load_balancer_l7_rules

⚠️ Live unverified

Implemented; Octavia unavailable in the test platform. L7 rule listing

openstack loadbalancer l7rule create

set_load_balancer_l7_rule (action="create")

⚠️ Live unverified

Implemented; Octavia unavailable in the test platform. L7 rule creation

openstack loadbalancer l7rule delete

set_load_balancer_l7_rule (action="delete")

⚠️ Live unverified

Implemented; Octavia unavailable in the test platform. L7 rule deletion

openstack loadbalancer l7rule set

N/A

❌ Not implemented

No registered tool/action for this CLI operation

openstack loadbalancer l7rule show

get_load_balancer_l7_rules

⚠️ Live unverified

Implemented; Octavia unavailable in the test platform. L7 rule details

openstack loadbalancer l7rule unset

N/A

❌ Not implemented

No registered tool/action for this CLI operation

Amphora Management πŸ†•

openstack loadbalancer amphora list

get_load_balancer_amphorae

⚠️ Live unverified

Implemented; Octavia unavailable in the test platform. Amphora listing

openstack loadbalancer amphora show

set_load_balancer_amphora (action="show")

⚠️ Live unverified

Implemented; Octavia unavailable in the test platform. Amphora details

openstack loadbalancer amphora configure

set_load_balancer_amphora (action="configure")

⚠️ Live unverified

Implemented; Octavia unavailable in the test platform. Amphora configuration

openstack loadbalancer amphora failover

set_load_balancer_amphora (action="failover")

⚠️ Live unverified

Implemented; Octavia unavailable in the test platform. Amphora failover

openstack loadbalancer amphora delete

N/A

❌

Not supported by OpenStack SDK

openstack loadbalancer amphora stats show

N/A

❌

Not supported by OpenStack SDK

Provider Management

openstack loadbalancer provider list

get_load_balancer_providers

⚠️ Live unverified

Implemented; Octavia unavailable in the test platform. Provider listing

openstack loadbalancer provider capability list

N/A

❌ Not implemented

No registered tool/action for this CLI operation

Availability Zone Management πŸ†•

openstack loadbalancer availabilityzone list

get_load_balancer_availability_zones

⚠️ Live unverified

Implemented; Octavia unavailable in the test platform. Availability zone listing

openstack loadbalancer availabilityzone show

get_load_balancer_availability_zones

⚠️ Live unverified

Implemented; Octavia unavailable in the test platform. Availability zone details

openstack loadbalancer availabilityzone create

set_load_balancer_availability_zone (action="create")

⚠️ Live unverified

Implemented; Octavia unavailable in the test platform. Availability zone creation

openstack loadbalancer availabilityzone delete

set_load_balancer_availability_zone (action="delete")

⚠️ Live unverified

Implemented; Octavia unavailable in the test platform. Availability zone deletion

openstack loadbalancer availabilityzone set

N/A

❌ Not implemented

No registered tool/action for this CLI operation

openstack loadbalancer availabilityzone unset

N/A

❌ Not implemented

No registered tool/action for this CLI operation

Flavor Management πŸ†•

openstack loadbalancer flavor list

get_load_balancer_flavors

⚠️ Live unverified

Implemented; Octavia unavailable in the test platform. Flavor listing

openstack loadbalancer flavor show

get_load_balancer_flavors

⚠️ Live unverified

Implemented; Octavia unavailable in the test platform. Flavor details

openstack loadbalancer flavor create

set_load_balancer_flavor (action="create")

⚠️ Live unverified

Implemented; Octavia unavailable in the test platform. Flavor creation

openstack loadbalancer flavor delete

set_load_balancer_flavor (action="delete")

⚠️ Live unverified

Implemented; Octavia unavailable in the test platform. Flavor deletion

openstack loadbalancer flavor set

N/A

❌ Not implemented

No registered tool/action for this CLI operation

openstack loadbalancer flavor unset

N/A

❌ Not implemented

No registered tool/action for this CLI operation

Flavor Profile Management

openstack loadbalancer flavorprofile list

N/A

❌ Not implemented

No registered tool/action for this CLI operation

openstack loadbalancer flavorprofile show

N/A

❌ Not implemented

No registered tool/action for this CLI operation

openstack loadbalancer flavorprofile create

N/A

❌ Not implemented

No registered tool/action for this CLI operation

openstack loadbalancer flavorprofile set

N/A

❌ Not implemented

No registered tool/action for this CLI operation

openstack loadbalancer flavorprofile unset

N/A

❌ Not implemented

No registered tool/action for this CLI operation

openstack loadbalancer flavorprofile delete

N/A

❌ Not implemented

No registered tool/action for this CLI operation

Quota Management πŸ†•

openstack loadbalancer quota list

get_load_balancer_quotas

⚠️ Live unverified

Implemented; Octavia unavailable in the test platform. Quota listing

openstack loadbalancer quota show

get_load_balancer_quotas

⚠️ Live unverified

Implemented; Octavia unavailable in the test platform. Quota details

openstack loadbalancer quota set

set_load_balancer_quota (action="set")

⚠️ Live unverified

Implemented; Octavia unavailable in the test platform. Quota setting

openstack loadbalancer quota reset

set_load_balancer_quota (action="reset")

⚠️ Live unverified

Implemented; Octavia unavailable in the test platform. Quota reset

8. πŸ” Key Manager (Barbican)

Secret payloads are excluded on purpose. Barbican and openstacksdk can store and return them, but tool arguments and results pass through the LLM, so no tool accepts or returns a payload: register your own certificates and keys outside MCP and reference them by name or href. Reads use Barbican's metadata API, never the SDK's payload-downloading get_secret/find_secret. See the Barbican and TLS guide.

OpenStack CLI Command

MCP Tool

Status

Notes

openstack secret list

get_secrets

⚠️ Live unverified

Unit-tested only. Metadata of current-project secrets; secret_type filter; limit 1-1000 with truncated

openstack secret get

get_secrets (name)

⚠️ Live unverified

Unit-tested only. By name, ID or href; metadata and consumers only

openstack secret get --payload / --decrypt

N/A

❌ Not implemented

Intentionally excluded: payloads would reach the LLM

openstack secret store (user payload)

N/A

❌ Not implemented

Intentionally excluded: payloads would reach the LLM. Register user certificates outside MCP

openssl req -x509 + openstack secret store

set_secret (action="create_self_signed_tls")

βœ…

Key and certificate generated in the MCP server and stored as an unencrypted PKCS#12 opaque secret; returns the href, public certificate and fingerprint, never the key 2026-11-15 targeted check: created a secret with IP SANs; the result held the href, public certificate, fingerprint and expiry, and no key or payload.

openstack secret delete

set_secret (action="delete")

⚠️ Live unverified

Unit-tested only. By name, ID or href

openstack secret container list / show

get_secret_containers

⚠️ Live unverified

Unit-tested only. List, or one container by name, ID or href

openstack secret container create

set_secret_container (action="create")

⚠️ Live unverified

Unit-tested only. generic, certificate or rsa from existing secrets given by name, ID or href

openstack secret container delete

set_secret_container (action="delete")

⚠️ Live unverified

Unit-tested only. The secrets are kept

openstack secret order list / get

get_secret_orders

⚠️ Live unverified

Unit-tested only. Raw order data, including container_ref of asymmetric orders

openstack secret order create

set_secret_order (action="create")

⚠️ Live unverified

Unit-tested only. key (default aes 256 cbc) or asymmetric (default rsa 2048); Barbican generates the key; asynchronous

openstack secret order delete

set_secret_order (action="delete")

⚠️ Live unverified

Unit-tested only

openstack acl get

get_secret_acl

⚠️ Live unverified

Unit-tested only. Secret or container

openstack acl user add / user remove / submit / delete

set_secret_acl (action="add_users"/"remove_users"/"set"/"delete")

⚠️ Live unverified

Unit-tested only. Secret or container; set replaces the user list and optionally project_access

Barbican effective quotas (GET /v1/quotas)

get_key_manager_quotas

⚠️ Live unverified

Unit-tested only. Current project's effective quotas. Project quota changes are not implemented

Secret store backends (GET /v1/secret-stores)

get_secret_stores

⚠️ Live unverified

Unit-tested only. Served only when Barbican enables multiple secret store backends

9. πŸ“Š Monitoring & Logging

Allocation and measured telemetry are separate. get_resource_monitoring, get_quota, and get_usage_statistics report flavor allocations, quotas, capacity, and allocation-hours from Nova. get_gnocchi_* tools report observed time series collected by Ceilometer into Gnocchi. Tool descriptions cross-reference each other so that requests for utilization, load, or trends use Gnocchi. They also instruct the model to report an uncollected measured metric as not collected instead of substituting allocations. When the Keystone catalog has no metric endpoint, the get_gnocchi_* tools report "Metric service (Gnocchi) is not available in this cloud" (checked live on OpenStack 2026.1).

OpenStack CLI Command

MCP Tool

Status

Notes

Resource monitoring

get_resource_monitoring

⚠️ Live unverified

Reader physical-capacity policy restrictions; allocations are separate from capacity; no live utilization

Service status

get_service_status

⚠️ Live unverified

Reader service-policy restrictions; partial data is not proof of global health

Cluster overview

get_service_status + get_resource_monitoring

⚠️ Live unverified

Reader physical-capacity policy restrictions; allocations are separate from capacity; no live utilization

Service log metadata

set_service_logs

Partial

Service listing only; log retrieval is unavailable without a logging backend. Network agents are listed from the SDK is_admin_state_up field (previously omitted); 2026-11-10 targeted check: listed with network agents

Resource metadata

set_metrics

Partial

Nova/Neutron/Cinder list/summary only; does not call Gnocchi. Use get_gnocchi_* for telemetry

gnocchi resource list/search/show/history

get_gnocchi_resources

βœ…

Current-project resources; list, attribute filter, show with metrics map, and history passed live

gnocchi metric list/show

get_gnocchi_metrics

βœ…

List, per-resource details, show by resource + name, and show by metric UUID passed live

gnocchi measures show

get_gnocchi_measures

βœ…

By resource + name and by metric UUID passed live, including start, granularity, resample, refresh, latest-N limit, and rate:mean for cpu; memory.usage, disk, and network measures were read. Unsupported aggregation and missing metric returned failures

gnocchi aggregates

get_gnocchi_aggregates

βœ…

Current-project search is always applied. Passed live: project-wide cpu rate:mean mean, top, groupby="flavor_name", and the memory.usage/memory ratio expression. Ranking across several resources is unit-tested only because the test project had one instance. A metric UUID owned outside the project returned 404 in expression mode. Mixed modes and missing metrics returned failures with hints. Unfilled gaps are returned as null

gnocchi archive-policy/archive-policy-rule/resource-type list, gnocchi capabilities list, gnocchi status

get_gnocchi_service_info

βœ…

All five sections returned live with the admin test account; a denied section is reported per section

Alarm management

set_alarms

βœ…

list/create/show/delete passed live, by name and by ID. Evaluation passed live: cpu alarms with aggregation_method="rate:mean" reached ok and alarm as expected, and a vcpus alarm reached alarm. Aodh accepted alarms for a nonexistent resource and for the default cpu_util, which current Ceilometer does not collect; check metrics with get_gnocchi_metrics first

Compute agents

set_compute_agents

βœ…

list/show of Nova services and hypervisors. show by agent_id looks the service up in the service listing (the SDK has no single-service lookup; this previously failed), and zones and hypervisor capacity read the SDK field names. 2026-11-10 targeted check (administrator): list with hypervisors, show by ID, show by host, and an explicit error for an unknown ID

Usage statistics

get_usage_statistics

βœ…

Period compute allocation-hours plus separately labeled current snapshots

10. πŸ“ Usage & Quota

OpenStack CLI Command

MCP Tool

Status

Notes

openstack quota show

get_quota

βœ…

Quota query. The network floating IP quota reads the SDK floating_ips field (previously always -1). 2026-11-10 targeted check: matched the Neutron quota. Compute usage sums vCPUs and RAM from the flavor embedded in each server (Nova 2.47+, where the flavor id holds its name) and reports null with unsized_instances when a flavor cannot be sized; previously every lookup failed silently and usage was 0. 2026-11-16 targeted check: two m1.small servers reported 2 vCPUs and 4096 MB (previously 0 and 0). Each service also reports usage_percent, null for unlimited, zero or missing limits and for unknown usage; a failed backup or security group rule count is null with its error instead of 0 (2026-11-17, unit-tested only)

openstack quota set

set_quota (action="set")

βœ…

Routes supplied fields to Nova/Neutron/Cinder; partial failures are reported

openstack quota delete

set_quota (action="delete")

βœ…

Resets all three service quotas to defaults; requires modification tools

openstack usage show

get_usage_statistics

βœ…

Current-project Nova simple tenant usage; not monetary charges

openstack limits show

get_quota (includes limits)

βœ…

Limits query

Resource allocations

get_resource_monitoring

⚠️ Live unverified

Reader physical-capacity policy restrictions; allocations are separate from capacity; no live utilization

11. πŸ—‚οΈ Cross-project reads (advanced, opt-in)

Off by default and not needed for single-project use. These rows apply only when the server sets ALLOW_CROSS_PROJECT_READ=true and OpenStack policy lets the credential read across projects; see the cross-project reads guide.

OpenStack CLI Command

MCP Tool

Status

Notes

openstack server list --all-projects

get_instance_details, search_instances, get_instances_by_status (all_projects=true)

βœ…

Requires ALLOW_CROSS_PROJECT_READ=true; OpenStack policy decides access (cross-project reads guide). Rows carry project_id and project_name. 2026-11-13 targeted check: administrator listed three projects' servers; a member received an explicit Nova policy-denial error in fixed-credential and multi-user modes

openstack server group list --all-projects

get_server_groups (all_projects=true)

βœ…

Requires ALLOW_CROSS_PROJECT_READ=true; OpenStack policy decides access. Rows carry project_id and project_name. 2026-11-14 targeted check: administrator listed another project's server group; a member received only its own with scope.warning

openstack network list (administrator, every project)

get_network_details (all_projects=true)

βœ…

Requires ALLOW_CROSS_PROJECT_READ=true. Neutron has no all-projects flag and never denies a list; it returns what the credential can see, so a result without another project's unshared resource carries scope.warning. Only with the default network_name; other projects' shared and external networks do not count. 2026-11-13 targeted check: administrator listed three projects' networks; a member received its own and the shared external network with the warning

openstack router list (administrator, every project)

get_routers (all_projects=true)

βœ…

Requires ALLOW_CROSS_PROJECT_READ=true. Neutron has no all-projects flag and never denies a list; it returns what the credential can see, so a result without another project's unshared resource carries scope.warning. 2026-11-13 targeted check: administrator listed routers of two projects; a member received only its own router with the warning

openstack floating ip list (administrator, every project)

get_floating_ips (all_projects=true)

βœ…

Requires ALLOW_CROSS_PROJECT_READ=true. Neutron has no all-projects flag and never denies a list; it returns what the credential can see, so a result without another project's unshared resource carries scope.warning. 2026-11-13 targeted check: administrator listed floating IPs of two projects; a member received only its own with the warning

openstack security group list --all-projects

get_security_groups (all_projects=true)

βœ…

Requires ALLOW_CROSS_PROJECT_READ=true. Neutron has no all-projects flag and never denies a list; it returns what the credential can see, so a result without another project's unshared resource carries scope.warning. Rows carry shared. 2026-11-13 targeted check: administrator listed three projects' groups, including Octavia's in the service project; a member received only its own with the warning

openstack volume list --all-projects

get_volume_list (all_projects=true)

βœ…

Requires ALLOW_CROSS_PROJECT_READ=true. Cinder narrows an unauthorized request to the caller's project instead of denying it, so a current-project-only result carries scope.warning. 2026-11-13 targeted check: administrator listed two projects' volumes; a member received only its own volume with the warning

openstack volume snapshot list --all-projects

get_volume_snapshots (all_projects=true)

βœ…

Requires ALLOW_CROSS_PROJECT_READ=true; narrowed results carry scope.warning as for volumes. 2026-11-13 targeted check: administrator listed another project's snapshot; a member received only its own snapshot with the warning

openstack volume backup list --all-projects

get_volume_backups (all_projects=true)

βœ…

Requires ALLOW_CROSS_PROJECT_READ=true. Cinder narrows an unauthorized request to the caller's project and shows owner projects only to administrators, so a result without visible owners carries its own scope.warning. 2026-11-14 targeted check: administrator listed another project's backup with its project; a member received its own backup without an owner and the warning

openstack volume group list --all-projects

get_volume_groups (all_projects=true)

βœ…

Requires ALLOW_CROSS_PROJECT_READ=true. Cinder narrows an unauthorized request to the caller's project and shows owner projects only to administrators, so a result without visible owners carries its own scope.warning. Owners are read at microversion 3.58. 2026-11-14 targeted check: administrator listed another project's group with its project; a member received its own group without an owner and the warning

openstack image list (administrator, every project)

get_image_detail_list (all_projects=true)

βœ…

Requires ALLOW_CROSS_PROJECT_READ=true. Glance has no all-projects flag and returns other projects' private images only to administrators, while public images are visible to everyone; a result without another project's non-public image carries scope.warning. 2026-11-14 targeted check: administrator listed images of three projects; a member received its own and public images with the warning

openstack stack list --all-projects

get_heat_stacks (all_projects=true)

βœ…

Requires ALLOW_CROSS_PROJECT_READ=true; sends Heat's global_tenant query. Heat's default stacks:global_index policy is deny_everybody, so the request returns a policy-denial error even for administrators unless the operator changes that policy. 2026-11-14 targeted check: administrator and member both received the policy-denial error; after stacks:global_index was allowed for a dedicated role, a member with that role listed stacks of two projects

openstack loadbalancer list (administrator, every project)

get_load_balancer_list (all_projects=true)

βœ…

Requires ALLOW_CROSS_PROJECT_READ=true. Octavia narrows an unauthorized request to the caller's project, so a current-project-only result carries result.scope.warning; the scope covers every page. 2026-11-14 targeted check: administrator listed load balancers of two projects; a member received only its own with the warning


API prerequisites and result semantics

The feature table marks implemented API paths, not verification against every OpenStack deployment. Service and policy requirements must be checked in the target deployment. A missing service, extension, required microversion, or permission is an operation failure, not an empty successful result.

  • Modification tools: the MCP server registers set_* management tools only when ALLOW_MODIFY_OPERATIONS=true. Existing action guards also reject writes when disabled. Dedicated read-only get_* tools remain available. API authorization is enforced by the target cloud; agent, user, domain, type and QoS administration may require elevated OpenStack roles.

  • Alarms: set_alarms calls the Keystone catalog's alarming endpoint for the configured interface/region. It supports list/create/show/delete of project alarms and creates gnocchi_resources_threshold alarms. Aodh, Gnocchi, the specified resource and a collected metric are required. The default metric cpu_util is kept for compatibility, but Ceilometer has not produced it since Stein, so such alarms stay insufficient data. For CPU alarms, use metric="cpu" with aggregation_method="rate:mean"; the threshold is CPU nanoseconds per granularity window (percent / 100 Γ— granularity Γ— 10⁹ Γ— vCPUs; 80% of one vCPU over 300 s is 2.4e11). metric, resource_type, aggregation_method, granularity, evaluation_periods, and alarm_actions can be supplied. An empty action list creates an alarm without notifications. There is no simulation fallback.

  • Usage: get_usage_statistics calls Nova simple tenant usage for the current project. Requires Nova API microversion 2.40 or newer for complete pagination. Date bounds are UTC midnight, start inclusive and end exclusive; start must precede end. usage_statistics.period_compute contains paginated Nova allocation-hours, not actual CPU load, billed currency, or network/storage history. Nova accounts using VM lifetime and the latest flavor; stop/pause/resize history is not reconstructed. Existing compute, network, and storage fields are current snapshots, labeled by snapshot_fields and snapshot_timestamp. An unavailable period API returns failure. A failed snapshot section is reported as partial failure.

  • Capacity: get_resource_monitoring separates flavor allocations from project quota limits and the physical totals of visible hypervisors. Missing physical totals or incomplete flavor allocations return null, not invented capacity or zero usage. Physical totals and project allocations have different scopes. This tool does not collect live utilization or trends.

  • Floating IP pools: total_ips is the exact sum of visible subnet allocation ranges; used_ips counts visible Floating IP objects. Global available_ips is null: other projects and non-floating ports may consume addresses that are not visible to the caller.

  • Volume groups: the cloud must support Cinder generic groups (microversion 3.13 or newer). Create requires an existing group_type and comma-delimited volume_types. Deletion does not delete member volumes unless delete_volumes=true is explicitly supplied. Async creation/deletion responses mean accepted, not finished.

  • Identity and images: set_users reads a new user's password from the server variable named by password_env; never put passwords in prompts. It does not grant project roles. Disable a domain explicitly with set_domains(action="update", enabled=false) before deleting it. Image member modifications require an image owned by the current project, shared visibility, and appropriate Glance policy; adding a member does not automatically accept the recipient's membership.

  • Telemetry (Gnocchi): the read-only get_gnocchi_resources, get_gnocchi_metrics, get_gnocchi_measures, get_gnocchi_aggregates, and get_gnocchi_service_info tools use gnocchiclient with the Keystone catalog's metric endpoint for the configured interface/region. Ceilometer must be collecting data into Gnocchi; it has no API of its own. Results are limited to resources whose project_id is the current project. Metrics are created by the Ceilometer service project, so ownership is checked through the embedded resource. Available metrics depend on deployment. Notification-based metrics such as vcpus, memory, and disk.root.size record flavor sizes. Polled metrics such as cpu, memory.usage, disk.device.*, and network.* require a working ceilometer-compute agent and a running instance. cpu is cumulative nanoseconds; use aggregation="rate:mean" when the archive policy supports it. Current Ceilometer does not produce cpu_util. Measures and aggregation methods are limited by each metric's archive policy. get_gnocchi_aggregates accepts either structured parameters or an operations expression; both add a current-project resource search, so expression metric references resolve as metric names on matched resources. Arithmetic between metrics returns points only where every operand has data. Gnocchi write operations (measure ingestion, resource/metric/archive policy changes) are not implemented.

  • Barbican and TLS listeners: the Barbican tools use the Keystone catalog's key-manager endpoint; without it they report "Barbican (key-manager) service is not available". Creating secrets requires the role Barbican's policy demands (admin or creator under the legacy policy, project member under Secure RBAC). For TERMINATED_HTTPS listeners, Octavia's default barbican_acl_auth grants its service user read access to the referenced secret when the listener is created; the requesting user must be allowed to change that secret's ACL. These are deployment prerequisites, described in the Barbican and TLS guide.

  • Logs and telemetry: set_service_logs(action="show") and set_metrics(action="show") return explicit unsupported errors. No centralized logging backend is implemented. set_metrics list/summary operations expose Nova/Neutron/Cinder resource metadata only; use the Gnocchi tools for telemetry samples.


Contributing

Contributions are welcome. See the development guide for running the tests, adding tools, and the pull request workflow.

License

This project is licensed under the MIT License - see the LICENSE file for details.

Available Tools

61 tools
get_availability_zonesGet Availability ZonesB

List availability zones and their status

Inputs: no named parameters. Returns: result

get_domainsGet DomainsB

List Keystone domains subject to cloud policy.

Inputs: no named parameters. Returns: result

get_floating_ip_poolsGet Floating Ip PoolsA

Get list of floating IP pools (external networks).

Functions:

  • List all external networks that can provide floating IPs

  • Show available and used IP counts for each pool

  • Display network configuration for floating IP allocation

  • Provide pool capacity and utilization information

Use when user requests:

  • "Show floating IP pools"

  • "List available floating IP networks"

  • "Check floating IP capacity"

  • "What external networks are available?"

Inputs: no named parameters. Returns: result

get_floating_ipsGet Floating IpsB

Get list of floating IPs with their associations.

Functions:

  • Query floating IPs and their current status

  • Display associated fixed IPs and ports

  • Show floating IP pool and router associations

  • Provide floating IP allocation and usage information

Use when user requests floating IP information, external connectivity queries, or IP management tasks.

Inputs: all_projects. Returns: result

get_gnocchi_aggregatesGet Gnocchi AggregatesA

Aggregate measured telemetry across many current-project resources.

Use for cross-resource questions: project-wide averages or totals, top N resources, per-flavor or per-host groups, and ratios between metrics. For one resource's time series, use get_gnocchi_measures instead. For allocations, capacity, or quotas, use get_resource_monitoring.

Choose ONE mode:

  1. Simple mode (preferred): set metric and aggregation, plus optional reaggregation, groupby, and top. Leave operations empty.

    • Project-wide average CPU: metric="cpu", aggregation="rate:mean", reaggregation="mean"

    • Top 5 instances by CPU: metric="cpu", aggregation="rate:mean", top=5

    • Mean memory use per flavor: metric="memory.usage", reaggregation="mean", groupby="flavor_name"

  2. Expression mode: set operations only, for arithmetic between metrics or advanced Gnocchi functions. Leave metric and reaggregation empty. Write metric NAMES, never metric UUIDs, as (metric NAME AGGREGATION). Example ratio: (/ (metric memory.usage mean) (metric memory mean)) Arithmetic returns points only where every operand has data; memory (flavor size) is recorded sparsely, so this ratio has fewer points.

Units: cpu with rate:mean is CPU nanoseconds per granularity window; utilization fraction = value / (granularity * 1e9 * vCPUs). memory.usage is MB in use. vcpus and memory are flavor sizes, not usage.

Results are always limited to resources of the current project. The response echoes the executed operations expression.

Inputs: top, fill, stop, limit, +10 more. Returns: result

get_gnocchi_measuresGet Gnocchi MeasuresA

Read stored Gnocchi measures (telemetry time series) for a metric.

Use for measured utilization, load, trends, and history ("CPU usage of vm1", "memory over the last hour"). Values are observed telemetry collected by Ceilometer, such as cpu, memory.usage, or disk and network counters. Cumulative counters like cpu (nanoseconds) grow over time; compare consecutive values for rates. Some metrics such as vcpus and memory record flavor sizes, not usage. For averages, totals, top N, or groups across many resources, use get_gnocchi_aggregates. For allocations, capacity, or quotas, use get_resource_monitoring or get_quota. If a metric is not collected, report that; do not substitute allocation data.

Inputs: metric (required), stop, limit, start, +5 more. Returns: result

get_gnocchi_metricsGet Gnocchi MetricsA

List or show current-project Gnocchi metrics.

Without arguments, lists metric names and IDs of current-project resources. With resource_id, shows that resource's metrics including archive policy and unit. With metric, shows one metric. Use it to check which telemetry metrics are actually collected before reading measures or creating alarms. These are measured telemetry series, not allocations or quotas.

Inputs: limit, metric, resource_id, resource_type. Returns: result

get_gnocchi_resourcesGet Gnocchi ResourcesA

List, search, or show current-project Gnocchi (telemetry) resources.

Resources are the objects Ceilometer measures, such as instances, disks, and network interfaces. Each resource maps metric names to metric IDs. Use this to find which metrics exist for a server before reading measures.

Inputs: limit, marker, filters, history, +2 more. Returns: result

get_gnocchi_service_infoGet Gnocchi Service InfoA

Read Gnocchi service configuration and health information.

Use to check which granularities and aggregation methods a metric supports (for get_gnocchi_measures or set_alarms), which resource types exist, and whether measure processing is backlogged.

Inputs: sections. Returns: result

get_heat_stack_detailsGet Heat Stack DetailsB

Query resources, events, template, or outputs for a Heat stack.

Inputs: stack_name (required), section, nested_depth. Returns: result

get_heat_stacksGet Heat StacksA

Get list of Heat orchestration stacks.

Functions:

  • Query Heat stacks and their current status

  • Display stack creation and update timestamps

  • Use get_heat_stack_details for templates, resources, events, or outputs

  • Provide orchestration deployment information

Use when user requests stack information, orchestration queries, or infrastructure-as-code status.

Inputs: all_projects. Returns: result

get_hypervisor_detailsGet Hypervisor DetailsC

Get detailed information about hypervisors

Inputs: hypervisor_name. Returns: result

get_identity_groupsGet Identity GroupsC

List Keystone groups subject to cloud policy.

Inputs: no named parameters. Returns: result

get_image_detail_listGet Image Detail ListB

Get detailed list of all images with comprehensive metadata.

Functions:

  • List all images available in the project

  • Show image status, size, and format information

  • Display image properties and metadata

  • Provide ownership and visibility details

Use when user requests image listing, image information, or image metadata details.

Inputs: all_projects. Returns: result

get_image_membersGet Image MembersC

List member projects for an image.

Inputs: image_name (required). Returns: result

get_instanceGet InstanceA

Unified instance query tool supporting all instance retrieval patterns. Consolidates functionality from get_instance_details, get_instance_by_name, get_instances_by_status, and search_instances.

Functions:

  • Get specific instances by names or IDs

  • Filter instances by status (ACTIVE, SHUTOFF, ERROR, etc.)

  • Search instances across multiple fields (name, flavor, image, host, etc.)

  • List all instances with pagination

  • Support both summary and detailed information modes

Use when user requests instance information, status checks, or instance searches.

Inputs: ids, limit, names, offset, +6 more. Returns: result

get_instance_by_nameGet Instance By NameB

Get detailed information for a specific instance by name.

Inputs: instance_name (required). Returns: result

get_instance_detailsGet Instance DetailsB

Provides detailed information and status for OpenStack instances with pagination support.

Functions:

  • Query basic instance information (name, ID, status, image, flavor) with efficient pagination

  • Collect network connection status and IP address information

  • Check CPU, memory, storage resource usage and allocation

  • Provide instance metadata, keypair, and security group settings

  • Support large-scale environments with configurable limits

Use when user requests specific instance information, VM details, server analysis, or instance troubleshooting.

Inputs: limit, offset, include_all, all_projects, +3 more. Returns: result

get_instances_by_statusGet Instances By StatusC

Get instances filtered by status.

Inputs: status (required), all_projects. Returns: result

get_key_manager_quotasGet Key Manager QuotasA

Show the effective Barbican quotas (secrets, orders, containers, consumers, CAs) of the current project; -1 means unlimited.

Inputs: no named parameters. Returns: result

get_keypair_listGet Keypair ListA

Get list of SSH keypairs for the current user.

Functions:

  • Query SSH keypairs and their fingerprints

  • Display keypair types and creation dates

  • Show public key information (truncated for security)

  • Provide keypair management information

Use when user requests SSH key management, keypair information, or security key queries.

Inputs: no named parameters. Returns: result

get_load_balancer_amphoraeGet Load Balancer AmphoraeA

Get amphora instances for a load balancer or all amphorae.

Inputs: lb_name_or_id. Returns: result

get_load_balancer_availability_zonesGet Load Balancer Availability ZonesC

Get load balancer availability zones.

Inputs: no named parameters. Returns: result

get_load_balancer_detailsGet Load Balancer DetailsA

Get detailed information about a specific OpenStack load balancer.

Functions:

  • Shows comprehensive load balancer details including VIP configuration

  • Lists all listeners with their protocols and ports

  • Shows pools and members for each listener

  • Displays health monitor information if configured

  • Provides provisioning and operating status

Use when user requests:

  • "Show details for load balancer [name/id]"

  • "Get load balancer configuration"

  • "Show load balancer listeners and pools"

  • "What's the status of load balancer [name]?"

Inputs: lb_name_or_id (required). Returns: result

get_load_balancer_flavorsGet Load Balancer FlavorsC

Get load balancer flavors.

Inputs: no named parameters. Returns: result

get_load_balancer_health_monitorsGet Load Balancer Health MonitorsA

Get health monitors, optionally filtered by pool.

Functions:

  • Lists all health monitors or monitors for a specific pool

  • Shows monitor types (HTTP, HTTPS, TCP, PING, UDP-CONNECT)

  • Displays health check intervals, timeouts, and retry settings

  • Provides HTTP-specific settings (method, URL path, expected codes)

Use when user requests:

  • "Show all health monitors"

  • "List health monitors for pool [name/id]"

  • "What health checks are configured?"

  • "Show health monitor configuration"

Inputs: pool_name_or_id. Returns: result

get_load_balancer_l7_policiesGet Load Balancer L7 PoliciesA

Get L7 policies for a listener or all L7 policies.

Inputs: listener_name_or_id. Returns: result

get_load_balancer_l7_rulesGet Load Balancer L7 RulesC

Get L7 rules for a specific L7 policy.

Inputs: policy_name_or_id (required). Returns: result

get_load_balancer_listGet Load Balancer ListA

Retrieve comprehensive list of OpenStack load balancers with detailed information.

Functions:

  • Lists all load balancers in the OpenStack cluster

  • Provides detailed load balancer information including VIP, status, listeners

  • Supports pagination for large environments (limit/offset)

  • Shows listener count and basic listener information for each load balancer

  • Displays provisioning and operating status for troubleshooting

Use when user requests:

  • "Show me all load balancers"

  • "List load balancers with details"

  • "What load balancers are available?"

  • "Show load balancer status"

Inputs: limit, offset, include_all, all_projects. Returns: result

get_load_balancer_listenersGet Load Balancer ListenersA

Get listeners for a specific OpenStack load balancer.

Functions:

  • Lists all listeners attached to a load balancer

  • Shows listener protocols, ports, and configurations

  • Displays admin state and default pool associations

  • Provides creation and update timestamps

Use when user requests:

  • "Show listeners for load balancer [name/id]"

  • "List load balancer listeners"

  • "What ports are configured on load balancer [name]?"

  • "Show listener configuration for [lb_name]"

Inputs: lb_name_or_id (required). Returns: result

get_load_balancer_pool_membersGet Load Balancer Pool MembersA

Get members for a specific OpenStack load balancer pool.

Functions:

  • Lists all members in a specific pool

  • Shows member addresses, ports, weights, and health status

  • Displays member admin state and operational status

  • Provides monitor configuration for each member

Use when user requests:

  • "Show members for pool [name/id]"

  • "List pool members"

  • "What members are in pool [name]?"

  • "Show pool member status"

Inputs: pool_name_or_id (required). Returns: result

get_load_balancer_poolsGet Load Balancer PoolsA

Get load balancer pools, optionally filtered by listener.

Functions:

  • Lists all pools or pools for a specific listener

  • Shows pool protocols, load balancing algorithms

  • Displays members in each pool with their status

  • Provides health monitor associations

Use when user requests:

  • "Show all load balancer pools"

  • "List pools for listener [name/id]"

  • "What pools are configured on [listener_name]?"

  • "Show pool members and their status"

Inputs: listener_name_or_id. Returns: result

get_load_balancer_providersGet Load Balancer ProvidersC

Get load balancer providers.

Inputs: no named parameters. Returns: result

get_load_balancer_quotasGet Load Balancer QuotasA

Get load balancer quotas for a project or all projects.

Inputs: project_id. Returns: result

get_network_detailsGet Network DetailsA

Provides detailed information for OpenStack networks, subnets, routers, and security groups.

Functions:

  • Query configuration information for specified network or all networks

  • Check subnet configuration and IP allocation status per network

  • Collect router connection status and gateway configuration

  • Analyze security group rules and port information

Use when user requests network information, subnet details, router configuration, or network troubleshooting.

Inputs: all_projects, network_name. Returns: result

get_network_qos_policiesGet Network Qos PoliciesA

List project-owned Neutron QoS policy containers; no bandwidth rules are created.

Inputs: no named parameters. Returns: result

get_project_detailsGet Project DetailsC

Get OpenStack project details (similar to 'openstack project list/show').

Inputs: all_projects, project_name. Returns: result

get_quotaGet QuotaA

Get quota information for projects (similar to 'openstack quota show').

Each service reports limits, usage and usage_percent (percent of each limit in use). A usage value is null when it could not be determined, and usage_percent is null for unlimited (-1), zero or missing limits and for unknown usage.

Inputs: project_name. Returns: result

get_resource_monitoringGet Resource MonitoringA

Read current project allocations and visible hypervisor capacity.

Functions:

  • Report project flavor allocations, not live CPU or memory utilization

  • Collect hypervisor statistics and resource allocation

  • Separate project quota limits from visible physical capacity

  • Return null for unavailable capacity or incomplete flavor allocations

Use for current inventory and capacity planning. No historical trends or telemetry samples are collected. Physical totals and project allocations have different scopes and should not be divided into a utilization rate. For measured CPU/memory utilization, load, or trends, use get_gnocchi_measures instead; never present these allocations as usage.

Inputs: no named parameters. Returns: result

get_role_assignmentsGet Role AssignmentsA

Get role assignments for the current project.

Functions:

  • Query role assignments for users and groups

  • Display project-level and domain-level permissions

  • Show scope of role assignments

  • Provide comprehensive access control information

Use when user requests permission information, access control queries, or security auditing.

Inputs: no named parameters. Returns: result

get_routersGet RoutersB

Get list of routers with their configuration.

Functions:

  • Query routers and their external gateway configurations

  • Display router interfaces and connected networks

  • Show routing table entries and static routes

  • Provide comprehensive network routing information

Use when user requests router information, network connectivity queries, or routing configuration.

Inputs: all_projects. Returns: result

get_secret_aclGet Secret AclA

Show the read ACL of a Barbican secret or container.

The ACL lists users outside the owning project allowed to read it and whether project-wide access (project-access) is enabled.

Inputs: name_or_ref (required), target_type. Returns: result

get_secret_containersGet Secret ContainersB

List or show Barbican secret containers of the current project.

A container groups secret hrefs, e.g. a certificate container with certificate, private_key and intermediates entries. Payloads are never returned.

Inputs: name, limit. Returns: result

get_secret_ordersGet Secret OrdersA

List or show Barbican key-generation orders of the current project.

An ACTIVE order points to the generated secret (key orders) or container (asymmetric orders) through secret_ref or container_ref.

Inputs: limit, order_id. Returns: result

get_secretsGet SecretsA

List or show Barbican secrets of the current project (metadata only).

Never returns a secret payload; payload retrieval is intentionally not provided so key material cannot reach the LLM. Use the secret_ref from this tool as a reference, for example in set_load_balancer_listener.

Inputs: name, limit, secret_type. Returns: result

get_secret_storesGet Secret StoresA

List Barbican secret store backends. Only clouds that enable multiple secret store backends serve this API; others return an error.

Inputs: no named parameters. Returns: result

get_security_groupsGet Security GroupsA

Get list of security groups with their rules.

Functions:

  • Query security groups and their rule configurations

  • Display ingress and egress rules with protocols and ports

  • Show remote IP prefixes and security group references

  • Provide comprehensive network security information

Use when user requests security group information, firewall rules, or network security queries.

Inputs: all_projects. Returns: result

get_server_eventsGet Server EventsA

Get recent events for a server by name or UUID.

Pass either value using instance_name, for example get_server_events(instance_name=""). There is no server_id parameter; do not use server_id or instance_id as argument names.

Inputs: instance_name (required), limit, include_event_details. Returns: result

get_server_groupsGet Server GroupsC

List all server groups with their details

Inputs: all_projects. Returns: result

get_server_volumesGet Server VolumesC

Get all volumes attached to a specific server

Inputs: instance_name (required). Returns: result

get_service_statusGet Service StatusA

Provides status and health check information for each OpenStack service.

Functions:

  • Check active status of all OpenStack services

  • Verify API endpoint responsiveness for each service

  • Collect detailed status and version information per service

  • Detect and report service failures or error conditions

Use when user requests service status, API status, health checks, or service troubleshooting.

Inputs: no named parameters. Returns: result

get_usage_statisticsGet Usage StatisticsA

Get current-project Nova allocation-hours and separate current snapshots.

Functions:

  • Show project usage statistics over a specified time period

  • Display servers, RAM MB-Hours, CPU Hours, and Disk GB-Hours

  • Provide detailed server usage breakdown when available

  • Keep current compute/network/storage snapshots separate from period data

Use for project usage reports. Period data comes from Nova simple tenant usage. It measures allocation-hours, not live utilization or monetary charges. For measured CPU/memory utilization or trends, use get_gnocchi_measures. Missing or denied usage API returns failure without synthetic fallback.

Inputs: end_date, start_date. Returns: result

get_user_listGet User ListA

Get list of OpenStack users in the current domain.

Functions:

  • Query user accounts and their basic information

  • Display user status (enabled/disabled)

  • Show user email and domain information

  • Provide user creation and modification timestamps

Use when user requests user management information, identity queries, or user administration tasks.

Inputs: no named parameters. Returns: result

get_volume_backupsGet Volume BackupsB

List Cinder backups visible in the current project.

Inputs: all_projects. Returns: result

get_volume_groupsGet Volume GroupsA

List current-project Cinder generic groups. Requires API microversion >= 3.13.

Inputs: all_projects. Returns: result

get_volume_listGet Volume ListA

Get list of all volumes with detailed information.

Functions:

  • List all volumes in the project

  • Show volume status, size, and type information

  • Display attachment information for volumes

  • Provide detailed metadata for each volume

Use when user requests volume listing, volume information, or storage overview.

Inputs: all_projects. Returns: result

get_volume_qosGet Volume QosA

List Cinder QoS specifications, or show one specification's volume type associations by name or ID. Cloud policy may require admin rights.

Inputs: qos_name. Returns: result

get_volume_snapshotsGet Volume SnapshotsA

Get list of volume snapshots.

Functions:

  • Query volume snapshots and their status

  • Display source volume information

  • Show snapshot creation and modification dates

  • Provide snapshot size and usage information

Use when user requests snapshot information, backup queries, or volume restoration planning.

Inputs: all_projects. Returns: result

get_volume_transfersGet Volume TransfersA

List current-project Cinder volume transfer requests without authorization keys.

Inputs: no named parameters. Returns: result

get_volume_typesGet Volume TypesA

Get list of volume types with their specifications.

Functions:

  • Query volume types and their capabilities

  • Display extra specifications and backend configurations

  • Show public/private volume type settings

  • Provide storage backend information

Use when user requests volume type information, storage backend queries, or volume creation planning.

Inputs: no named parameters. Returns: result

search_instancesSearch InstancesB

Search for OpenStack instances based on various criteria with efficient pagination.

Functions:

  • Search instances by name, status, host, flavor, image, or availability zone

  • Support partial matching with configurable case sensitivity

  • Return detailed information for matching instances with pagination

  • Optimized for large-scale environments with intelligent filtering

Inputs: search_term (required), limit, offset, search_in, +2 more. Returns: result

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    C2.8/5.0

    Scored across 61 tools

    Disambiguation2/5

    The instance tools overlap heavily: get_instance is explicitly a unified replacement for get_instance_details, get_instance_by_name, get_instances_by_status, and search_instances, yet all of those legacy tools remain exposed. Other areas are better separated, but the retained redundant instance tools create multiple unclear boundaries for an agent.

    Naming Consistency4/5

    Almost all tools use a predictable get_snake_case pattern, with consistent resource grouping such as get_load_balancer_* and get_volume_*. The main deviation is search_instances, and some names awkwardly append list/detail/list, but overall naming is readable and mostly consistent.

    Tool Count1/5

    With 61 tools, the surface is far beyond the typical well-scoped range and well into the 50+ extreme-mismatch category. Granular read-only queries for load balancer subresources, Gnocchi telemetry, Barbican secrets, and many OpenStack services make the toolset unwieldy for an agent.

    Completeness1/5

    The tool surface is almost entirely read-only get/search operations, with no create, update, delete, or lifecycle action tools for instances, networks, volumes, load balancers, Heat stacks, secrets, keypairs, or users. For an OpenStack ops server, this is a severe gap that prevents most operational workflows.

    Maintenance

    ActivityActive
    ResponsivenessLimited data

    Related MCP Connectors

    Related MCP Servers

    • F
      license
      Not graded
      quality
      D
      maintenance
      An MCP server that enables interaction with multiple Kubernetes clusters simultaneously, providing comprehensive tools for cluster management, resource operations, and diagnostics across different environments.
      -
    • A
      license
      B
      quality
      D
      maintenance
      An MCP server for Proxmox VE that enables read-only cluster inspection, VM/container lifecycle operations, snapshots, migration, and provisioning with safe confirmation gates.
      28
      MIT