cosmosdb_item_delete
Remove specific items from Azure Cosmos DB containers by providing container name, item ID, and partition key to manage database content.
Instructions
Delete an item from a Cosmos DB container
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| container_name | Yes | Name of the Cosmos DB container | |
| database_name | No | Name of the Cosmos DB database (optional, defaults to 'defaultdb') | |
| item_id | Yes | ID of the item to delete | |
| partition_key | Yes | Partition key value for the item |
Implementation Reference
- mcp_server_azure/azure_server.py:294-301 (handler)The core handler logic for the cosmosdb_item_delete tool. It retrieves the container client and calls delete_item with the provided item_id and partition_key.
elif name == "cosmosdb_item_delete": # Renamed table to container container_client = database.get_container_client( arguments["container_name"] ) container_client.delete_item( item=arguments["item_id"], partition_key=arguments["partition_key"] ) response = {"item_id": arguments["item_id"], "deleted": True} - Defines the input schema, description, and name for the cosmosdb_item_delete tool, which is used for registration.
Tool( name="cosmosdb_item_delete", # Renamed table to container description="Delete an item from a Cosmos DB container", # Updated description inputSchema={ "type": "object", "properties": { "container_name": { # Renamed from table_name "type": "string", "description": "Name of the Cosmos DB container", # Updated description }, "database_name": { "type": "string", "description": "Name of the Cosmos DB database (optional, defaults to 'defaultdb')", }, "item_id": { "type": "string", "description": "ID of the item to delete", }, "partition_key": { "type": "string", "description": "Partition key value for the item", }, }, "required": ["container_name", "item_id", "partition_key"], }, - mcp_server_azure/azure_server.py:171-176 (registration)Registers all Azure tools, including cosmosdb_item_delete, by returning the list from get_azure_tools() in response to list_tools requests.
@server.list_tools() async def list_tools() -> list[Tool]: """List available Azure tools""" logger.debug("Handling list_tools request") return get_azure_tools() # Use get_azure_tools