How to Use the Amazon S3 MCP in Windsurf

Q: How do I connect Amazon S3 to my Windsurf workspace?

Open your Windsurf settings and add the server to your mcpconfig.json file under the mcpServers key. You can also use the Cascade MCP Servers UI to paste the Vinkius connection URL. Cascade automatically finds the 10 S3 tools upon refresh.

Q: Can Windsurf Cascade create and configure new Amazon S3 buckets?

Yes, Cascade uses the createbucket tool to provision buckets on demand. It can then immediately run getbucketpolicy to check access settings. You don't have to prompt Cascade for each individual step.

Q: How does Windsurf handle massive file lists from Amazon S3?

Windsurf uses listobjects with prefix filtering to keep the payload small. Cascade requests specific batches of objects instead of dumping your entire bucket history into the context window, keeping your responses fast.

Q: Does this S3 MCP Server support file deletions?

Yes. Cascade has access to deleteobject and deletebucket. It will ask for your confirmation before running these destructive tools, keeping your production data safe.

Get Cascade to spin up buckets, upload assets, and audit policies directly inside your Windsurf workspace.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Amazon S3 MCP to Windsurf

Create your Vinkius account to connect Amazon S3 to Windsurf and route execution through our secure gateway. The platform manages server hosting, runtime updates, and security layers. Configuration requires no manual server provisioning.

GDPR Free for Subscribers

Setup Amazon S3 with Windsurf

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Windsurf Cascade chains multi-step S3 bucket setups

The `create_bucket` tool exposes S3 bucket provisioning directly to Cascade. You tell Cascade to set up a new media storage assets bucket, and it doesn't just write the config. Cascade runs the tool to make the bucket, checks the access control lists, and writes your local configuration files in one go. Because Cascade executes multi-tool sequences autonomously, you avoid copying bucket names back and forth. It uses `get_bucket_acl` to check permissions before declaring the setup complete.

Direct object inspection and uploads in Cascade

The `get_object_data` tool lets your Windsurf client read raw content from your S3 buckets. When you ask Cascade to fix a broken JSON config file in your bucket, it uses `get_object_metadata` to check the file size, reads the data, edits the broken lines locally, and puts it back using `put_object`. You get a clean, hands-off workflow where Cascade handles the entire lifecycle of your cloud assets. It uploads the corrected file and confirms the upload by listing the bucket contents.

Automated S3 cleanups without leaving Windsurf

The `list_objects` tool pulls your current file list so Cascade can audit your cloud storage. If your local workspace has orphaned assets, Cascade checks your bucket, identifies the matching remote files, and deletes them using `delete_object`. This MCP integration eliminates the need to open the AWS Console or run manual CLI cleanup scripts during your development loop. Cascade handles the heavy lifting, running `delete_bucket` if you ask it to tear down a temporary staging environment.

Setup guide

Set up Amazon S3 MCP in Windsurf

Prerequisites

Windsurf IDE installed (macOS, Windows, or Linux)
Active Vinkius subscription with a valid endpoint token

1

Open MCP configuration

Click the Cascade assistant icon in the sidebar, then click the hammer icon (🔨) at the top of the panel. Select "Configure" to open ~/.codeium/windsurf/mcp_config.json.
2

Add the Amazon S3 MCP

Paste the JSON snippet shown on the right into the mcpServers object. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Refresh MCPs

Go back to the hammer icon (🔨) in Cascade and click "Refresh". Windsurf will detect the new server. No full restart is needed — the connection is hot-reloaded.
4

Verify in Cascade

Start a new Cascade conversation and ask something like "Show my Amazon S3 payment history." If connected, Cascade will call the Amazon S3 tools directly. You will see a green dot next to the server name in the MCP panel.

mcp_config.json

{
  "mcpServers": {
    "amazon-s3-mcp": {
      "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    }
  }
}

Get your connection token →

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Amazon S3. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect Amazon S3 now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about Amazon S3 MCP in Windsurf

Open your Windsurf settings and add the server to your `mcp_config.json` file under the `mcpServers` key. You can also use the Cascade MCP Servers UI to paste the Vinkius connection URL. Cascade automatically finds the 10 S3 tools upon refresh.

Yes, Cascade uses the `create_bucket` tool to provision buckets on demand. It can then immediately run `get_bucket_policy` to check access settings. You don't have to prompt Cascade for each individual step.

Windsurf uses `list_objects` with prefix filtering to keep the payload small. Cascade requests specific batches of objects instead of dumping your entire bucket history into the context window, keeping your responses fast.

Yes. Cascade has access to `delete_object` and `delete_bucket`. It will ask for your confirmation before running these destructive tools, keeping your production data safe.

Your AWS credentials and bucket data stay secure inside the Vinkius V8 Isolate Sandbox. Vinkius executes the connection ephemerally, meaning your raw file content retrieved via `get_object_data` is processed locally by Windsurf and never stored on our servers.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript