# Civo MCP for AI Agents AI Agent Connect > Civo MCP for AI Agents. Manage Civo cloud infrastructure directly from your AI client. Provision K3s clusters, control compute instances, and handle networking or storage without switching tabs. It gives your agent the ability to execute cloud operations on Civo. ## Overview - **Category:** developer-tools - **Price:** Free - **Endpoint:** https://edge.vinkius.com/vk_preview_a7IduwFKBKjmrz2yKnQEZJgs6RrkxvYzFXIeRgs0/ai-agent-connect - **Tags:** kubernetes, k3s, cloud-computing, infrastructure-as-code, vps ## Description This Connector connects your Civo account to your AI client so you can handle cloud infrastructure through plain conversation. Instead of jumping between tabs to find the right dashboard or wrestling with complex CLI commands, you just tell your agent what you need to do. You can spin up new K3s clusters, launch compute instances, or adjust your firewall rules without ever leaving your current workspace. It handles the tedious parts of cloud management, like creating private networks, managing DNS records, or resizing your virtual machines on the fly. You get to focus on the actual work while your agent takes care of the provisioning and maintenance. For example, if you need to scale up a web server, you just ask to resize the instance. If you need to secure a new environment, you can have your agent set up the firewall and private network in one go. It makes your cloud environment feel like an extension of your chat interface. Since Vinkius hosts this Connector, you can get it running in minutes and start managing your resources immediately. It's about moving faster by removing the friction between your ideas and your actual infrastructure. You'll spend less time worrying about how to provision a node and more time actually shipping your code. ## Tools ### create_domain Create a DNS domain. Use this to start managing your custom web addresses. ### attach_volume Attach a volume to an instance. Connect a storage disk to a specific virtual machine. ### create_instance Create a new compute instance. Launch virtual machines to run your applications. ### create_webhook Create a webhook. Connect Civo events to your external services. ### create_cluster Create a new Kubernetes cluster. This lets you set up K3s environments quickly. ### create_domain_record Create a DNS record. Point your domain names to specific IP addresses. ### create_firewall_rule Create a firewall rule. This helps you define specific traffic permissions for your network. ### create_firewall Create a firewall. Set up a dedicated security perimeter for your cloud resources. ### create_network Create a private network. Build isolated environments for your internal services. ### create_team Create a team. Organize your account users into specific groups. ### create_volume Create a volume. Provision block storage for your data needs. ### detach_volume Detach a volume. Remove a storage disk from a running instance. ### get_charges Get hourly usage report for chargeable resources. Track your spending in real time. ### get_quota Get account quota and usage. See how much of your resource limit you have left. ### list_clusters List Kubernetes clusters. See all your active K3s environments at once. ### list_disk_images List disk images. Browse the available OS images for your instances. ### list_domains List DNS domains. View all the domains currently managed in your account. ### list_firewall_rules List rules for a firewall. Check the specific permissions for your security groups. ### list_networks List private networks. See all your existing private network segments. ### list_regions List available regions. Find out where you can deploy your infrastructure. ### list_sizes List available instance sizes. Check the hardware specs for your compute options. ### reboot_instance Hard reboot an instance. Force a restart on a virtual machine that is unresponsive. ### recycle_cluster_node Recycle a node in a Kubernetes cluster. Refresh a K3s node to fix configuration issues. ### resize_instance Upgrade or resize an instance. Change the hardware specs of your running VM. ### retag_instance Retag an instance. Update the metadata labels on your compute resources. ### soft_reboot_instance Soft reboot an instance. Perform a graceful restart of your virtual machine. ### start_instance Start an instance. Power on your compute resources. ### stop_instance Stop an instance. Shut down your compute resources to save on costs. ### test_webhook Test a webhook. Verify that your Civo webhooks are sending data correctly. ### update_team_member_status Update team member status. Keep track of your internal team's availability. ### upload_ssh_key Upload an SSH key. Add new keys for secure remote access to your instances. ### add_team_member Add a member to a team. Grant new users access to specific group resources. ### list_ssh_keys List SSH keys. View the public keys currently authorized in your account. ## Prompt Examples **Prompt:** ``` List all my Kubernetes clusters in the lon1 region. ``` **Response:** ``` I've retrieved your clusters in lon1. You have one active cluster: **production-k3s** (ID: 8f2d...) with 3 nodes currently running. | Cluster Name | ID | Nodes | Status | | :--- | :--- | :--- | :--- | | production-k3s | 8f2d... | 3 | Active | ``` **Prompt:** ``` Create a new g3.xsmall instance named 'web-server' in my default network. ``` **Response:** ``` Starting the provisioning process for **web-server** (size: g3.xsmall). I'll use your default network ID. The instance is being created now. **Status:** Provisioning... **Instance Name:** web-server **Size:** g3.xsmall ``` **Prompt:** ``` What is my current account quota and total charges for this month? ``` **Response:** ``` Here is your current account status: * **Quota Usage:** 8/10 instances used | 24/40 CPU cores * **Estimated Charges:** $42.50 for the current billing cycle Let me know if you need a more detailed breakdown of your charges. ``` ## Capabilities ### Provision K3s clusters Create and manage Kubernetes clusters across multiple regions using natural language. ### Resize compute instances Upgrade or change the hardware specs of your running virtual machines instantly. ### Configure private networks Build and manage isolated network segments for your internal services. ### Manage DNS records Create and list domain records to point your traffic where it needs to go. ### Monitor account quotas Check your current resource limits and billing charges in real time. ### Handle firewall rules Create and list security rules to control traffic to your cloud resources. ### Manage storage volumes Attach, detach, and provision block storage for your data needs. ## Use Cases ### Scaling a production K3s cluster An engineer needs to add capacity. They ask their agent to list_clusters, identify the active one, and then use recycle_cluster_node to refresh a failing node. ### Rapid dev environment setup A developer needs a sandbox. They ask their agent to create_instance and create_network to spin up a private web server in minutes. ### Emergency firewall adjustment An SRE detects an issue. They ask their agent to list_firewall_rules and then create_firewall_rule to block a malicious IP immediately. ### DNS migration for a new app A team is launching a site. They ask their agent to create_domain and create_domain_record to point their new custom URL to the load balancer. ## Benefits - Provision K3s clusters across multiple regions instantly by asking your agent to create them, skipping the manual dashboard navigation. - Resize existing compute instances on the fly using resize_instance to handle traffic spikes without logging into the Civo console. - Manage complex networking by creating private networks and firewall rules using create_network and create_firewall through simple chat. - Keep your DNS organized by creating domain records and listing existing domains with create_domain_record and list_domains. - Monitor your cloud spending and resource limits in real time using get_charges and get_quota to stay on budget. - Handle storage needs by attaching or detaching volumes using attach_volume and detach_volume to manage your data disks. ## How It Works The bottom line is you get a conversational interface for your entire Civo cloud stack. 1. Subscribe to the Connector and grab your Civo API Key. 2. Enter the key into your AI client's configuration. 3. Command your agent to create clusters, resize VMs, or check billing. ## Frequently Asked Questions **Can I use the Civo MCP to manage my K3s clusters?** Yes, this Connector allows you to create, list, and manage K3s clusters across various regions using natural language commands. **How do I set up the Civo MCP for my cloud account?** Just subscribe to the Connector and provide your Civo API Key in your AI client's configuration. From there, your agent can start managing your resources. **Can the Civo MCP help me manage my DNS records?** Absolutely. You can use it to create new DNS domains and manage specific records like pointing your domain to an IP address. **Is the Civo MCP good for monitoring my cloud spending?** Yes, it can pull your hourly usage reports and current charges so you can keep an eye on your costs without leaving your chat interface. **Can I use the Civo MCP to resize my VPS instances?** You can use it to upgrade or resize your compute instances on the fly, making it easy to scale resources up or down as needed. **How does the Civo MCP handle firewall rules?** It allows your agent to create and list firewall rules, helping you manage security permissions for your cloud infrastructure through simple conversation. **Can I add team members to my Civo account using the Civo MCP?** Yes, the Connector includes tools to add team members and organize them into groups, making it easy to manage your account permissions. **Can I create a Kubernetes cluster in a specific region?** Yes, you can use the `create_cluster` tool and specify the `region` parameter (e.g., 'lon1' or 'nyc1') along with the cluster name and network ID. **How do I restart a stuck compute instance?** You can use the `reboot_instance` tool for a hard reboot or `soft_reboot_instance` for a graceful restart by providing the Instance ID. **Can I check my current cloud spending and limits?** Absolutely. Use the `get_charges` tool to see your current billing details and `get_quota` to check your account resource limits.