dynamodb_item_scan
Scan items in a DynamoDB table using filter expressions to retrieve specific data. This tool helps query and analyze table contents by applying custom search criteria.
Instructions
Scan items in a DynamoDB table
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| table_name | Yes | Name of the DynamoDB table | |
| filter_expression | No | Filter expression | |
| expression_attributes | No |
Implementation Reference
- src/mcp_server_aws/server.py:247-260 (handler)Handler implementation for the dynamodb_item_scan tool: builds scan parameters from arguments and executes dynamodb_client.scan()
elif name == "dynamodb_item_scan": scan_params = {"TableName": arguments["table_name"]} if "filter_expression" in arguments: scan_params["FilterExpression"] = arguments["filter_expression"] if "expression_attributes" in arguments: attrs = arguments["expression_attributes"] if "names" in attrs: scan_params["ExpressionAttributeNames"] = attrs["names"] if "values" in attrs: scan_params["ExpressionAttributeValues"] = attrs["values"] response = dynamodb_client.scan(**scan_params) - src/mcp_server_aws/tools.py:293-323 (schema)Input schema and Tool definition for dynamodb_item_scan, specifying parameters like table_name, filter_expression, and expression_attributes
Tool( name="dynamodb_item_scan", description="Scan items in a DynamoDB table", inputSchema={ "type": "object", "properties": { "table_name": { "type": "string", "description": "Name of the DynamoDB table" }, "filter_expression": { "type": "string", "description": "Filter expression" }, "expression_attributes": { "type": "object", "properties": { "values": { "type": "object", "description": "Expression attribute values" }, "names": { "type": "object", "description": "Expression attribute names" } } } }, "required": ["table_name"] } ), - src/mcp_server_aws/server.py:136-139 (registration)Tool registration via the list_tools handler, which returns get_aws_tools() including the dynamodb_item_scan tool definition from tools.py
async def list_tools() -> list[Tool]: """List available AWS tools""" logger.debug("Handling list_tools request") return get_aws_tools()