# Backblaze B2 MCP for AI Agents AI Agent Connect

> Backblaze B2 lets you manage your cloud storage buckets and files using your AI client. You can create buckets, delete old file versions, check for failed uploads, and manage privacy settings without jumping between tabs. It puts your object storage on autopilot by letting your agent handle the heavy lifting of data organization and maintenance.

## Overview
- **Category:** cloud-infrastructure
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_5a3X16pxhWkIfWLEFFNd17FkP9i7b4YBIqYHMeDV/ai-agent-connect
- **Tags:** s3-compatible, object-storage, file-management, data-archiving, bucket-management, cloud-backup

## Description

Backblaze B2 connects your cloud storage to your AI agent so you can manage your data architecture through plain conversation. Instead of hunting through the Backblaze console to find specific buckets or manually purging old file versions to save on costs, you just tell your agent what needs to happen. It handles the technical details of bucket creation, privacy updates, and file management. If you're trying to clean up a messy storage environment, you can ask it to find and remove specific data chunks or list all your active storage domains. You can even use it to audit your storage health by identifying stalled multipart uploads that might be eating up your resources. Vinkius makes it easy to get this connected so your agent can act as a dedicated storage admin. It's built for people who need to move fast and want their AI to handle the repetitive parts of cloud infrastructure management, from checking file hashes to organizing public assets. You can quickly toggle between public and private access for your storage domains, which is a lifesaver when you need to change permissions on the fly for production assets. It also helps you keep your storage clean by identifying files that are hidden from the main list but still taking up space on the disk. This means you can maintain a tidy storage environment without the risk of accidentally deleting active files. Whether you are auditing your object footprint for security or just trying to make sure your latest uploads didn't fail, this connection gives your agent the oversight it needs to keep things running smoothly.

## Tools

### create_bucket
This tool provisions a fresh logical Storage Bucket partition. It bootstraps essential structures before assigning automated backup syncs.

### delete_file_version
This tool irreversibly vaporizes specific absolute chunk data from disk arrays. It instantly removes the storage footprint to avoid long-term retention hoarding.

### get_file_info
This tool obtains granular checksum and headers associated with one precise B2 File. It retrieves specific file details, sizes, and hashes natively.

### hide_file
This tool marks an active B2 file as hidden leaving data for lifecycle sweep. It injects a null-marker shadowing the actual file to ensure it is ignored by lists.

### list_buckets
This tool retrieves the exact Storage Buckets existing globally on the B2 Account. It is crucial for resolving immutable String Bucket IDs for downstream operations.

### authorize_account
This tool finds your specific regional data ingress endpoints to ensure your agent talks to the right data center. It verifies and extracts Backblaze global session routing endpoints.

### delete_bucket
This tool irreversibly deletes an entirely empty Backblaze Storage Bucket. It fails intentionally if standard files or hidden object versions persist.

### list_file_names
This tool paginates primary surface-level object metadata from a specific Bucket. It examines precise file locations while avoiding hidden shadowed states.

### list_unfinished_large_files
This tool scans B2 nodes for stalled Multipart Upload chunk aggregates. It is crucial for verifying broken API pipelines from external S3 clients.

### update_bucket
This tool mutates global ACL privacy settings for a bounded Bucket. It should only be used for static asset endpoints.

## Prompt Examples

**Prompt:** 
```
What buckets are currently active in my Backblaze B2 account?
```

**Response:** 
```
You have 3 active storage buckets:

| Bucket Name | Access Level |
| :--- | :--- |
| `production-assets-22` | allPublic |
| `backup-logs-internal` | allPrivate |
| `db-dumps` | allPrivate |

Would you like me to check for any unfinished uploads on the database bucket?
```

**Prompt:** 
```
Can you create a new private bucket for my crawler logs?
```

**Response:** 
```
I've created the `ai-crawler-logs-2026` bucket. It's set to `allPrivate` so nobody can access it publicly.
```

