Skip to content

Commit 1e964f7

Browse files
AnnaMHuffAnnaMHuff
authored
Merge pull request #7653 from diberry/diberry/0806-mcp-053.2
MCP: 0.5.3 - Storage - updated operations and parameters
2 parents 34d6483 + a533d9e commit 1e964f7

File tree

1 file changed

+68
-55
lines changed

1 file changed

+68
-55
lines changed

‎articles/azure-mcp-server/tools/storage.md

Lines changed: 68 additions & 55 deletions
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@ description: Learn how to use the Azure MCP Server with Azure Storage.
44
keywords: azure mcp server, azmcp, storage account, blob storage
55
author: diberry
66
ms.author: diberry
7-
ms.date: 08/05/2025
7+
ms.date: 08/07/2025
88
content_well_notification:
99
- AI-contribution
1010
ai-usage: ai-assisted
@@ -19,25 +19,39 @@ The Azure MCP Server enables you to manage Azure Storage resources, including st
1919

2020
[!INCLUDE [tip-about-params](../includes/tools/parameter-consideration.md)]
2121

22-
## Create directory
22+
## List accounts
2323

24-
The Azure MCP Server can create directories in a Data Lake file system. This functionality helps you organize your hierarchical data structure in Azure Data Lake Storage by creating new folder paths as needed.
24+
The Azure MCP Server can list all storage accounts in a subscription. This functionality provides an overview of your storage infrastructure.
2525

2626
Example prompts include:
2727

28-
- **Create directory**: "Create a new directory called 'data/logs' in my 'analytics' file system in storage account 'mydatalake'."
29-
- **Make folder**: "Create folder 'archives/2024' in file system 'backup-data'"
30-
- **New directory**: "Make a directory 'processed/monthly' in my data lake file system"
31-
- **Create path**: "Create directory structure 'raw-data/sales/quarterly' in my file system"
32-
- **Make subdirectory**: "Create subdirectory 'temp/staging' in my 'workflow' file system"
28+
- **List accounts**: "Show me all storage accounts in my subscription."
29+
- **View accounts**: "What storage accounts do I have available?"
30+
- **Find accounts**: "List my storage accounts."
31+
- **Query accounts**: "Show all my storage resources."
32+
- **Check accounts**: "Storage accounts in subscription abc123."
33+
34+
## Blob: set blob access tier in a batch
35+
36+
Azure MCP Server can set the access tier for multiple blobs in a single batch operation. This functionality efficiently changes the storage tier for multiple blobs simultaneously to optimize storage costs and access patterns based on your data usage needs.
37+
38+
Example prompts include:
39+
40+
- **Set tier for multiple blobs**: "Set the access tier to 'Cool' for files 'data1.csv' and 'data2.csv' in my 'analytics' container."
41+
- **Archive old files**: "Change the tier to 'Archive' for all backup files in container 'backups'"
42+
- **Optimize storage costs**: "Set tier to 'Hot' for frequently accessed files in my 'documents' container"
43+
- **Batch tier change**: "Move files to 'Cool' tier: 'log1.txt', 'log2.txt', 'log3.txt' in container 'logs'"
44+
- **Update access tier**: "Change access tier to 'Archive' for multiple files in my storage account"
3345

3446
| Parameter | Required or optional | Description |
3547
|-----------|-------------|-------------|
36-
| **Directory path** | Required | The full path of the directory to create in the Data Lake, including the file system name (for example, 'myfilesystem/data/logs' or 'myfilesystem/archives/2024'). Use forward slashes (/) to separate the file system name from the directory path and for subdirectories. |
37-
| **Account name** | Required | The name of the Azure Storage account. This name is unique to Azure (for example, 'mystorageaccount'). |
38-
| **Resource group** | Optional | The name of the resource group containing the resource. |
48+
| **Account** | Required | The name of the Azure Storage account. This name is unique to Azure (for example, 'mystorageaccount'). |
49+
| **Container** | Required | The name of the container to access within the storage account. |
50+
| **Tier** | Required | The access tier to set for the blobs. Valid values include Hot, Cool, Archive, and others depending on the storage account type. |
51+
| **Blob names** | Required | The names of the blobs to set the access tier for. Provide multiple blob names separated by spaces. Each blob name should be the full path within the container (for example, 'file1.txt' or 'folder/file2.txt'). |
52+
3953

