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.

Backblaze B2 MCP Server for OpenAI Agents SDK 10 tools — connect in under 2 minutes

Name: Backblaze B2
Availability: InStock
Author: Vinkius

openai.github.io/openai-agents-python/mcp

Built by Vinkius GDPR 10 Tools SDK

The OpenAI Agents SDK enables production-grade agent workflows in Python. Connect Backblaze B2 through Vinkius and your agents gain typed, auto-discovered tools with built-in guardrails. no manual schema definitions required.

Get MCP Server for AI Agents

ASK AI ABOUT THIS MCP SERVER

Open in ChatGPT Open in Claude Open in Perplexity

Vinkius supports streamable HTTP and SSE.

python

import asyncio
from agents import Agent, Runner
from agents.mcp import MCPServerStreamableHttp

async def main():
    # Your Vinkius token. get it at cloud.vinkius.com
    async with MCPServerStreamableHttp(
        url="https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    ) as mcp_server:

        agent = Agent(
            name="Backblaze B2 Assistant",
            instructions=(
                "You help users interact with Backblaze B2. "
                "You have access to 10 tools."
            ),
            mcp_servers=[mcp_server],
        )

        result = await Runner.run(
            agent, "List all available tools from Backblaze B2"
        )
        print(result.final_output)

asyncio.run(main())

Fully ManagedVinkius Servers

60%Token savings

High SecurityEnterprise-grade

IAMAccess control

EU AI ActCompliant

DLPData protection

V8 IsolateSandboxed

Ed25519Audit chain

<40msKill switch

Stream every event to Splunk, Datadog, or your own webhook in real-time

* Every MCP server runs on Vinkius-managed infrastructure inside AWS - a purpose-built runtime with per-request V8 isolates, Ed25519 signed audit chains, and sub-40ms cold starts optimized for native MCP execution. See our infrastructure

About Backblaze B2 MCP Server

Connect your Backblaze B2 account to any AI agent and manage your cloud storage architecture directly through natural conversation.

The OpenAI Agents SDK auto-discovers all 10 tools from Backblaze B2 through native MCP integration. Build agents with built-in guardrails, tracing, and handoff patterns. chain multiple agents where one queries Backblaze B2, another analyzes results, and a third generates reports, all orchestrated through Vinkius.

O que você pode fazer

Buckets — Create, delete, update privacy (allPrivate/allPublic), and list globally mapped storage buckets
File Management — Hide files (soft delete), remove explicit file versions (hard delete), and list surface names
Health Validation — List unfinished large file chunks to find failed multipart uploads
File Intelligence — Retrieve granular file details, sizes, hashes (SHA1), and content types natively

Como funciona

1. Subscribe to this server
2. Enter your Backblaze B2 Application Key ID and Key
3. Start architecting storage and debugging files from Claude, Cursor, or any MCP-compatible client

Your AI agent now has the power to orchestrate secure and cost-effective object storage without leaving your editor.

Para quem é?

DevOps Engineers — rapidly verify bucket states, clean up abandoned file versions, and debug failed multipart streams
Backend Developers — create public and private storage domains directly from development spaces
System Administrators — audit object footprint securely and perform granular file integrity checks

The Backblaze B2 MCP Server exposes 10 tools through the Vinkius. Connect it to OpenAI Agents SDK in under two minutes — no API keys to rotate, no infrastructure to provision, no vendor lock-in. Your configuration, your data, your control.

How to Connect Backblaze B2 to OpenAI Agents SDK via MCP

Follow these steps to integrate the Backblaze B2 MCP Server with OpenAI Agents SDK.

Install the SDK

Run pip install openai-agents in your Python environment

Replace the token

Replace [YOUR_TOKEN_HERE] with your Vinkius token from cloud.vinkius.com

Run the script

Save the code above and run it: python agent.py

Explore tools

The agent will automatically discover 10 tools from Backblaze B2

Why Use OpenAI Agents SDK with the Backblaze B2 MCP Server

OpenAI Agents SDK provides unique advantages when paired with Backblaze B2 through the Model Context Protocol.

Native MCP integration via `MCPServerSse`, pass the URL and the SDK auto-discovers all tools with full type safety

Built-in guardrails, tracing, and handoff patterns let you build production-grade agents without reinventing safety infrastructure

Lightweight and composable: chain multiple agents and MCP servers in a single pipeline with minimal boilerplate

First-party OpenAI support ensures optimal compatibility with GPT models for tool calling and structured output

Backblaze B2 + OpenAI Agents SDK Use Cases

Practical scenarios where OpenAI Agents SDK combined with the Backblaze B2 MCP Server delivers measurable value.

Automated workflows: build agents that query Backblaze B2, process the data, and trigger follow-up actions autonomously

Multi-agent orchestration: create specialist agents. one queries Backblaze B2, another analyzes results, a third generates reports

Data enrichment pipelines: stream data through Backblaze B2 tools and transform it with OpenAI models in a single async loop

Customer support bots: agents query Backblaze B2 to resolve tickets, look up records, and update statuses without human intervention

Backblaze B2 MCP Tools for OpenAI Agents SDK (10)

These 10 tools become available when you connect Backblaze B2 to OpenAI Agents SDK via MCP:

authorize_account

Uncovers the dynamically assigned apiUrl (e.g. api003.backblazeb2.com) natively orchestrating regional data ingress specifically assigned to your billing account. Verify and extract Backblaze global session routing endpoints

create_bucket

Bootstraps essential structures before assigning automated backup syncs overriding file lock retention bounds. Provision a fresh logical Storage Bucket partition

delete_bucket

Fails intentionally via 400 Bad Request if standard files or hidden object versions persist nested inside. Ensure all lifecycle rules completed purging prior to command. Irreversibly delete an entirely empty Backblaze Storage Bucket

delete_file_version

Instantly removes the storage footprint avoiding long-term retention hoarding. Irreversibly vaporize specific absolute chunk data from disk arrays

get_file_info

Obtain granular checksum and headers associated with one precise B2 File

hide_file

Does not actually delete binary payload, merely injects a null-marker shadowing the actual file ensuring b2_list_file_names ignores it, enforcing safe soft deletion logic. Mark an active B2 file as hidden leaving data for lifecycle sweep

list_buckets

Crucial to resolve immutable String Bucket IDs prerequisite to executing downstream CRUD operations strictly inside native borders. Retrieve the exact Storage Buckets existing globally on the B2 Account

list_file_names

Examines precise .pdf, .mp4 file locations avoiding hidden shadowed states produced by lifecycle overwrite semantics. Paginate primary surface-level object metadata from a specific Bucket

list_unfinished_large_files

Crucial for verifying broken API pipelines originating from external S3 clients failing CompleteMultipartUpload. Scan B2 nodes for stalled Multipart Upload chunk aggregates

update_bucket

Use only for static asset endpoints. Mutate global ACL privacy settings for a bounded Bucket

Example Prompts for Backblaze B2 in OpenAI Agents SDK

Ready-to-use prompts you can give your OpenAI Agents SDK agent to start working with Backblaze B2 immediately.

"What buckets do we have enabled in Backblaze B2 right now?"

"Create a new private bucket named 'ai-crawler-logs-2026' and make it private."

"Get the file details and SHA1 for the object 'index.html' in the public bucket."

Troubleshooting Backblaze B2 MCP Server with OpenAI Agents SDK

Common issues when connecting Backblaze B2 to OpenAI Agents SDK through the Vinkius, and how to resolve them.

MCPServerStreamableHttp not found

Ensure you have the latest version: pip install --upgrade openai-agents

Agent not calling tools

Make sure your prompt explicitly references the task the tools can help with.

Backblaze B2 + OpenAI Agents SDK FAQ

Common questions about integrating Backblaze B2 MCP Server with OpenAI Agents SDK.

How does the OpenAI Agents SDK connect to MCP?

Use MCPServerSse(url=...) to create a server connection. The SDK auto-discovers all tools and makes them available to your agent with full type information.