[{"_1":2,"_361":-5,"_362":-5},"loaderData",{"_3":4,"_13":14,"_21":22,"_336":337},"root",{"_5":-5,"_6":-7,"_7":8,"_9":-7,"_10":11,"_12":-7},"currentUser","primaryEmail","siteVerification","6LeIxAcTAAAAAJcZVRqyHh71UMIEGNQ_MXjiZKhI","toast","enableDev",false,"incidentStatus","routes/_layout",{"_15":-5,"_16":17,"_18":17,"_19":11,"_20":11},"username","isAskGordonEnabled",true,"isUsingNewTemplate","showMinimalLanding","showHoneypotTrap","routes/_layout.r.$namespace.$reponame",{"_23":24,"_25":26,"_190":11,"_191":11,"_192":193,"_194":195,"_196":-5,"_197":11,"_198":199,"_251":252,"_271":272,"_329":-5,"_330":11,"_331":17,"_332":11,"_333":-5,"_334":335},"canonicalUrl","https://hub.docker.com/r/mcp/s3-tables-mcp-server/tags","mcpServer",{"_27":28,"_29":30,"_31":32,"_33":34,"_35":36,"_37":38,"_39":40,"_41":42,"_43":44,"_45":46,"_47":48,"_49":50,"_51":52,"_53":54,"_124":125,"_128":136,"_147":148,"_149":-5,"_150":151,"_173":174,"_188":189,"_56":153},"description","Manage S3 Tables for analytics.","title","AWS S3 Tables","type","server","dynamic",{},"dateAdded","2025-11-06T18:02:41Z","image","mcp/s3-tables-mcp-server@sha256:6a2cb111afe46b6bf9d8ecd63838641caa17a5059b2c8b5583ae5d8e7eec5b21","ref","","readme","http://desktop.docker.com/mcp/catalog/v3/readme/awslabs-s3-tables.md","toolsUrl","http://desktop.docker.com/mcp/catalog/v3/tools/awslabs-s3-tables.json","source","https://github.com/awslabs/mcp/tree/636aca8e109b5559006044f035bb89c16e9e5410/src/s3-tables-mcp-server","upstream","https://github.com/awslabs/mcp","remote",{},"icon","https://avatars.githubusercontent.com/u/3299148?v=4","tools",[55,64,68,72,76,80,84,88,92,96,100,104,108,112,116,120],{"_56":57,"_58":59,"_62":63},"name","append_rows_to_table","parameters",{"_31":40,"_60":-5,"_61":-5},"properties","required","container",{},{"_56":65,"_58":66,"_62":67},"create_namespace",{"_31":40,"_60":-5,"_61":-5},{},{"_56":69,"_58":70,"_62":71},"create_table",{"_31":40,"_60":-5,"_61":-5},{},{"_56":73,"_58":74,"_62":75},"create_table_bucket",{"_31":40,"_60":-5,"_61":-5},{},{"_56":77,"_58":78,"_62":79},"get_bucket_metadata_config",{"_31":40,"_60":-5,"_61":-5},{},{"_56":81,"_58":82,"_62":83},"get_maintenance_job_status",{"_31":40,"_60":-5,"_61":-5},{},{"_56":85,"_58":86,"_62":87},"get_table_maintenance_config",{"_31":40,"_60":-5,"_61":-5},{},{"_56":89,"_58":90,"_62":91},"get_table_metadata_location",{"_31":40,"_60":-5,"_61":-5},{},{"_56":93,"_58":94,"_62":95},"import_csv_to_table",{"_31":40,"_60":-5,"_61":-5},{},{"_56":97,"_58":98,"_62":99},"import_parquet_to_table",{"_31":40,"_60":-5,"_61":-5},{},{"_56":101,"_58":102,"_62":103},"list_namespaces",{"_31":40,"_60":-5,"_61":-5},{},{"_56":105,"_58":106,"_62":107},"list_table_buckets",{"_31":40,"_60":-5,"_61":-5},{},{"_56":109,"_58":110,"_62":111},"list_tables",{"_31":40,"_60":-5,"_61":-5},{},{"_56":113,"_58":114,"_62":115},"query_database",{"_31":40,"_60":-5,"_61":-5},{},{"_56":117,"_58":118,"_62":119},"rename_table",{"_31":40,"_60":-5,"_61":-5},{},{"_56":121,"_58":122,"_62":123},"update_table_metadata_location",{"_31":40,"_60":-5,"_61":-5},{},"secrets",[126,132],{"_56":127,"_128":129,"_130":131},"awslabs-s3-tables.aws_secret_access_key","env","AWS_SECRET_ACCESS_KEY","example","your-aws-secret-access-key",{"_56":133,"_128":134,"_130":135},"awslabs-s3-tables.aws_session_token","AWS_SESSION_TOKEN","your-aws-session-token",[137,141,144],{"_56":138,"_139":140},"AWS_REGION","value","{{awslabs-s3-tables.aws_region}}",{"_56":142,"_139":143},"AWS_PROFILE","{{awslabs-s3-tables.aws_profile}}",{"_56":145,"_139":146},"AWS_ACCESS_KEY_ID","{{awslabs-s3-tables.aws_access_key_id}}","prompts",0,"resources","config",[152],{"_56":153,"_27":154,"_31":155,"_60":156},"awslabs-s3-tables","Configure AWS credentials for S3 Tables access","object",[157,165,169],{"_158":159,"_163":164},"Schema",{"_31":160,"_161":162},"string","items",{"_31":40},"Name","aws_region",{"_158":166,"_163":168},{"_31":160,"_161":167},{"_31":40},"aws_profile",{"_158":170,"_163":172},{"_31":160,"_161":171},{"_31":40},"aws_access_key_id","metadata",{"_175":176,"_177":178,"_179":180,"_181":182,"_184":185,"_186":187},"pulls",13065,"githubStars",9705,"category","data-analytics","tags",[183],"aws","license","Apache License 2.0","owner","awslabs","oauth",{},"canSeeDockerfile","canSeeAutobuilds","namespace","mcp","reponame","s3-tables-mcp-server","cloudBuildSource","isAutobuildsAvailable","repo",{"_200":201,"_206":207,"_208":209,"_27":28,"_210":11,"_211":212,"_213":214,"_215":216,"_56":195,"_192":193,"_218":219,"_220":-5,"_221":148,"_222":223,"_224":225,"_45":-5,"_226":227,"_231":148,"_232":233,"_234":11,"_235":193,"_236":237,"_242":11,"_243":244,"_248":193,"_249":250},"categories",[202],{"_56":203,"_204":205},"Machine learning & AI","slug","machine-learning-and-ai","content_types",[37],"date_registered","2025-11-06T17:58:28.494713Z","is_private","last_updated","2026-07-08T07:07:08.99237Z","last_modified","2026-09-18T06:25:55.787199Z","media_types",[217],"application/vnd.oci.image.index.v1+json","pull_count",13081,"repository_type","star_count","status",1,"status_description","active","registry_region",{"_56":228,"_229":230},"us-east-1","label","US","collaborator_count","full_description","# AWS S3 Tables MCP Server\n\nManage S3 Tables for analytics.\n\n[What is an MCP Server?](https://www.anthropic.com/news/model-context-protocol)\n\n## MCP Info\nAttribute|Details|\n|-|-|\n**Docker Image**|[mcp/s3-tables-mcp-server](https://hub.docker.com/repository/docker/mcp/s3-tables-mcp-server)\n**Author**|[awslabs](https://github.com/awslabs)\n**Repository**|https://github.com/awslabs/mcp\n\n## Image Building Info\nAttribute|Details|\n|-|-|\n**Dockerfile**|https://github.com/awslabs/mcp/blob/636aca8e109b5559006044f035bb89c16e9e5410/src/s3-tables-mcp-server/Dockerfile\n**Commit**|`636aca8e109b5559006044f035bb89c16e9e5410`\n**Docker Image built by**|Docker Inc.\n**Docker Scout Health Score**| ![Docker Scout Health Score](https://api.scout.docker.com/v1/policy/insights/org-image-score/badge/mcp/s3-tables-mcp-server)\n**Verify Signature**|`COSIGN_REPOSITORY=mcp/signatures cosign verify mcp/s3-tables-mcp-server --key https://raw.githubusercontent.com/docker/keyring/refs/heads/main/public/mcp/latest.pub`\n**Licence**|Apache License 2.0\n\n## Available Tools (16)\nTools provided by this Server|Short Description\n-|-\n`append_rows_to_table`|Append rows to an Iceberg table using PyIceberg/Daft.|\n`create_namespace`|Create a new namespace in an S3 table bucket.|\n`create_table`|Create a new S3 table in an S3 table bucket.|\n`create_table_bucket`|Creates an S3 table bucket.|\n`get_bucket_metadata_config`|Get the metadata table configuration for a regular general purpose S3 bucket.|\n`get_maintenance_job_status`|Get the status of a maintenance job for a table.|\n`get_table_maintenance_config`|Get details about the maintenance configuration of a table.|\n`get_table_metadata_location`|Get the location of the S3 table metadata.|\n`import_csv_to_table`|Import data from a CSV file into an S3 table.|\n`import_parquet_to_table`|Import data from a Parquet file into an existing S3 table.|\n`list_namespaces`|List all namespaces across all S3 table buckets.|\n`list_table_buckets`|List all S3 table buckets for your AWS account.|\n`list_tables`|List all S3 tables across all table buckets and namespaces.|\n`query_database`|Execute SQL queries against S3 Tables using PyIceberg/Daft.|\n`rename_table`|Rename an S3 table or move it to a different S3 namespace.|\n`update_table_metadata_location`|Update the metadata location for an S3 table.|\n\n---\n## Tools Details\n\n#### Tool: **`append_rows_to_table`**\nAppend rows to an Iceberg table using PyIceberg/Daft.\n\nThis tool appends data rows to an existing Iceberg table using the PyIceberg engine.\nThe rows parameter must be a list of dictionaries, each representing a row.\nCheck the schema of the table before appending rows.\n\nExample input values:\n warehouse: 'arn:aws:s3tables:::bucket/'\n region: 'us-west-2'\n namespace: 'retail_data'\n table_name: 'customers'\n rows: [{\"customer_id\": 1, \"customer_name\": \"Alice\"}, ...]\n uri: 'https://s3tables.us-west-2.amazonaws.com/iceberg'\n catalog_name: 's3tablescatalog'\n rest_signing_name: 's3tables'\n rest_sigv4_enabled: 'true'\nParameters|Type|Description\n-|-|-\n`namespace`|`string`|The name of the namespace. Must be 1-255 characters long and contain only alphanumeric characters, underscores, and hyphens.\n`region`|`string`|AWS region for S3Tables/Iceberg REST endpoint\n`rows`|`array`|List of rows to append, each as a dict\n`table_name`|`string`|The name of the table. Must be 1-255 characters long and contain only alphanumeric characters, underscores, and hyphens.\n`uri`|`string`|REST URI for Iceberg catalog\n`warehouse`|`string`|Warehouse string for Iceberg catalog\n`catalog_name`|`string` *optional*|Catalog name\n`rest_signing_name`|`string` *optional*|REST signing name\n`rest_sigv4_enabled`|`string` *optional*|Enable SigV4 signing\n\n---\n#### Tool: **`create_namespace`**\nCreate a new namespace in an S3 table bucket.\n\nCreates a namespace. A namespace is a logical grouping of tables within your S3 table bucket,\nwhich you can use to organize S3 tables.\n\nPermissions:\nYou must have the s3tables:CreateNamespace permission to use this operation.\nParameters|Type|Description\n-|-|-\n`namespace`|`string`|The name of the namespace. Must be 1-255 characters long and contain only alphanumeric characters, underscores, and hyphens.\n`table_bucket_arn`|`string`|Table bucket ARN\n`region_name`|`string` *optional*|The AWS region name where the operation should be performed.\n\n---\n#### Tool: **`create_table`**\nCreate a new S3 table in an S3 table bucket.\n\nCreates a new S3 table associated with the given S3 namespace in an S3 table bucket.\nThe S3 table can be configured with specific format and metadata settings. Metadata contains the schema of the table.\nDo not use the metadata parameter if the schema is unclear.\n\nSupported Iceberg Primitive Types:\n- boolean: True or false\n- int: 32-bit signed integers (can promote to long)\n- long: 64-bit signed integers\n- float: 32-bit IEEE 754 floating point (can promote to double)\n- double: 64-bit IEEE 754 floating point\n- decimal(P,S): Fixed-point decimal with precision P and scale S (precision must be 38 or less)\n- date: Calendar date without timezone or time\n- time: Time of day, microsecond precision, without date or timezone\n- timestamp: Timestamp, microsecond precision, without timezone (represents date and time regardless of zone)\n- timestamptz: Timestamp, microsecond precision, with timezone (stored as UTC)\n- string: Arbitrary-length character sequences (UTF-8 encoded)\n\nNote: Binary field types (binary, fixed, uuid) are not supported.\n\nExample of S3 table metadata:\n{\n \"metadata\": {\n \"iceberg\": {\n \"schema\": {\n \"type\": \"struct\",\n \"fields\": [\n {\n \"id\": 1,\n \"name\": \"id\",\n \"type\": \"long\",\n \"required\": true\n },\n {\n \"id\": 2,\n \"name\": \"bool_field\",\n \"type\": \"boolean\",\n \"required\": false\n },\n {\n \"id\": 3,\n \"name\": \"int_field\",\n \"type\": \"int\",\n \"required\": false\n },\n {\n \"id\": 4,\n \"name\": \"long_field\",\n \"type\": \"long\",\n \"required\": false\n },\n {\n \"id\": 5,\n \"name\": \"float_field\",\n \"type\": \"float\",\n \"required\": false\n },\n {\n \"id\": 6,\n \"name\": \"double_field\",\n \"type\": \"double\",\n \"required\": false\n },\n {\n \"id\": 7,\n \"name\": \"decimal_field\",\n \"type\": \"decimal(10,2)\",\n \"required\": false\n },\n {\n \"id\": 8,\n \"name\": \"date_field\",\n \"type\": \"date\",\n \"required\": false\n },\n {\n \"id\": 9,\n \"name\": \"time_field\",\n \"type\": \"time\",\n \"required\": false\n },\n {\n \"id\": 10,\n \"name\": \"timestamp_field\",\n \"type\": \"timestamp\",\n \"required\": false\n },\n {\n \"id\": 11,\n \"name\": \"timestamptz_field\",\n \"type\": \"timestamptz\",\n \"required\": false\n },\n {\n \"id\": 12,\n \"name\": \"string_field\",\n \"type\": \"string\",\n \"required\": false\n }\n ]\n },\n \"partition-spec\": [\n {\n \"source-id\": 8,\n \"field-id\": 1000,\n \"transform\": \"month\",\n \"name\": \"date_field_month\"\n }\n ],\n \"table-properties\": {\n \"description\": \"Example table demonstrating supported Iceberg primitive types\"\n }\n }\n }\n}\n\nPermissions:\nYou must have the s3tables:CreateTable permission to use this operation.\nParameters|Type|Description\n-|-|-\n`name`|`string`|The name of the table. Must be 1-255 characters long and contain only alphanumeric characters, underscores, and hyphens.\n`namespace`|`string`|The name of the namespace. Must be 1-255 characters long and contain only alphanumeric characters, underscores, and hyphens.\n`table_bucket_arn`|`string`|Table bucket ARN\n`format`|`string` *optional*|The format for the S3 table.\n`metadata`|`string` *optional*|The metadata for the S3 table.\n`region_name`|`string` *optional*|The AWS region name where the operation should be performed.\n\n---\n#### Tool: **`create_table_bucket`**\nCreates an S3 table bucket.\n\nPermissions:\nYou must have the s3tables:CreateTableBucket permission to use this operation.\nParameters|Type|Description\n-|-|-\n`name`|`string`|Name of the table bucket to create. Must be 3-63 characters long and contain only lowercase letters, numbers, and hyphens.\n`region_name`|`string` *optional*|The AWS region name where the operation should be performed.\n\n---\n#### Tool: **`get_bucket_metadata_config`**\nGet the metadata table configuration for a regular general purpose S3 bucket.\n\nRetrieves the metadata table configuration for a regular general purpose bucket in s3. This configuration\ndetermines how metadata is stored and managed for the bucket.\nThe response includes:\n- S3 Table Bucket ARN\n- S3 Table ARN\n- S3 Table Name\n- S3 Table Namespace\n\nDescription:\nAmazon S3 Metadata accelerates data discovery by automatically capturing metadata for the objects in your general purpose buckets and storing it in read-only, fully managed Apache Iceberg tables that you can query. These read-only tables are called metadata tables. As objects are added to, updated, and removed from your general purpose buckets, S3 Metadata automatically refreshes the corresponding metadata tables to reflect the latest changes.\nBy default, S3 Metadata provides three types of metadata:\n- System-defined metadata, such as an object's creation time and storage class\n- Custom metadata, such as tags and user-defined metadata that was included during object upload\n- Event metadata, such as when an object is updated or deleted, and the AWS account that made the request\n\nMetadata table schema:\n- bucket: String\n- key: String\n- sequence_number: String\n- record_type: String\n- record_timestamp: Timestamp (no time zone)\n- version_id: String\n- is_delete_marker: Boolean\n- size: Long\n- last_modified_date: Timestamp (no time zone)\n- e_tag: String\n- storage_class: String\n- is_multipart: Boolean\n- encryption_status: String\n- is_bucket_key_enabled: Boolean\n- kms_key_arn: String\n- checksum_algorithm: String\n- object_tags: Map\n- user_metadata: Map\n- requester: String\n- source_ip_address: String\n- request_id: String\n\nPermissions:\nYou must have the s3:GetBucketMetadataConfiguration permission to use this operation.\nParameters|Type|Description\n-|-|-\n`bucket`|`string`|The name of the S3 bucket to get metadata table configuration for.\n`region_name`|`string` *optional*|The AWS region name where the operation should be performed.\n\n---\n#### Tool: **`get_maintenance_job_status`**\nGet the status of a maintenance job for a table.\n\nGets the status of a maintenance job for a table. For more information, see S3 Tables maintenance in the Amazon Simple Storage Service User Guide.\n\nPermissions:\nYou must have the s3tables:GetTableMaintenanceJobStatus permission to use this operation.\nParameters|Type|Description\n-|-|-\n`name`|`string`|The name of the table. Must be 1-255 characters long and contain only alphanumeric characters, underscores, and hyphens.\n`namespace`|`string`|The name of the namespace. Must be 1-255 characters long and contain only alphanumeric characters, underscores, and hyphens.\n`table_bucket_arn`|`string`|Table bucket ARN\n`region_name`|`string` *optional*|The AWS region name where the operation should be performed.\n\n---\n#### Tool: **`get_table_maintenance_config`**\nGet details about the maintenance configuration of a table.\n\nGets details about the maintenance configuration of a table. For more information, see S3 Tables maintenance in the Amazon Simple Storage Service User Guide.\n\nPermissions:\nYou must have the s3tables:GetTableMaintenanceConfiguration permission to use this operation.\nParameters|Type|Description\n-|-|-\n`name`|`string`|The name of the table. Must be 1-255 characters long and contain only alphanumeric characters, underscores, and hyphens.\n`namespace`|`string`|The name of the namespace. Must be 1-255 characters long and contain only alphanumeric characters, underscores, and hyphens.\n`table_bucket_arn`|`string`|Table bucket ARN\n`region_name`|`string` *optional*|The AWS region name where the operation should be performed.\n\n---\n#### Tool: **`get_table_metadata_location`**\nGet the location of the S3 table metadata.\n\nGets the S3 URI location of the table metadata, which contains the schema and other\ntable configuration information.\n\nPermissions:\nYou must have the s3tables:GetTableMetadataLocation permission to use this operation.\nParameters|Type|Description\n-|-|-\n`name`|`string`|The name of the table. Must be 1-255 characters long and contain only alphanumeric characters, underscores, and hyphens.\n`namespace`|`string`|The name of the namespace. Must be 1-255 characters long and contain only alphanumeric characters, underscores, and hyphens.\n`table_bucket_arn`|`string`|Table bucket ARN\n`region_name`|`string` *optional*|The AWS region name where the operation should be performed.\n\n---\n#### Tool: **`import_csv_to_table`**\nImport data from a CSV file into an S3 table.\n\nThis tool reads data from a CSV file stored in S3 and imports it into an S3 table.\nIf the table doesn't exist, it will be created with a schema inferred from the CSV file.\nIf the table exists, the CSV file schema must be compatible with the table's schema.\nThe tool will validate the schema before attempting to import the data.\nIf preserve_case is True, the column names will not be converted to snake_case. Otherwise, the column names will be converted to snake_case.\n\nReturns error dictionary with status and error message if:\n - URL is not a valid S3 URL\n - File is not a CSV file\n - File cannot be accessed\n - Table does not exist\n - CSV headers don't match table schema\n - Any other error occurs\n\nExample input values:\n warehouse: 'arn:aws:s3tables:::bucket/'\n region: 'us-west-2'\n namespace: 'retail_data'\n table_name: 'customers'\n s3_url: 's3://bucket-name/path/to/file.csv'\n uri: 'https://s3tables.us-west-2.amazonaws.com/iceberg'\n catalog_name: 's3tablescatalog'\n rest_signing_name: 's3tables'\n rest_sigv4_enabled: 'true'\n preserve_case: False\n\nPermissions:\nYou must have:\n- s3:GetObject permission for the CSV file\n- s3tables:GetTable and s3tables:GetTables permissions to access table information\n- s3tables:PutTableData permission to write to the table\nParameters|Type|Description\n-|-|-\n`namespace`|`string`|The name of the namespace. Must be 1-255 characters long and contain only alphanumeric characters, underscores, and hyphens.\n`region`|`string`|AWS region for S3Tables/Iceberg REST endpoint\n`s3_url`|`string`|The S3 URL of the file to preview (format: s3://bucket-name/key)\n`table_name`|`string`|The name of the table. Must be 1-255 characters long and contain only alphanumeric characters, underscores, and hyphens.\n`uri`|`string`|REST URI for Iceberg catalog\n`warehouse`|`string`|Warehouse string for Iceberg catalog\n`catalog_name`|`string` *optional*|Catalog name\n`preserve_case`|`boolean` *optional*|Preserve case of column names\n`rest_signing_name`|`string` *optional*|REST signing name\n`rest_sigv4_enabled`|`string` *optional*|Enable SigV4 signing\n\n---\n#### Tool: **`import_parquet_to_table`**\nImport data from a Parquet file into an existing S3 table.\n\nThis tool reads data from a Parquet file stored in S3 and imports it into an existing S3 table.\nThe table must already exist. The Parquet file schema must be compatible with the table's schema.\nThe tool will validate the schema before attempting to import the data.\nIf preserve_case is True, the column names will not be converted to snake_case. Otherwise, the column names will be converted to snake_case.\n\nReturns error dictionary with status and error message if:\n - URL is not a valid S3 URL\n - File is not a Parquet file\n - File cannot be accessed\n - Table does not exist\n - Parquet schema is incompatible with existing table schema\n - Any other error occurs\n\nReturns success dictionary with:\n - status: 'success'\n - message: Success message with row count\n - rows_processed: Number of rows imported\n - file_processed: Name of the processed file\n\nExample input values:\n warehouse: 'arn:aws:s3tables:::bucket/'\n region: 'us-west-2'\n namespace: 'retail_data'\n table_name: 'customers'\n s3_url: 's3://bucket-name/path/to/file.parquet'\n uri: 'https://s3tables.us-west-2.amazonaws.com/iceberg'\n catalog_name: 's3tablescatalog'\n rest_signing_name: 's3tables'\n rest_sigv4_enabled: 'true'\n preserve_case: False\n\nPermissions:\nYou must have:\n- s3:GetObject permission for the Parquet file\n- s3tables:GetTable and s3tables:GetTables permissions to access table information\n- s3tables:PutTableData permission to write to the table\nParameters|Type|Description\n-|-|-\n`namespace`|`string`|The name of the namespace. Must be 1-255 characters long and contain only alphanumeric characters, underscores, and hyphens.\n`region`|`string`|AWS region for S3Tables/Iceberg REST endpoint\n`s3_url`|`string`|The S3 URL of the file to preview (format: s3://bucket-name/key)\n`table_name`|`string`|The name of the table. Must be 1-255 characters long and contain only alphanumeric characters, underscores, and hyphens.\n`uri`|`string`|REST URI for Iceberg catalog\n`warehouse`|`string`|Warehouse string for Iceberg catalog\n`catalog_name`|`string` *optional*|Catalog name\n`preserve_case`|`boolean` *optional*|Preserve case of column names\n`rest_signing_name`|`string` *optional*|REST signing name\n`rest_sigv4_enabled`|`string` *optional*|Enable SigV4 signing\n\n---\n#### Tool: **`list_namespaces`**\nList all namespaces across all S3 table buckets.\n\nPermissions:\nYou must have the s3tables:ListNamespaces permission to use this operation.\nParameters|Type|Description\n-|-|-\n`region_name`|`string` *optional*|The AWS region name where the operation should be performed.\n\n---\n#### Tool: **`list_table_buckets`**\nList all S3 table buckets for your AWS account.\n\nPermissions:\nYou must have the s3tables:ListTableBuckets permission to use this operation.\nParameters|Type|Description\n-|-|-\n`region_name`|`string` *optional*|The AWS region name where the operation should be performed.\n\n---\n#### Tool: **`list_tables`**\nList all S3 tables across all table buckets and namespaces.\n\nPermissions:\nYou must have the s3tables:ListTables permission to use this operation.\nParameters|Type|Description\n-|-|-\n`region_name`|`string` *optional*|The AWS region name where the operation should be performed.\n\n---\n#### Tool: **`query_database`**\nExecute SQL queries against S3 Tables using PyIceberg/Daft.\n\nThis tool provides a secure interface to run read-only SQL queries against your S3 Tables data using the PyIceberg and Daft engine.\nUse a correct region for warehouse, region, and uri.\n\nExample input values:\n warehouse: 'arn:aws:s3tables:::bucket/'\n region: 'us-west-2'\n namespace: 'retail_data'\n query: 'SELECT * FROM customers LIMIT 10'\n uri: 'https://s3tables.us-west-2.amazonaws.com/iceberg'\n catalog_name: 's3tablescatalog'\n rest_signing_name: 's3tables'\n rest_sigv4_enabled: 'true'\nParameters|Type|Description\n-|-|-\n`namespace`|`string`|The name of the namespace. Must be 1-255 characters long and contain only alphanumeric characters, underscores, and hyphens.\n`region`|`string`|AWS region for S3Tables/Iceberg REST endpoint\n`uri`|`string`|REST URI for Iceberg catalog\n`warehouse`|`string`|Warehouse string for Iceberg catalog\n`catalog_name`|`string` *optional*|Catalog name\n`query`|`string` *optional*|Optional SQL query. If not provided, will execute SELECT * FROM table. Must be a read operation.\n`rest_signing_name`|`string` *optional*|REST signing name\n`rest_sigv4_enabled`|`string` *optional*|Enable SigV4 signing\n\n---\n#### Tool: **`rename_table`**\nRename an S3 table or move it to a different S3 namespace.\n\nRenames an S3 table or moves it to a different S3 namespace within the same S3 table bucket.\nThis operation maintains the table's data and configuration while updating its location.\n\nPermissions:\nYou must have the s3tables:RenameTable permission to use this operation.\nParameters|Type|Description\n-|-|-\n`name`|`string`|The name of the table. Must be 1-255 characters long and contain only alphanumeric characters, underscores, and hyphens.\n`namespace`|`string`|The name of the namespace. Must be 1-255 characters long and contain only alphanumeric characters, underscores, and hyphens.\n`table_bucket_arn`|`string`|Table bucket ARN\n`new_name`|`string` *optional*|The name of the table. Must be 1-255 characters long and contain only alphanumeric characters, underscores, and hyphens.\n`new_namespace_name`|`string` *optional*|The name of the namespace. Must be 1-255 characters long and contain only alphanumeric characters, underscores, and hyphens.\n`region_name`|`string` *optional*|The AWS region name where the operation should be performed.\n`version_token`|`string` *optional*|The version token of the S3 table. Must be 1-2048 characters long.\n\n---\n#### Tool: **`update_table_metadata_location`**\nUpdate the metadata location for an S3 table.\n\nUpdates the metadata location for an S3 table. The metadata location of an S3 table must be an S3 URI that begins with the S3 table's warehouse location.\nThe metadata location for an Apache Iceberg S3 table must end with .metadata.json, or if the metadata file is Gzip-compressed, .metadata.json.gz.\n\nPermissions:\nYou must have the s3tables:UpdateTableMetadataLocation permission to use this operation.\nParameters|Type|Description\n-|-|-\n`metadata_location`|`string`|The new metadata location for the S3 table. Must be 1-2048 characters long.\n`name`|`string`|The name of the table. Must be 1-255 characters long and contain only alphanumeric characters, underscores, and hyphens.\n`namespace`|`string`|The name of the namespace. Must be 1-255 characters long and contain only alphanumeric characters, underscores, and hyphens.\n`table_bucket_arn`|`string`|Table bucket ARN\n`version_token`|`string`|The version token of the S3 table. Must be 1-2048 characters long.\n`region_name`|`string` *optional*|The AWS region name where the operation should be performed.\n\n---\n## Use this MCP Server\n\n```json\n{\n \"mcpServers\": {\n \"awslabs-s3-tables\": {\n \"command\": \"docker\",\n \"args\": [\n \"run\",\n \"-i\",\n \"--rm\",\n \"-e\",\n \"AWS_REGION\",\n \"-e\",\n \"AWS_PROFILE\",\n \"-e\",\n \"AWS_ACCESS_KEY_ID\",\n \"-e\",\n \"AWS_SECRET_ACCESS_KEY\",\n \"-e\",\n \"AWS_SESSION_TOKEN\",\n \"mcp/s3-tables-mcp-server\"\n ],\n \"env\": {\n \"AWS_REGION\": \"us-east-1\",\n \"AWS_PROFILE\": \"default\",\n \"AWS_ACCESS_KEY_ID\": \"AKIAIOSFODNN7EXAMPLE\",\n \"AWS_SECRET_ACCESS_KEY\": \"your-aws-secret-access-key\",\n \"AWS_SESSION_TOKEN\": \"your-aws-session-token\"\n }\n }\n }\n}\n```\n\n[Why is it safer to run MCP Servers with Docker?](https://www.docker.com/blog/the-model-context-protocol-simplifying-building-ai-apps-with-anthropic-claude-desktop-and-docker/)\n","has_starred","hub_user","immutable_tags_settings",{"_238":11,"_239":240},"enabled","rules",[241],".*","is_automated","permissions",{"_245":17,"_246":11,"_247":11},"read","write","admin","user","storage_size",11696913257,"orgData",{"_253":254,"_255":256,"_31":257,"_258":193,"_259":40,"_260":40,"_261":40,"_262":40,"_263":264,"_265":266,"_267":40,"_268":269,"_270":17},"id","ab077e05eab24efe99a56f634d10d9b7","uuid","ab077e05-eab2-4efe-99a5-6f634d10d9b7","organization","orgname","full_name","location","company","profile_url","date_joined","2024-12-19T17:06:26.203495Z","gravatar_url","https://www.gravatar.com/avatar/56b6e15d486f6407690a6cb56e3fa68e?s=80&r=g&d=mm","gravatar_email","badge","verified_publisher","is_active","recentTags",[273],{"_274":37,"_275":276,"_277":278,"_279":280,"_253":281,"_282":283,"_211":316,"_317":276,"_318":319,"_320":217,"_56":321,"_322":323,"_324":325,"_326":316,"_327":225,"_328":17},"content_type","creator",440445,"digest","sha256:6a2cb111afe46b6bf9d8ecd63838641caa17a5059b2c8b5583ae5d8e7eec5b21","full_size",232914148,1006034549,"images",[284,299,305,311],{"_285":286,"_277":287,"_288":40,"_289":290,"_291":292,"_293":294,"_295":40,"_296":-5,"_297":280,"_222":225,"_298":-5},"architecture","amd64","sha256:77585eac880cb5d6e19c6951943d08743fe465c6ba53f412e770a8efd9868c3a","features","last_pulled","2026-09-18T18:10:08.565758648Z","last_pushed","2026-07-08T07:07:06.303521819Z","os","linux","os_features","os_version","size","variant",{"_285":300,"_277":301,"_288":40,"_289":302,"_291":303,"_293":294,"_295":40,"_296":-5,"_297":304,"_222":225,"_298":-5},"arm64","sha256:f40c72694a9e71e37378a7bcb730292baa4c83b17688f4f2ac089c5d7918d989","2026-09-18T23:51:40.748572746Z","2026-07-08T07:07:05.86158186Z",221539372,{"_285":306,"_277":307,"_288":40,"_289":308,"_291":309,"_293":306,"_295":40,"_296":-5,"_297":310,"_222":225,"_298":-5},"unknown","sha256:a6bcf678dc614348194c3fd51c68cfd586001748214a50e02f472fa3a50ea059","2026-09-18T18:10:08.518213833Z","2026-07-08T07:07:06.696276318Z",5094702,{"_285":306,"_277":312,"_288":40,"_289":313,"_291":314,"_293":306,"_295":40,"_296":-5,"_297":315,"_222":225,"_298":-5},"sha256:29555647c162acabe879c4eb62376ab66bd308a860b126e5459327d93dbe8ac2","2026-09-18T23:52:00.784916962Z","2026-07-08T07:07:06.22655781Z",5094171,"2026-07-08T07:07:08.694252Z","last_updater","last_updater_username","dockerbuildbot","media_type","latest","repository",29077634,"tag_last_pulled","2026-09-19T03:25:54.503599194Z","tag_last_pushed","tag_status","v2","sbxKitMetadata","isPotentialSpam","isHubSbxKitsEnabled","displaySecurityMetadata","tagAttestations","tagsHaveAttestations",[],"routes/_layout.r.$namespace.$reponame.tags",{"_198":338,"_181":347,"_334":359,"_360":11},{"_200":339,"_206":341,"_208":209,"_27":28,"_210":11,"_211":212,"_213":214,"_215":342,"_56":195,"_192":193,"_218":219,"_220":-5,"_221":148,"_222":223,"_224":225,"_45":-5,"_226":343,"_231":148,"_232":233,"_234":11,"_235":193,"_236":344,"_242":11,"_243":346,"_248":193,"_249":250},[340],{"_56":203,"_204":205},[37],[217],{"_56":228,"_229":230},{"_238":11,"_239":345},[241],{"_245":17,"_246":11,"_247":11},{"_348":223,"_349":-5,"_350":-5,"_351":352},"count","next","previous","results",[353],{"_274":37,"_275":276,"_277":278,"_279":280,"_253":281,"_282":354,"_211":316,"_317":276,"_318":319,"_320":217,"_56":321,"_322":323,"_324":325,"_326":316,"_327":225,"_328":17},[355,356,357,358],{"_285":286,"_277":287,"_288":40,"_289":290,"_291":292,"_293":294,"_295":40,"_296":-5,"_297":280,"_222":225,"_298":-5},{"_285":300,"_277":301,"_288":40,"_289":302,"_291":303,"_293":294,"_295":40,"_296":-5,"_297":304,"_222":225,"_298":-5},{"_285":306,"_277":307,"_288":40,"_289":308,"_291":309,"_293":306,"_295":40,"_296":-5,"_297":310,"_222":225,"_298":-5},{"_285":306,"_277":312,"_288":40,"_289":313,"_291":314,"_293":306,"_295":40,"_296":-5,"_297":315,"_222":225,"_298":-5},[],"canDeleteTags","actionData","errors"]

Digest	OS/ARCH	Compressed size
77585eac880c	linux/amd64	222.12 MB
f40c72694a9e	linux/arm64	211.28 MB

mcp/s3-tables-mcp-server

Tags for mcp/s3-tables-mcp-server