mcp-s3 mcp

v1.0.0 · MCP Tool · cloud · registry.pascalai.org

Amazon S3 / S3-compatible (MinIO) REST API client. Auth: presigned URL or AWS credentials (accessKeyId + secretAccessKey). Operations: list_buckets, list_objects, get_object, put_object, delete_object, copy_object, create_bucket, delete_bucket, presign (generate presigned URL).

s3awsstoragecloudminiobucket

Input Parameters

ParameterTypeDescription
operationrequired string Operation to perform. One of: list_buckets, list_objects, get_object, put_object, delete_object, copy_object, create_bucket, delete_bucket, presign.
endpointUrlrequired string S3 endpoint URL (e.g. https://s3.amazonaws.com or http://localhost:9000 for MinIO).
bucketoptional string S3 bucket name. Required for most object operations.
keyoptional string S3 object key (path within bucket). Required for get, put, delete, presign.
accessKeyIdoptional string AWS Access Key ID for credential-based auth.
secretAccessKeyoptional string AWS Secret Access Key for credential-based auth.
presignedUrloptional string Pre-signed URL for direct upload/download (alternative to credentials).
contentoptional string Object content string for put_object.
contentTypeoptional string MIME type for put_object (default: application/octet-stream). Default: application/octet-stream.
prefixoptional string Key prefix filter for list_objects.
maxKeysoptional integer Max keys to return for list_objects (default: 1000). Default: 1000.

Output Fields

FieldTypeDescription
buckets array[object]
objects array[object]
content string
url string
ok boolean
error string

Examples

List objects in a bucket

// Input
{
  "operation": "list_objects",
  "endpointUrl": "https://s3.amazonaws.com",
  "bucket": "my-bucket",
  "accessKeyId": "AKIA...",
  "secretAccessKey": "xxx"
}

// Output
{
  "objects": [
    {
      "key": "data/file.csv",
      "size": 1024
    }
  ]
}

Install & Discovery

Install

ppm install mcp-s3

Get JSON Schema

GET /v1/packages/mcp-s3/1.0.0/schema

Discover by keyword

GET /v1/mcp/discover?q=s3
Discovery hint: Install with ppm install mcp-s3 or invoke remotely via POST /v1/invoke/mcp-s3 on the MCP Service.

PascalAI Usage

uses toolslib;
var Tool := LoadTool('mcp-s3');
var R := Tool.Call(JsonObj(['operation','list_objects','endpointUrl','https://s3.amazonaws.com','bucket','my-bucket','accessKeyId','AKIA...','secretAccessKey','xxx']));
Writeln(R.ToJSON);