# Wasabi MCP

> Wasabi MCP connects your AI agent directly to Wasabi Hot Cloud Storage. It lets you manage storage buckets, check object versions, and audit file access lists using natural conversation. Control where your data lives, list files within any bucket, or delete incomplete uploads—all without navigating a complex cloud console.

## Overview
- **Category:** cloud-infrastructure
- **Price:** Free
- **Tags:** s3-compatible, object-storage, data-residency, bucket-management, cloud-backup, data-archiving

## Description

You can use this MCP to take full control of all your Wasabi assets through chat. Instead of clicking through confusing storage consoles, you simply tell your AI agent what you need done. You can check which physical region your data is stored in, verify if versioning is active on a bucket for protection against accidental deletions, or even find out exactly who has permissions to view specific files by checking the Access Control List (ACL). If you’re used to managing cloud assets via dedicated scripting tools, this MCP offers that control but wrapped in natural conversation. When you connect through Vinkius, your AI agent becomes a hands-on administrator for your entire cloud storage setup. You can also manage containers themselves—create new buckets or permanently remove old ones—and run cleanup tasks to delete those 'fractured' file uploads taking up space.

## Tools

### create_storage_bucket
Creates a new, high-availability storage container in your configured Wasabi region.

### delete_storage_bucket
Permanently removes an empty storage bucket from your account. Note: This action cannot be undone.

### delete_bucket_object
Irreversibly deletes a single file from a specified container.

### enable_bucket_versioning
Turns on object versioning for a bucket, which keeps copies of files when they change or are deleted.

### get_bucket_datacenter_location
Retrieves the physical geographic location where an entire storage bucket is hosted.

### get_object_access_control
Pulls the access control list (ACL) for a specific file to show who has permissions.

### get_bucket_versioning_status
Checks if object versioning is currently turned on or off for your bucket.

### list_storage_buckets
Lists all the storage buckets that are visible to your authenticated user account.

### list_bucket_objects
Returns a list of files, showing their keys, sizes, and last modified dates within a bucket.

### list_pending_multipart_uploads
Lists incomplete multipart uploads that are consuming storage space in your bucket.

## Prompt Examples

**Prompt:** 
```
List all my storage buckets in Wasabi.
```

**Response:** 
```
I found 3 buckets in your account: 'backups-2026' (Created: 2026-01-15), 'user-data-prod' (Created: 2025-11-20), and 'media-assets-global' (Created: 2026-02-10). Would you like to see the contents of any of these?
```

**Prompt:** 
```
What files are inside the 'backups-2026' bucket?
```

**Response:** 
```
Searching 'backups-2026'… I found 5 objects: 'db-dump-jan.sql' (4.2 GB), 'logs-archive.zip' (850 MB), 'config-backup.json' (12 KB), and 2 others. I can pull the ACL or delete any of these for you.
```

**Prompt:** 
```
Is versioning enabled for my 'user-data-prod' bucket?
```

**Response:** 
```
Checking status… No, object versioning is currently suspended for 'user-data-prod'. Would you like me to enable it now to protect your files from accidental overwrites?
```

## Capabilities

### Manage Storage Containers
Create, list, and delete high-availability storage buckets in your account.

### Audit File Permissions
Retrieve the access control list (ACL) for any file to verify who has permission to view or edit it.

### Verify Data Location
Check the physical geographic region where a specific storage bucket is hosted, which is crucial for compliance.

### Track Object History
Activate or check object versioning on a bucket to protect against accidental overwrites and deletions.

### Browse Files in Buckets
List all files (objects) within a specific container, including their size and when they were last modified.

### Clean Up Uploads
Identify and permanently delete incomplete multipart uploads that are wasting storage space.

## Use Cases

### Auditing a New Project’s Data Residency
A Cloud Architect needs to confirm if all user data for a new EU client is physically stored in the European region. Instead of navigating compliance dashboards, they ask their agent to get_bucket_datacenter_location on the project bucket and verify the output matches the required geography.

### Recovering from an Accidental Deletion
A Data Engineer accidentally overwrites a critical file. They immediately check the get_bucket_versioning_status and, finding it off, ask their agent to run enable_bucket_versioning before attempting any recovery.

### Onboarding a New Team Member
A DevOps Professional needs to grant read-only access to a new team member for the 'user-logs' bucket. They use get_object_access_control on key files and then modify the permissions through their agent, ensuring least privilege.

### Cleaning Up Test Environments
An IT Admin notices that old test data is accumulating and wasting money. They ask their agent to list_pending_multipart_uploads across several buckets, identify the junk uploads, and permanently delete them using delete_bucket_object.

## Benefits

- Compliance checks are instant. Instead of manually checking the console for data residency, simply ask your agent to run get_bucket_datacenter_location and confirm where your data sits.
- You'll never lose a file again. Use enable_bucket_versioning to activate object versioning on critical buckets, protecting against accidental overwrites or deletions across your dataset.
- Know exactly what you're deleting. Before running delete_storage_bucket, use list_storage_buckets and list_bucket_objects to see the contents and verify which files are safe to remove.
- Save time auditing permissions. Running get_object_access_control on a file instantly shows who can access it, eliminating manual security checks for sensitive data.
- Stay organized with cleanup tasks. Use list_pending_multipart_uploads to find those 'orphaned' uploads that take up space and need permanent deletion via delete_bucket_object.

## How It Works

The bottom line is you manage complex cloud operations by talking to your AI agent instead of clicking through a console.

1. Subscribe to this MCP and provide your Wasabi Access Key, Secret Key, and Region credentials.
2. Connect the service to any compatible AI client, like Cursor or Claude.
3. Ask your agent natural language questions, such as 'List all buckets' or 'Check versioning on my main data bucket.'

## Frequently Asked Questions

**How do I use the Wasabi MCP to check my data residency?**
You run get_bucket_datacenter_location on the specific bucket name. This tells you the exact physical geographic region where your stored data is hosted, which is essential for compliance.

**Can Wasabi MCP help me delete files from a bucket?**
Yes. You use delete_bucket_object to permanently remove a specific file, or you can run list_pending_multipart_uploads and then delete the whole incomplete upload.

**Is there a way to see all my buckets with Wasabi MCP?**
You simply call list_storage_buckets. This command returns a complete inventory of every bucket visible to your authenticated user account.

**Do I need to worry about versioning when using Wasabi MCP?**
It's wise to check the status first by calling get_bucket_versioning_status. If it’s off and you work with critical files, run enable_bucket_versioning immediately.

**How do I list all the files inside a container?**
You use list_bucket_objects, specifying the name of the bucket. This returns key information like file names, sizes, and when they were last modified.