# Gridscale MCP for AI Agents AI Agent Connect > Gridscale MCP lets you manage your cloud infrastructure through natural language. Provision instances, check metrics, and handle networking or PaaS services directly from your AI client. It turns your cloud console into a conversation. ## Overview - **Category:** developer-tools - **Price:** Free - **Endpoint:** https://edge.vinkius.com/vk_preview_WionY60yQsjgHzTZj8H9U0asZQd1c7pgU3MJvADr/ai-agent-connect - **Tags:** iaas, paas, cloud-hosting, server-management, infrastructure-as-code ## Description Managing cloud infrastructure usually feels like a chore of constant context switching. You open your browser, log into the portal, find the right project, click through three layers of menus just to find a specific node ID, and then hunt for the power button. It's a lot of manual overhead for a task that should be simple. This Connector lets you skip the clicking. You can just ask your AI client to find a specific instance, check its CPU usage, or turn it off. It gives your agent a direct line to your Gridscale account, covering IaaS lifecycles to PaaS managed services like Redis and databases. If you're already using Vinkius to organize your toolset, adding this Connector makes your cloud management feel like a natural extension of your chat window. You can audit your storage, manage private networks, or pull real-time CPU metrics without ever leaving your workspace. It's about getting the infrastructure work out of the way so you can actually focus on shipping code. Instead of wrestling with complex CLI commands or hunting for hidden settings, you get a conversational interface for your entire hosting environment. You can handle tasks ranging from networking rules to volume attachments in a single thread. ## Tools ### list_storages See all storage volumes. Use this to check your available disk space and capacity. ### create_server Provision a new cloud instance instantly. Use this to scale your infrastructure up when demand hits. ### get_server_metrics Get real-time CPU and storage IOPS for a specific instance. Use it to check if your hardware is handling the current load. ### get_server_power Check if a specific instance is currently online, offline, or shutting down. This helps you verify status without opening a console. ### link_ip_to_server Connect a specific IP address to an instance. Use this to finalize networking setups quickly. ### link_storage_to_server Attach a storage volume to an instance. Note that the instance usually needs to be powered off first. ### list_deleted See a history of deleted objects in your account. This is great for tracking changes or auditing past actions. ### list_firewalls View all active firewall rules in your environment. Use it to audit security settings across your infrastructure. ### list_ips See a complete list of all IP addresses in your account. This helps you keep track of your available networking resources. ### list_iso_images See all available ISO images. Use this to find the right OS for your next deployment. ### list_locations See available datacenters and locations. Use these IDs when creating new resources in specific regions. ### list_networks See all private networks in your account. This helps you organize how your resources connect to each other. ### list_paas View all Platform Services like databases and Redis instances. Use it to manage your managed services quickly. ### list_servers See every instance in your Gridscale account. This gives you a quick overview of your entire fleet. ### list_templates See all deployment templates. This helps you find the right starting point for new instances. ### set_server_power Change the power state of a specific instance. Use it to turn resources on or off to save costs. ### shutdown_server Perform an ACPI shutdown on an instance. This is the clean way to turn off a machine. ## Prompt Examples **Prompt:** ``` Check the health of my production instance. ``` **Response:** ``` I've pulled the latest metrics for your 'Production-Web' instance. Here's the summary of the last 15 minutes: | Metric | Value | | :--- | :--- | | **CPU Usage** | 12% | | **Storage IOPS** | 450 | Everything looks stable and well within your limits. Would you like me to check any other nodes? ``` **Prompt:** ``` I need to spin up a new dev node in the Frankfurt region. ``` **Response:** ``` I'll get that started for you. First, I'll check the available locations to find the Frankfurt ID. Once I have that, I'll use it to create a new instance with your standard dev specs. Should I list the locations now? ``` **Prompt:** ``` Show me all my active firewalls and tell me if any are blocked. ``` **Response:** ``` Here are your active firewall rules: * **Rule 1**: Allow Port 80 (Web) * **Rule 2**: Allow Port 443 (HTTPS) * **Rule 3**: Block Port 22 (SSH) Currently, you have 3 rules active. All ports are configured correctly based on your current network settings. Would you like me to list your private networks as well? ``` ## Capabilities ### Provision and manage cloud instances Create new nodes, list existing ones, and toggle power states on or off. ### Access managed PaaS services List and manage platform services like databases and Redis instances. ### Configure networking and security Manage IP addresses, private networks, and firewall rules through conversation. ### Handle storage and media List storage volumes, ISO images, and deployment templates. ### Monitor hardware performance Retrieve real-time CPU and storage IOPS metrics for any node. ## Use Cases ### Emergency Instance Restart A production instance hangs. Instead of logging into the dashboard, you tell your agent to use shutdown_server and then set_server_power to bring it back up. ### Dev Environment Setup A dev needs a new test node. They ask the agent to create_server in a specific location using list_locations to find the right region. ### Security Audit A sysadmin wants to check firewall rules. They ask the agent to list_firewalls and list_networks to ensure no unauthorized ports are open. ### Capacity Planning You need to check if your disks are full. You ask the agent to list_storages and get_server_metrics to see the current IOPS and usage. ## Benefits - Stop hunting through the Gridscale console to find specific instance statuses by using list_servers and get_server_power to see everything at a glance. - Scale your infrastructure faster by using create_server to spin up new nodes during traffic spikes without manual configuration. - Audit your security posture more easily by using list_firewalls and list_networks to see exactly how your resources are connected. - Monitor hardware health in real-time with get_server_metrics to catch CPU or storage bottlenecks before they crash your app. - Manage your data layer more efficiently by using list_paas to check the status of your managed databases and Redis instances. - Organize your storage and networking by using list_storages and link_ip_to_server to keep your environment tidy and reachable. ## How It Works The bottom line is you stop clicking through dashboards and start managing your infrastructure with plain English. 1. Subscribe to the Connector and grab your Gridscale User ID and API Token. 2. Connect your credentials to your AI client via the Vinkius dashboard. 3. Ask your agent to perform tasks like 'restart the production node' or 'list my databases'. ## Frequently Asked Questions **Can I use the Gridscale MCP to restart my instances?** Yes, you can use it to change the power state of any instance in your account. Just tell your agent to turn a specific instance on or off. **Does the Gridscale MCP support managed databases?** Yes, it includes tools to list and manage your Platform Services, which covers things like managed databases and Redis. **How do I check my instance's CPU usage?** You can ask your agent to fetch the performance metrics for any specific instance. It will show you real-time data on CPU and storage IOPS. **Can I manage my networking through the Gridscale MCP?** Yes, you can list your IP addresses, view your private networks, and see all your firewall rules through the chat. **Can I create new instances using this Connector?** You can use it to provision new cloud instances instantly. Just tell your agent what name and specs you want. **Does the Gridscale MCP show me my storage volumes?** Yes, it can list all your storage volumes and show you which ones are linked to your instances. **Is there a way to see my deleted resources?** Yes, the Connector can list deleted objects, which is helpful for auditing your history or tracking old resources. **Can I check the power status of a specific server using its UUID?** Yes! Use the `get_server_power` tool with the server's UUID. The agent will return whether the server is currently powered on or off. **How do I monitor the performance of my cloud servers?** You can use the `get_server_metrics` tool. It retrieves data in 15-minute intervals for core usage and storage IOPS, allowing your AI to analyze resource consumption. **Does this integration support managed databases like MySQL or PostgreSQL?** Yes, you can list all managed Platform Services (PaaS) including MySQL, PostgreSQL, and Redis using the `list_paas` tool.