# Scaleway MCP

> Scaleway MCP manages your entire cloud infrastructure through natural language commands. Use this connector to list, create, and control virtual machines across any zone directly from your AI agent. Power up, reboot, or terminate instances without leaving your chat window; it gives you direct access to the Scaleway Instances API.

## Overview
- **Category:** developer-tools
- **Price:** Free
- **Tags:** cloud-computing, virtual-machines, bare-metal, infrastructure-as-code, server-management

## Description

This MCP lets your AI client treat your cloud account like a natural extension of conversation. You stop writing boilerplate CLI commands and start talking about what you need done with your infrastructure. Need to check if that staging environment is up? Just ask, and it pulls all the status details for every virtual machine across different zones. If you realize you forgot an entire development tier, you can tell it to create a new cluster using specific types and images. It handles provisioning and lifecycle management entirely through text.

The power of connecting your cloud resources this way means complex tasks become simple requests. By adding Scaleway to the Vinkius catalog, any compatible AI client—whether it's in your IDE or a separate chat window—can manage your entire resource portfolio. You get full control over instance status and deployment actions without ever needing to switch tools or write an API script.

## Tools

### create_instance
Builds a brand new virtual machine instance in Scaleway with specified configuration details.

### perform_instance_action
Triggers an immediate action on an existing instance, such as powering it off or rebooting it.

### list_instances
Retrieves a full list of all virtual machines currently running within a specific zone.

## Prompt Examples

**Prompt:** 
```
List all my instances in the Paris zone (fr-par-1).
```

**Response:** 
```
I've retrieved your instances in fr-par-1. You have 2 active servers: 'web-prod-01' (ID: ...213) and 'db-master' (ID: ...442). Both are currently running.
```

**Prompt:** 
```
Create a new DEV1-S instance named 'staging-app' in fr-par-1 using the Ubuntu image.
```

**Response:** 
```
I am initiating the creation of 'staging-app' (DEV1-S) in fr-par-1. The request has been sent to Scaleway, and the instance is now being provisioned.
```

**Prompt:** 
```
Reboot the server with ID 550e8400-e29b-41d4-a716-446655440000 in nl-ams-1.
```

**Response:** 
```
The reboot command has been successfully sent to the server in nl-ams-1. It should be restarting now.
```

## Capabilities

### Check all running instances
List every virtual machine across defined zones so you can audit current resources.

### Activate new machines
Create and provision brand new instances by specifying names, commercial types, and image IDs.

### Manage instance power state
Remotely cycle the power of an existing machine, including powering it on, off, or rebooting it.

### Remove old resources
Permanently terminate instances that are no longer needed for cleanup or cost control.

### Audit resource locations
Check the status of machines in specific availability zones (e.g., fr-par-1).

## Use Cases

### The weekend audit
A Cloud Architect needs to know every single resource running in the 'NL-AMS-1' zone for a compliance report. Instead of logging into the console and clicking through dozens of dashboard tabs, they ask their agent to `list_instances`. The result is an immediate, comprehensive list they can copy.

### Hotfix deployment
A DevOps Engineer realizes a production machine needs a patch immediately. They tell the agent to reboot it using `perform_instance_action` and get confirmation that the command was sent successfully, minimizing downtime.

### New staging branch setup
A Developer finishes a feature and needs an isolated testing environment. Instead of running a multi-step CLI script, they prompt their agent to `create_instance` for the new staging machine, specifying the exact type and image needed.

### Resource cleanup
A team finished a project and has several old development machines still running, incurring costs. They use the MCP to audit all resources and then systematically `perform_instance_action` (power off) or terminate them entirely.

## Benefits

- Audit your entire environment instantly. Using `list_instances` lets you check the status of every machine across multiple availability zones without running zone-by-zone commands.
- Spin up dev environments on demand. The `create_instance` tool lets developers provision new machines using simple text prompts, specifying everything from size to operating system image.
- Manage power state via chat. If a service is stuck or needs maintenance, the agent uses `perform_instance_action` to reboot or power down resources directly through conversation.
- Decommission safely and efficiently. When you know an instance isn't needed anymore, you can terminate it instantly, using the MCP to prevent resource waste.
- Stay in your workflow. You don't have to leave your IDE or chat window. This MCP brings cloud control right where you're already coding.

## How It Works

The bottom line is that your AI client runs all cloud commands using natural language, handling authentication and API calls behind the scenes.

1. Subscribe to this MCP and provide your unique Scaleway Secret Key.
2. Your AI client reads your natural language request, identifying the required action (e.g., 'Reboot web-prod-01').
3. The agent sends a structured API call through the connector, and you receive an immediate confirmation or status update on the resource's state.

## Frequently Asked Questions

**How do I list all my instances using Scaleway MCP?**
You ask your agent to list instances, specifying the zone you are interested in. The `list_instances` tool retrieves every virtual machine status and ID for that location.

**Can I use Scaleway MCP to reboot an instance?**
Yes. You can tell your agent to perform an action, like rebooting a specific machine using `perform_instance_action`. It sends the command and confirms when the request was successfully sent.

**Is Scaleway MCP only for listing servers?**
No. The MCP is fully capable of lifecycle management, allowing you not only to list machines but also to create new ones with `create_instance` or terminate old ones.

**What information does the Scaleway MCP need to connect?**
You must subscribe and provide your unique Scaleway Secret Key. This key authorizes your agent to manage resources on your behalf within the Vinkius catalog.

**Does creating an instance take time with Scaleway MCP?**
The command initiates provisioning immediately via `create_instance`. The response confirms that the request has been sent and the machine is now being provisioned by Scaleway's systems.