# UpCloud MCP > UpCloud MCP lets your agent manage high-performance cloud infrastructure using natural language commands. From deploying and modifying servers across global zones to monitoring resource costs and handling billing summaries, you get total control of your cloud environment directly from any compatible client. ## Overview - **Category:** developer-tools - **Price:** Free - **Tags:** cloud-servers, infrastructure-management, server-provisioning, cloud-storage, resource-monitoring, billing-management ## Description Need to juggle server status checks, storage provisioning, and networking details across dozens of browser tabs? This MCP connects your UpCloud account to any AI agent, letting you manage complex infrastructure through conversation. Instead of writing boilerplate commands or clicking through multiple dashboards, you just ask your client what you need done. Your agent acts like a dedicated cloud architect sitting next to you; it can list all available zones, create managed databases, and even write firewall rules for specific servers—all without leaving your IDE. By connecting this MCP via Vinkius, your AI gains the power to act as a comprehensive DevOps assistant right where you’re already working. You handle the strategy; your agent handles the execution. ## Tools ### get_account Retrieves your current UpCloud account information. ### assign_ip Assigns a new IP address to an existing resource. ### list_audit_logs Lists all historical actions recorded in your account audit logs. ### backup_storage Creates a complete backup copy of a specified storage resource. ### get_billing_summary Fetches a detailed summary of your monthly billing statement. ### clone_storage Creates an exact copy of an existing storage resource. ### create_database Provisions and sets up a new managed database instance for your application. ### create_firewall_rule Creates specific rules to control network traffic entering or leaving a server. ### create_kubernetes_cluster Deploys and provisions a new Managed Kubernetes cluster (UKS). ### create_load_balancer Sets up a managed load balancer to distribute traffic across multiple servers. ### create_network Builds a new Software Defined Network (SDN) private network boundary. ### create_object_storage Creates a Managed Object Storage service for large, unstructured data files. ### create_router Provisions and configures a new network router device. ### create_server Creates a brand-new cloud compute server instance. ### create_storage Initializes and creates a new dedicated storage volume. ### create_api_token Generates a new, secure API token for programmatic access to your account. ### list_database_types Shows all available database types and the plans associated with them. ### list_databases Retrieves a list of managed database services currently running in your account. ### delete_server Delete a server ### export_audit_logs Export account audit logs ### list_firewall_rules List firewall rules for a server ### get_server Gets full, detailed specifications for a single server instance. ### get_host Get host details ### list_hosts Lists all physical hosts available within the cloud infrastructure zones. ### import_storage Transfers existing data from an external source into a managed storage volume. ### list_ips Retrieves a list of all IP addresses associated with your account. ### get_kubernetes_kubeconfig Downloads the necessary credentials (kubeconfig) to connect to your managed cluster. ### list_kubernetes_clusters Lists all Managed Kubernetes clusters currently deployed in your account. ### list_load_balancers Retrieves a list of active managed load balancer services. ### list_networks Lists all Software Defined Private Networks you have set up. ### list_object_storages Retrieves a list of managed object storage services. ### list_prices Fetches the current cost price for various cloud resources in your account's currency. ### release_ip Release an IP address ### restart_server Restart a server ### restore_storage Restore storage from backup ### list_routers List routers ### list_servers List all servers ### start_server Start a server ### stop_server Stop a server ### list_storages List all accessible storages ### list_api_tokens List API tokens ### update_ip Modify PTR record or floating IP attachment ### update_network Modify network details ### update_server Modify server configuration ### update_storage Modify or resize storage ### list_zones List available zones ## Prompt Examples **Prompt:** ``` Show my UpCloud account information and credits. ``` **Response:** ``` I've retrieved your account details. You currently have $150.00 in credits remaining, and your resource limits allow for up to 20 concurrent servers. Would you like to see your billing summary for this month? ``` **Prompt:** ``` List all my active servers on UpCloud. ``` **Response:** ``` Fetching your server list... I found 3 servers: 'web-prod-01' (Running), 'db-master' (Running), and 'test-bench' (Stopped). Which one would you like to manage? ``` **Prompt:** ``` Restart the server with UUID 00264663-890e-473c-9189-9e87483660c2. ``` **Response:** ``` Initiating restart for server 00264663-890e-473c-9189-9e87483660c2... The command has been sent successfully. The server should be back online in a few moments. ``` ## Capabilities ### Manage Server Lifecycle You can list, start, stop, restart, and delete cloud servers across any global region. ### Control Storage Resources This MCP lets you create new storage instances, modify existing ones, clone data, or restore services from backups. ### Configure Networking Services You can list networks, assign IP addresses, update network details, and set up managed load balancers or private networks. ### Handle Account & Billing Insights The agent pulls your account information, lists resource prices in your local currency, and delivers detailed monthly billing summaries. ### Build Complex Infrastructure You can provision specialized services like managed Kubernetes clusters, databases, or object storage buckets. ## Use Cases ### The Emergency Server Check A SRE notices an application is running slow and needs root cause analysis. They ask their agent, 'What's wrong with the web server?' The agent runs `get_server` to check its status, then calls `list_audit_logs` to see recent access patterns, providing a complete diagnosis immediately. ### Planning Multi-Region Expansion A Cloud Architect needs to build a new, highly available deployment across three regions. They ask the agent to 'List all available zones and check their capacity.' The agent uses `list_zones` and `get_host`, giving them the data needed for accurate planning. ### Cost Optimization Review A Finance Ops manager receives a vague bill. They ask their agent, 'Show me exactly how much I spent on networking this month.' The agent responds by calling `get_billing_summary` and `list_prices`, pinpointing the exact cost drivers. ### Setting up Microservices A DevOps engineer needs to deploy a new service cluster. They tell their agent, 'Set up a private network, create a load balancer, and secure it with rules.' The agent executes `create_network`, then `create_load_balancer`, followed by multiple calls to `create_firewall_rule`. ## Benefits - Avoid the pain of manual monitoring. Instead of checking server status in a dashboard or running multiple shell commands to check logs, you can ask your agent for an audit log report instantly using `list_audit_logs`. - Save time on capacity planning. Need to know if there's room to grow? Use `list_zones` and `get_host` to query available physical hosts and zones before deploying a new application stack. - Maintain budget control effortlessly. Get immediate visibility into costs by calling `list_prices` or checking the full picture with `get_billing_summary`, ensuring you never overspend on cloud resources. - Simplify deployment workflows. Provisioning a complex setup—like a load balancer and associated network rules—becomes simple when your agent executes multiple steps using tools like `create_load_balancer` and `create_firewall_rule` in one request. - Speed up data management. If you need to move or secure data, you can use `backup_storage` or `restore_storage` without navigating through complex file system interfaces. Just tell your agent what needs backing up. - Rapidly scale resources. When a service fails or grows rapidly, you don't have to manually create everything from scratch. You simply ask the agent to deploy new components like a managed database instance using `create_database`. ## How It Works The bottom line is that you bypass the command line and the web UI; your AI client handles all the API communication for you. 1. Subscribe to this MCP and enter your specific UpCloud API credentials. 2. Connect the credential flow to any compatible AI client (like Cursor or Claude). 3. Ask your agent a natural language question, like 'What are my current billing limits?' The agent executes the necessary calls and gives you a direct answer. ## Frequently Asked Questions **How does the UpCloud MCP handle billing summaries?** The agent retrieves a detailed monthly summary using the `get_billing_summary` tool. This gives you an accurate breakdown of your resource usage and costs for the period. **Can I use the UpCloud MCP to manage my servers?** Yes, you can start, stop, restart, or delete any server instance using tools like `start_server`, `stop_server`, and `delete_server`. This gives full lifecycle control. **What if I need to change a network setting?** You use the `update_network` tool. You just describe the modification you want, and the agent applies it correctly across your SDN private networks. **Does UpCloud MCP help with IP addresses?** Absolutely. The agent lets you list all IPs using `list_ips`, assign a new one with `assign_ip`, or release an old address via `release_ip`.