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
`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}

mcp_server_azure/azure_tools.py:269-293 (schema)

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

Azure MCP Server