40-
## Get container details
54+
## Blob: get container details
4155

4256
The Azure MCP Server shows detailed information about a specific container in a storage account. This information includes metadata, access policies, and other properties.
4357

@@ -50,27 +64,11 @@ Example prompts include:
5064

5165
| Parameter | Required or optional | Description |
5266
|-----------|-------------|-------------|
53-
| **Subscription** | Required | The Azure subscription ID or name. |
5467
| **Account name** | Required | The name of the Azure Storage account. |
5568
| **Container name** | Required | The name of the container to access. |
5669

57-
## List accounts
58-
59-
The Azure MCP Server can list all storage accounts in a subscription. This functionality provides an overview of your storage infrastructure.
60-
61-
Example prompts include:
6270

63-
- **List accounts**: "Show me all storage accounts in my subscription."
64-
- **View accounts**: "What storage accounts do I have available?"
65-
- **Find accounts**: "List my storage accounts."
66-
- **Query accounts**: "Show all my storage resources."
67-
- **Check accounts**: "Storage accounts in subscription abc123."
68-
69-
| Parameter | Required or optional | Description |
70-
|-----------|-------------|-------------|
71-
| **Subscription** | Required | The Azure subscription ID or name. |
72-
73-
## List containers
71+
## Blob: List containers
7472

7573
The Azure MCP Server can list all blob containers in a storage account. This functionality helps you organize and manage your blob data.
7674

@@ -83,10 +81,9 @@ Example prompts include:
8381

8482
| Parameter | Required or optional | Description |
8583
|-----------|-------------|-------------|
86-
| **Subscription** | Required | The Azure subscription ID or name. |
8784
| **Account name** | Required | The name of the Azure Storage account. |
8885

89-
## List container blobs
86+
## Blob: list container blobs
9087

9188
The Azure MCP Server can list all blobs in a container. This feature helps you manage the files stored in your blob storage.
9289

@@ -100,29 +97,28 @@ Example prompts include:
10097

10198
| Parameter | Required or optional | Description |
10299
|-----------|-------------|-------------|
103-
| **Subscription** | Required | The Azure subscription ID or name. |
104100
| **Account name** | Required | The name of the Azure Storage account. |
105101
| **Container name** | Required | The name of the container to access. |
106102

107-
## List tables
108103

109-
The Azure MCP Server can list all tables in a storage account. This functionality helps you manage your structured NoSQL data.
104+
## Datalake: create directory
105+
106+
The Azure MCP Server can create directories in a Data Lake file system. This functionality helps you organize your hierarchical data structure in Azure Data Lake Storage by creating new folder paths as needed.
110107

111108
Example prompts include:
112109

113-
- **List tables**: "Show me all tables in my 'mystorageaccount' storage account."
114-
- **View tables**: "What tables do I have in storage account 'app_data'?"
115-
- **Find tables**: "List all tables in my storage 'user_data'"
116-
- **Query tables**: "Show available tables in my storage account"
117-
- **Check tables**: "Get all storage tables in my 'analytics_data' account"
110+
- **Create directory**: "Create a new directory called 'data/logs' in my 'analytics' file system in storage account 'mydatalake'."
111+
- **Make folder**: "Create folder 'archives/2024' in file system 'backup-data'"
112+
- **New directory**: "Make a directory 'processed/monthly' in my data lake file system"
113+
- **Create path**: "Create directory structure 'raw-data/sales/quarterly' in my file system"
114+
- **Make subdirectory**: "Create subdirectory 'temp/staging' in my 'workflow' file system"
118115

119116
| Parameter | Required or optional | Description |
120117
|-----------|-------------|-------------|
121-
| **Subscription** | Required | The Azure subscription ID or name. |
122-
| **Account name** | Required | The name of the Azure Storage account. |
123-
124-
## List file system paths
118+
| **Directory path** | Required | The full path of the directory to create in the Data Lake, including the file system name (for example, 'myfilesystem/data/logs' or 'myfilesystem/archives/2024'). Use forward slashes (/) to separate the file system name from the directory path and for subdirectories. |
119+
| **Account name** | Required | The name of the Azure Storage account. This name is unique to Azure (for example, 'mystorageaccount'). |
125120

121+
## Datalake: list file system paths
126122

