# UpCloud MCP for AI Agents AI Agent Connect > UpCloud MCP lets you manage your high-performance cloud infrastructure through an AI agent. You can deploy instances, monitor billing, scale storage, and manage networking across global zones without leaving your terminal or IDE. It gives your agent the ability to act as a cloud architect, handling everything from Kubernetes clusters to firewall rules. ## Overview - **Category:** developer-tools - **Price:** Free - **Endpoint:** https://edge.vinkius.com/vk_preview_viFUdZra7WhXHiFpgewP0T6ATKdd56BwgIJ8IVti/ai-agent-connect - **Tags:** cloud-servers, infrastructure-management, server-provisioning, cloud-storage, resource-monitoring, billing-management ## Description Imagine you're in the middle of a deployment and need to spin up three more instances across different regions. Usually, that means opening a browser, navigating the UpCloud dashboard, and clicking through several menus. With this Connector, you just tell your agent what you need. It handles the heavy lifting of checking zone availability, creating the machines, and verifying the status. It's about moving from manual clicking to natural language commands. If you're managing complex storage needs, you can ask your agent to clone or resize volumes on the fly. It also keeps a close eye on the money side of things. You can ask for a monthly billing summary or check current resource prices in your local currency to keep your budget on track. Because Vinkius makes it easy to connect these tools, you can treat your AI client like a dedicated DevOps assistant that knows your infrastructure inside and out. Instead of hunting for IP addresses or audit logs in different tabs, your agent pulls that data instantly. It turns cloud management from a series of tedious navigation steps into a direct conversation. Think about the time saved when you can query your entire fleet's health with one sentence. You don't have to worry about missing a status change or overlooking a specific node that's struggling. This Connector brings that visibility directly into your chat. It handles the granular details like updating PTR records, managing load balancers, and configuring SDN networks so you can focus on the actual architecture. Whether you're scaling for a traffic spike or just cleaning up old resources, your agent handles the execution. It takes the friction out of cloud operations, making it feel like you have a dedicated engineer sitting right next to you. ## Tools ### create_router Create a router. Use this to manage traffic flow within your private networks. ### update_network Modify network details. This lets you change the configuration of your existing SDN networks. ### update_storage Modify or resize storage. Use this to increase the size of a storage volume on the fly. ### list_zones List available zones. This helps you see which geographic regions are available for deployment. ### create_network Create a new SDN private network. This sets up the foundation for your private cloud connectivity. ### list_databases List managed database services. This gives you a quick overview of all your active database instances. ### delete_server Delete a machine. This allows you to quickly decommission old instances to save on costs. ### export_audit_logs Export account audit logs. Use this to pull logs for security reviews or compliance audits. ### list_firewall_rules List firewall rules for a machine. This helps you see exactly what traffic is allowed into your instances. ### assign_ip Assign a new IP address. This lets you attach a new IP to a machine or network resource. ### list_audit_logs List account audit logs. Use this to see a history of actions taken within your account. ### backup_storage Create a storage backup. Use this to create a point-in-time snapshot of your storage data. ### get_billing_summary Get your monthly billing summary. This helps you keep track of your cloud spend without digging through invoices. ### clone_storage Clone an existing storage resource. Use this to quickly replicate data for testing or migration. ### create_database Create a managed database instance. This lets your agent set up your data layer in seconds. ### create_firewall_rule Create a firewall rule for a machine. You can quickly secure your instances by defining new rules. ### create_kubernetes_cluster Create a Managed Kubernetes cluster. This makes it easy to spin up containerized environments on demand. ### create_load_balancer Create a managed load balancer. Use this to distribute traffic across your machine fleet. ### create_object_storage Create a Managed Object Storage service. This is perfect for handling unstructured data at scale. ### create_server Create a new machine. This is the primary tool for deploying new compute resources. ### create_storage Create a new storage. Use this to provision block storage for your machines. ### create_api_token Create a new API token. This lets you manage access for other automated scripts or tools. ### list_database_types List available database types and plans. Use this to compare different database options for your project. ### get_server Get detailed machine information. Use this to check the specific specs and status of a single machine. ### get_host Get host details. This provides information about the physical hardware where your machines live. ### list_hosts List available hosts. This helps you see which physical machines are available in your region. ### import_storage Import data to storage. This makes it easy to move existing data into your UpCloud storage. ### list_ips List all IP addresses. Use this to see all the public and private IPs currently assigned to your account. ### get_kubernetes_kubeconfig Get Kubernetes cluster credentials (kubeconfig). Use this to quickly get the files you need to connect to your cluster. ### list_load_balancers List managed load balancer services. Use this to see how your traffic is being distributed. ### list_networks List all SDN private networks. This shows you all the private network segments you've created. ### list_servers List all machines. This gives you a full inventory of every active instance in your account. ### stop_server Stop a machine. This lets you turn off machines to save on costs when they aren't needed. ### list_kubernetes_clusters List Managed Kubernetes (UKS) clusters. This gives you a bird's eye view of all your managed Kubernetes environments. ### list_object_storages List Managed Object Storage services. Use this to see all your available object storage buckets. ### list_prices List resource prices. This helps you see the current cost of different resources in your currency. ### release_ip Release an IP address. Use this to free up IP addresses that you are no longer using. ### restart_server Restart a machine. This lets you reboot a machine without needing to log into it first. ### restore_storage Restore storage from backup. Use this to recover data from a previous backup point. ### list_routers List routers. This shows you all the routers currently configured in your network. ### start_server Start a machine. Use this to power on a machine that is currently in a stopped state. ### list_storages List all accessible storages. This gives you a quick look at all your storage volumes. ### list_api_tokens List API tokens. Use this to manage the security tokens used for your account's API access. ### update_ip Modify PTR record or floating IP attachment. Use this to update your IP settings or move floating IPs. ### update_server Modify machine configuration. Use this to change the specs or settings of an existing machine. ### get_account Get UpCloud account information. This provides a summary of your current account limits and status. ## Prompt Examples **Prompt:** ``` Can you show me the status of my machines and tell me if we're over our credit limit? ``` **Response:** ``` Here is the current status of your UpCloud fleet: | Machine Name | Status | IP Address | | :--- | :--- | :--- | | web-prod-01 | Running | 192.168.1.10 | | db-master | Running | 192.168.1.11 | | dev-test | Stopped | 192.168.1.12 | **Account Summary:** - **Remaining Credits:** $42.50 - **Monthly Spend:** $120.00 - **Limit:** 20 concurrent machines (Current: 3) ``` **Prompt:** ``` I need to set up a new private network and a router for our new staging environment. ``` **Response:** ``` I've initiated the setup for your staging environment. I'm creating a new SDN private network now, followed by a dedicated router. I'll let you know as soon as both are ready for you to assign IPs to your staging machines. ``` **Prompt:** ``` How much does it cost to add a new object storage service in our region? ``` **Response:** ``` I've pulled the current pricing for your account. For a Managed Object Storage service in your primary zone: - **Standard Tier:** $0.05 per GB/month - **High Performance:** $0.12 per GB/month - **Data Transfer:** $0.01 per GB Would you like me to create one of these for you? ``` ## Capabilities ### Provision cloud instances Deploy new machines across different global zones using natural language. ### Manage storage volumes Create, clone, and resize storage resources on demand. ### Monitor cloud spending Get monthly billing summaries and real-time resource prices. ### Configure networking Create SDN private networks, routers, and load balancers. ### Manage Kubernetes clusters Provision and retrieve credentials for managed Kubernetes instances. ### Control firewall rules List and create security rules for your existing machines. ## Use Cases ### Rapid environment provisioning A developer needs to spin up a test environment with a database and a load balancer. They ask the agent to create a machine, database, and load balancer in the US East zone, and the agent uses create_server, create_database, and create_load_balancer to finish the task. ### Cloud spend monitoring A finance manager wants to see if they're over budget. They ask the agent what the monthly spend is and what the prices for new machines are, and the agent uses get_billing_summary and list_prices to provide a clear breakdown. ### On-the-fly storage scaling An admin needs to move a storage volume to a different host or resize it. They tell the agent to resize the main storage volume to 500GB, and the agent calls update_storage to modify the volume size instantly. ### Security audit compliance A security officer requires a list of all firewall rules. They ask the agent to list all firewall rules for the production machine, and the agent uses list_firewall_rules to pull the data for the report. ## Benefits - Stop manually clicking through dashboards to find machine statuses. You can use list_servers and get_server to get instant updates on your fleet. - Keep your cloud spending in check with real-time data. Use list_prices and get_billing_summary to see what you're spending without opening a spreadsheet. - Provision complex networking faster. You can use create_network, create_router, and create_load_balancer to set up your infrastructure in one go. - Scale your storage on demand without the headache. Use create_storage, update_storage, and backup_storage to manage your data volumes easily. - Simplify Kubernetes management. Use create_kubernetes_cluster and get_kubernetes_kubeconfig to get your clusters running and connected quickly. - Manage security rules with natural language. Use create_firewall_rule and list_firewall_rules to audit and update your machine access points. ## How It Works The bottom line is you get a hands-free way to manage your cloud infrastructure using only natural language. 1. Subscribe to the UpCloud MCP on Vinkius. 2. Provide your UpCloud API credentials in your AI client settings. 3. Ask your agent to perform tasks like listing machines or checking your billing summary. ## Frequently Asked Questions **Can the UpCloud MCP manage my billing?** Yes, it can pull your monthly billing summaries and list current resource prices so you can stay on top of your cloud spend without logging into the dashboard. **Does the UpCloud MCP work with Kubernetes?** Yes, it allows your agent to create managed Kubernetes clusters and retrieve the necessary kubeconfig credentials to get your pods running. **Can I use the UpCloud MCP to scale my storage?** Absolutely. You can ask your agent to create new storage volumes, resize existing ones, or even restore data from a previous backup. **How do I connect my UpCloud account to my AI agent?** You just need to subscribe to the Connector on Vinkius and provide your API credentials. From there, your agent can handle everything from machine restarts to firewall updates. **Can the UpCloud MCP manage my firewall rules?** Yes, it can list all existing firewall rules for your machines and create new ones to secure your infrastructure. **Is this Connector good for monitoring my cloud costs?** It's perfect for that. You can ask for a billing summary at any time to see exactly what you've spent and what your remaining credits are. **Can I check my current account balance and resource limits?** Yes! Use the `get_account` tool to retrieve your current credits and resource limits directly from your UpCloud account. **How do I see which global locations are available for deployment?** Simply ask the agent to run the `list_zones` action. It will provide a complete list of physical sites where you can deploy your infrastructure. **Is it possible to restart a server using its ID?** Yes. By providing the server's UUID to the `restart_server` tool, your AI agent can trigger a reboot of that specific instance immediately.