**Prompt:** 
```
Can I get the file details and SHA1 for index.html in the public bucket?
```

**Response:** 
```
Here are the details for `index.html`:

* **Mime Type**: `text/html`
* **Size**: 34.2 KB
* **Unique ID**: 4_zX...
* **SHA1 Hash**: `2f8bX...`

It's ready for download.
```

## Capabilities

### Create storage buckets
Provision new storage partitions for your data.

### Remove file versions
Delete specific data chunks to free up space.

### Audit storage health
Identify stalled multipart uploads that failed to complete.

### Update bucket privacy
Toggle between public and private access for your assets.

### Retrieve file metadata
Get granular checksums, sizes, and content types for any file.

### Manage soft deletes
Hide files from lists without deleting the underlying data.

### List global buckets
See all storage buckets active in your account at once.

## Use Cases

### Cleaning up failed uploads
A DevOps engineer notices high storage costs and asks the agent to find stalled multipart uploads using list_unfinished_large_files.

### Rapid bucket provisioning
A developer needs a private bucket for logs and tells the agent to create a new one with allPrivate permissions.

### Auditing asset integrity
A sysadmin wants to verify the SHA1 of a production file and uses get_file_info to pull the metadata.

### Managing soft deletes
A content manager wants to hide a file without deleting it, so they ask the agent to use hide_file.

## Benefits

- Stop wasting time in the console. Use list_buckets and list_file_names to see exactly what is in your storage without manual navigation.
- Lower your storage costs quickly. Use delete_file_version to purge old data chunks that are still taking up space in your account.
- Fix broken uploads automatically. Use list_unfinished_large_files to find and address stalled multipart transfers that might be wasting resources.
- Manage permissions with ease. Use update_bucket to toggle between public and private access for your assets in seconds.
- Audit data integrity instantly. Use get_file_info to grab SHA1 hashes and content types for any file to verify its status.
- Organize your storage architecture. Use create_bucket to set up new partitions for different projects without leaving your workspace.

## How It Works

The bottom line is you get a conversational interface for your entire cloud storage lifecycle.

1. Subscribe to the Connector and provide your Backblaze B2 Application Key ID and Key.
2. Connect your preferred AI client to the Vinkius catalog.
3. Ask your agent to perform tasks like creating buckets or auditing file versions.

## Frequently Asked Questions

**Can I use the Backblaze B2 MCP to manage my cloud files?**
Yes, this Connector lets you perform actions like creating buckets, listing files, and updating privacy settings through your AI client.

**How does the Backblaze B2 MCP help with storage costs?**
It helps you identify and remove old file versions and find stalled uploads, which helps prevent unnecessary storage charges.

**Can I use this to delete files?**
You can use it to permanently delete specific file versions or hide them from your list to prepare them for a lifecycle sweep.

**Is it safe to use this for public buckets?**
Yes, you can use it to toggle the privacy settings of your buckets to ensure your assets are either public or private as needed.

**What happens if I try to delete a bucket that isn't empty?**
The Connector will return an error because Backblaze requires buckets to be empty before deletion. You'll need to remove the files first.

**Can I check if my files are corrupted?**
You can use it to retrieve SHA1 hashes and other metadata for specific files to verify their integrity.

**Can my AI agent debug broken uploads in Backblaze B2?**
Yes. Ask your agent to list unfinished large files. It detects multipart upload shards that disconnected before completion, which consume billing quota. It provides granular visibility so you can safely clear dead streams via API.

**Can the agent make my private bucket publicly accessible to serve CDN assets?**
Yes. If commanded, the agent can update the bucket privacy setting from 'allPrivate' to 'allPublic'. This instantly routes objects to be fetched securely using friendly URLs for front-end hosting or CDN origins.

**How does the agent handle file deletion safely using B2 protocol?**
The agent can perform both soft deletes (hide file marker, triggering lifecycle purge later) or absolute hard version deletes. If you tell the agent to 'hide the file', the file remains physically safe but vanishes from directory listings.