4,000+ servers built on vurb.ts
Vinkius

Amazon S3 Bucket MCP Server for Mastra AIGive Mastra AI instant access to 7 tools to Delete Object, Get Bucket Acl, Get Bucket Policy, and more

MCP Inspector GDPR Free for Subscribers

Mastra AI is a TypeScript-native agent framework built for modern web stacks. Connect Amazon S3 Bucket through Vinkius and Mastra agents discover all tools automatically. type-safe, streaming-ready, and deployable anywhere Node.js runs.

Ask AI about this MCP Server for Mastra AI

The Amazon S3 Bucket MCP Server for Mastra AI is a standout in the Industry Titans category — giving your AI agent 7 tools to work with, ready to go from day one.

Built for AI Agents by Vinkius

Vinkius delivers Streamable HTTP and SSE to any MCP client

ClaudeClaude
ChatGPTChatGPT
CursorCursor
GeminiGemini
WindsurfWindsurf
VS CodeVS Code
JetBrainsJetBrains
VercelVercel
+ other MCP clients
typescript
import { Agent } from "@mastra/core/agent";
import { createMCPClient } from "@mastra/mcp";
import { openai } from "@ai-sdk/openai";

async function main() {
  // Your Vinkius token. get it at cloud.vinkius.com
  const mcpClient = await createMCPClient({
    servers: {
      "amazon-s3-bucket": {
        url: "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp",
      },
    },
  });

  const tools = await mcpClient.getTools();
  const agent = new Agent({
    name: "Amazon S3 Bucket Agent",
    instructions:
      "You help users interact with Amazon S3 Bucket " +
      "using 7 tools.",
    model: openai("gpt-4o"),
    tools,
  });

  const result = await agent.generate(
    "What can I do with Amazon S3 Bucket?"
  );
  console.log(result.text);
}

main();
Amazon S3 Bucket
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 Amazon S3 Bucket MCP Server

Grant your AI agent precise, scoped access to a single Amazon S3 bucket — no more, no less. Unlike full S3 access, this integration enforces the principle of least privilege: your agent can read, write, and manage objects exclusively within one pre-configured bucket.

Mastra's agent abstraction provides a clean separation between LLM logic and Amazon S3 Bucket tool infrastructure. Connect 7 tools through Vinkius and use Mastra's built-in workflow engine to chain tool calls with conditional logic, retries, and parallel execution. deployable to any Node.js host in one command.

What you can do

  • Browse Objects — List and navigate files within the bucket using prefix and delimiter filters
  • Read Data — Retrieve object contents or inspect metadata (headers, content type, size) without downloading
  • Write Data — Upload string or JSON content as objects directly into the bucket
  • Clean Up — Delete specific objects to maintain storage hygiene
  • Audit Security — Inspect the bucket's access policy and ACL to ensure compliance

Why single-bucket?

AI agents should follow the principle of least privilege. Granting full S3 access to an autonomous agent creates unnecessary blast radius. This server confines the agent to a single bucket, which means:

  • No accidental bucket creation or deletion

  • No cross-bucket data exposure

  • Clearer audit trail for compliance

  • Safer agent-to-agent delegation


The Amazon S3 Bucket MCP Server exposes 7 tools through the Vinkius. Connect it to Mastra AI in under two minutes — credentials fully managed, no infrastructure to provision, no vendor lock-in. Your configuration, your data, your control.

All 7 Amazon S3 Bucket tools available for Mastra AI

When Mastra AI connects to Amazon S3 Bucket through Vinkius, your AI agent gets direct access to every tool listed below — spanning object-storage, aws, data-management, and more. Every call runs in a secure, isolated environment with full audit visibility. Beyond a simple connection, you get real-time monitoring of agent activity, enterprise governance, and optimized token usage.

delete

Delete object on Amazon S3 Bucket

Delete an object

get

Get bucket acl on Amazon S3 Bucket

Get bucket ACL

get

Get bucket policy on Amazon S3 Bucket

Get bucket policy

get

Get object data on Amazon S3 Bucket

Get object content

get

Get object metadata on Amazon S3 Bucket

Get object metadata

list

List objects on Amazon S3 Bucket

Can be filtered by prefix and delimiter. List objects in the bucket

put

Put object on Amazon S3 Bucket

Upload an object

Connect Amazon S3 Bucket to Mastra AI via MCP

Follow these steps to wire Amazon S3 Bucket into Mastra AI. The entire setup takes under two minutes — your credentials stay safe behind Vinkius.

01

Install dependencies

Run npm install @mastra/core @mastra/mcp @ai-sdk/openai
02

Replace the token

Replace [YOUR_TOKEN_HERE] with your Vinkius token
03

Run the agent

Save to agent.ts and run with npx tsx agent.ts
04

Explore tools

Mastra discovers 7 tools from Amazon S3 Bucket via MCP

Why Use Mastra AI with the Amazon S3 Bucket MCP Server

Mastra AI provides unique advantages when paired with Amazon S3 Bucket through the Model Context Protocol.

01

Mastra's agent abstraction provides a clean separation between LLM logic and tool infrastructure. add Amazon S3 Bucket without touching business code

02

Built-in workflow engine chains MCP tool calls with conditional logic, retries, and parallel execution for complex automation

03

TypeScript-native: full type inference for every Amazon S3 Bucket tool response with IDE autocomplete and compile-time checks

04

One-command deployment to any Node.js host. Vercel, Railway, Fly.io, or your own infrastructure

Amazon S3 Bucket + Mastra AI Use Cases

Practical scenarios where Mastra AI combined with the Amazon S3 Bucket MCP Server delivers measurable value.

01

Automated workflows: build multi-step agents that query Amazon S3 Bucket, process results, and trigger downstream actions in a typed pipeline

02

SaaS integrations: embed Amazon S3 Bucket as a first-class tool in your product's AI features with Mastra's clean agent API

03

Background jobs: schedule Mastra agents to query Amazon S3 Bucket on a cron and store results in your database automatically

04

Multi-agent systems: create specialist agents that collaborate using Amazon S3 Bucket tools alongside other MCP servers

Example Prompts for Amazon S3 Bucket in Mastra AI

Ready-to-use prompts you can give your Mastra AI agent to start working with Amazon S3 Bucket immediately.

01

"List all files in this bucket."

02

"Upload this JSON config to 'settings/app-config.json'."

03

"Check the access policy on this bucket."

Troubleshooting Amazon S3 Bucket MCP Server with Mastra AI

Common issues when connecting Amazon S3 Bucket to Mastra AI through Vinkius, and how to resolve them.

01

createMCPClient not exported

Install: npm install @mastra/mcp

Amazon S3 Bucket + Mastra AI FAQ

Common questions about integrating Amazon S3 Bucket MCP Server with Mastra AI.

01

How does Mastra AI connect to MCP servers?

Create an MCPClient with the server URL and pass it to your agent. Mastra discovers all tools and makes them available with full TypeScript types.
02

Can Mastra agents use tools from multiple servers?

Yes. Pass multiple MCP clients to the agent constructor. Mastra merges all tool schemas and the agent can call any tool from any server.
03

Does Mastra support workflow orchestration?

Yes. Mastra has a built-in workflow engine that lets you chain MCP tool calls with branching logic, error handling, and parallel execution.

Explore More MCP Servers

View all →