s3_bucket_delete
Delete an S3 bucket by specifying its name to remove storage resources from AWS. This tool helps manage cloud storage by removing unused or unnecessary buckets.
Instructions
Delete an S3 bucket
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| bucket_name | Yes | Name of the S3 bucket to delete |
Implementation Reference
- src/mcp_server_aws/server.py:153-154 (handler)Executes the S3 bucket delete operation by calling delete_bucket on the boto3 S3 client with the provided bucket_name.elif name == "s3_bucket_delete": response = s3_client.delete_bucket(Bucket=arguments["bucket_name"])
- src/mcp_server_aws/tools.py:28-41 (schema)Defines the schema for the s3_bucket_delete tool, including input validation for the required bucket_name parameter.Tool( name="s3_bucket_delete", description="Delete an S3 bucket", inputSchema={ "type": "object", "properties": { "bucket_name": { "type": "string", "description": "Name of the S3 bucket to delete" } }, "required": ["bucket_name"] } ),
- src/mcp_server_aws/server.py:136-140 (registration)Registers all AWS tools, including s3_bucket_delete, by returning the list from get_aws_tools() in the MCP list_tools handler.async def list_tools() -> list[Tool]: """List available AWS tools""" logger.debug("Handling list_tools request") return get_aws_tools()
- src/mcp_server_aws/tools.py:4-114 (registration)Function that returns the list of S3 tools, including the s3_bucket_delete Tool instance.def get_s3_tools() -> list[Tool]: return [ Tool( name="s3_bucket_create", description="Create a new S3 bucket", inputSchema={ "type": "object", "properties": { "bucket_name": { "type": "string", "description": "Name of the S3 bucket to create" } }, "required": ["bucket_name"] } ), Tool( name="s3_bucket_list", description="List all S3 buckets", inputSchema={ "type": "object", "properties": {} } ), Tool( name="s3_bucket_delete", description="Delete an S3 bucket", inputSchema={ "type": "object", "properties": { "bucket_name": { "type": "string", "description": "Name of the S3 bucket to delete" } }, "required": ["bucket_name"] } ), Tool( name="s3_object_upload", description="Upload an object to S3", inputSchema={ "type": "object", "properties": { "bucket_name": { "type": "string", "description": "Name of the S3 bucket" }, "object_key": { "type": "string", "description": "Key/path of the object in the bucket" }, "file_content": { "type": "string", "description": "Base64 encoded file content for upload" } }, "required": ["bucket_name", "object_key", "file_content"] } ), Tool( name="s3_object_delete", description="Delete an object from S3", inputSchema={ "type": "object", "properties": { "bucket_name": { "type": "string", "description": "Name of the S3 bucket" }, "object_key": { "type": "string", "description": "Key/path of the object to delete" } }, "required": ["bucket_name", "object_key"] } ), Tool( name="s3_object_list", description="List objects in an S3 bucket", inputSchema={ "type": "object", "properties": { "bucket_name": { "type": "string", "description": "Name of the S3 bucket" } }, "required": ["bucket_name"] } ), Tool( name="s3_object_read", description="Read an object's content from S3", inputSchema={ "type": "object", "properties": { "bucket_name": { "type": "string", "description": "Name of the S3 bucket" }, "object_key": { "type": "string", "description": "Key/path of the object to read" } }, "required": ["bucket_name", "object_key"] } ), ]