Skip to main content

S3 bucket

Read, write, and list text objects under a scoped bucket prefix.

Read and write files in an S3 bucket, scoped to a key prefix.

Connect

Credential fieldRequiredWhere it comes from
Access key ID (ACCESS_KEY_ID)Yes
Secret access key (SECRET_ACCESS_KEY)Yes
SettingRequiredWhat it is
Bucket (BUCKET)Yes
Key prefix (PREFIX)NoAgents can only touch keys under this prefix
Region (REGION)Noe.g. us-east-1
Endpoint override (ENDPOINT)NoFor S3-compatible stores; leave empty for AWS. Must be a public https host.

Tools

ToolAccessWhat it does
Put object (yekar.s3.put_object)WriteWrite a text object under the scoped prefix (idempotent: same key + same body re-runs safely)
Get object (yekar.s3.get_object)ReadRead an object under the scoped prefix. Small text objects come back inline as body; anything large or binary (an image, a PDF, an archive) is written to a file instead and returned as an attachment.
List objects (yekar.s3.list)ReadList keys under the scoped prefix

Notes

  • Agents can only touch keys under the prefix you configure - “..” and out-of-prefix keys are rejected.
  • An access key ID and secret access key are required.
  • Set the endpoint override to use an S3-compatible store (MinIO, localstack). It must be a public https host (http is allowed only for localhost).