127123
The Azure MCP Server can list all paths (files and directories) in a Data Lake file system. This functionality helps you explore and manage your hierarchical data stored in Azure Data Lake Storage.
128124

@@ -138,26 +134,43 @@ Example prompts include:
138134
|-----------|-------------|-------------|
139135
| **File system name** | Required | The name of the Data Lake file system to access within the storage account. |
140136
| **Account name** | Required | The name of the Azure Storage account. This name is unique to Azure (for example, 'mystorageaccount'). |
141-
| **Resource group** | Optional | The name of the resource group containing the resource. |
137+
| **Filter path** | Optional | The prefix to filter paths in the Data Lake. Only paths that start with this prefix will be listed. |
138+
| **Recursive** | Optional | Flag to indicate whether the command will operate recursively on all subdirectories. |
142139

143-
## Set blob access tier in a batch
140+
## Share: list files
144141

145-
Azure MCP Server can set the access tier for multiple blobs in a single batch operation. This functionality efficiently changes the storage tier for multiple blobs simultaneously to optimize storage costs and access patterns based on your data usage needs.
142+
The Azure MCP Server can list files and directories within a file share directory. This functionality recursively lists all items in a specified file share directory, including files, subdirectories, and their properties. Files and directories may be filtered by a prefix.
146143

147144
Example prompts include:
148145

149-
- **Set tier for multiple blobs**: "Set the access tier to 'Cool' for files 'data1.csv' and 'data2.csv' in my 'analytics' container."
150-
- **Archive old files**: "Change the tier to 'Archive' for all backup files in container 'backups'"
151-
- **Optimize storage costs**: "Set tier to 'Hot' for frequently accessed files in my 'documents' container"
152-
- **Batch tier change**: "Move files to 'Cool' tier: 'log1.txt', 'log2.txt', 'log3.txt' in container 'logs'"
153-
- **Update access tier**: "Change access tier to 'Archive' for multiple files in my storage account"
146+
- **List files**: "Show me all files in the 'documents' directory of my 'myshare' file share in storage account 'mystorageaccount'."
147+
- **View directory contents**: "What files are in directory 'projects/2024' in my 'teamshare' file share?"
148+
- **Find files with prefix**: "List all files starting with 'report_' in directory 'reports' of my file share"
149+
- **Browse folders**: "Show contents of directory 'uploads/images' in my file share"
150+
- **Check directory**: "Get all files and folders in 'backup/daily' directory of my file share"
154151

155152
| Parameter | Required or optional | Description |
156153
|-----------|-------------|-------------|
157-
| **Account** | Required | The name of the Azure Storage account. This name is unique to Azure (for example, 'mystorageaccount'). |
158-
| **Container** | Required | The name of the container to access within the storage account. |
159-
| **Tier** | Required | The access tier to set for the blobs. Valid values include Hot, Cool, Archive, and others depending on the storage account type. |
160-
| **Blob names** | Required | The names of the blobs to set the access tier for. Provide multiple blob names separated by spaces. Each blob name should be the full path within the container (for example, 'file1.txt' or 'folder/file2.txt'). |
154+
| **Account** | Required | The name of the Azure Storage account. This is the unique name you chose for your storage account (for example, 'mystorageaccount'). |
155+
| **Share** | Required | The name of the file share to access within the storage account. |
156+
| **Directory path** | Required | The path of the directory to list within the file share (for example, 'documents/projects' or 'uploads/2024'). Use forward slashes (/) to separate subdirectories. |
157+
| **Prefix** | Optional | Optional prefix to filter results. Only items that start with this prefix will be returned. |
158+
159+
## Table: list tables
160+
161+
The Azure MCP Server can list all tables in a storage account. This functionality helps you manage your structured NoSQL data.
162+
163+
Example prompts include:
164+
165+
- **List tables**: "Show me all tables in my 'mystorageaccount' storage account."
166+
- **View tables**: "What tables do I have in storage account 'app_data'?"
167+
- **Find tables**: "List all tables in my storage 'user_data'"
168+
- **Query tables**: "Show available tables in my storage account"
169+
- **Check tables**: "Get all storage tables in my 'analytics_data' account"
170+
171+
| Parameter | Required or optional | Description |
172+
|-----------|-------------|-------------|
173+
| **Account name** | Required | The name of the Azure Storage account. |
161174

162175
## Related content
163176

0 commit comments

Comments
 (0)