microsoft · xingfan-git · Mar 9, 2026 · Mar 9, 2026 · Mar 9, 2026 · Mar 9, 2026
@@ -166,6 +166,12 @@
 # ServiceLabel: %tools-Docker
 # ServiceOwners:                       @conniey @microsoft/azure-mcp
 
+# PRLabel: %tools-DocumentDb
+/tools/Azure.Mcp.Tools.DocumentDb/     @xingfan-git @microsoft/azure-mcp
+
+# ServiceLabel: %tools-DocumentDb
+# ServiceOwners:                       @xingfan-git
+
 # ServiceLabel: %tools-Eclipse
 # ServiceOwners:                       @srnagar @microsoft/azure-mcp
 

@@ -83,6 +83,7 @@
     <PackageVersion Include="Microsoft.Extensions.Hosting" Version="10.0.2" />
     <PackageVersion Include="ModelContextProtocol" Version="1.0.0" />
     <PackageVersion Include="ModelContextProtocol.AspNetCore" Version="1.0.0" />
+    <PackageVersion Include="MongoDB.Driver" Version="3.2.0" />
     <PackageVersion Include="MySqlConnector" Version="2.4.0" />
     <PackageVersion Include="Npgsql" Version="10.0.1" />
     <PackageVersion Include="YamlDotNet" Version="16.3.0" />

@@ -170,6 +170,53 @@ function CheckVariable($name) {
     return $value
 }
 
+function Test-ProjectUsesMongoDbDriver {
+    param(
+        [string] $ProjectPath
+    )
+
+    if (!(Test-Path $ProjectPath)) {
+        return $false
+    }
+
+    $projectContent = Get-Content $ProjectPath -Raw
+    return $projectContent -match '<PackageReference\s+Include="MongoDB\.Driver"'
+}
+
+function Test-ServerHasMongoDbDependency {
+    param(
+        [System.IO.FileInfo] $ServerProject
+    )
+
+    $serverProjectDirectory = Split-Path $ServerProject.FullName -Parent
+    $serverProjectContent = Get-Content $ServerProject.FullName -Raw
+    $projectReferenceMatches = [regex]::Matches($serverProjectContent, '<ProjectReference\s+Include="([^"]+)"')
+
+    foreach ($projectReferenceMatch in $projectReferenceMatches) {
+        $projectReference = $projectReferenceMatch.Groups[1].Value
+        if (-not $projectReference) {
+            continue
+        }
+
+        $expandedReference = $projectReference.Replace('$(RepoRoot)', $RepoRoot)
+        $expandedReference = $expandedReference.Replace('$(MSBuildThisFileDirectory)', "$serverProjectDirectory/")
+        $expandedReference = $expandedReference.Replace('\', '/')
+
+        if (-not [System.IO.Path]::IsPathRooted($expandedReference)) {
+            $expandedReference = (Join-Path $serverProjectDirectory $expandedReference).Replace('\', '/')
+        }
+
+        $referencedProjects = @(Get-ChildItem -Path $expandedReference -File -ErrorAction SilentlyContinue)
+        foreach ($referencedProject in $referencedProjects) {
+            if (Test-ProjectUsesMongoDbDriver -ProjectPath $referencedProject.FullName) {
+                return $true
+            }
+        }
+    }
+
+    return $false
+}
+
 $windowsPool = CheckVariable 'WINDOWSPOOL'
 $linuxPool = CheckVariable 'LINUXPOOL'
 $linuxArm64Pool = CheckVariable 'LINUXARM64POOL'
@@ -387,6 +434,13 @@ function Get-ServerDetails {
             $version.PrereleaseNumber = $BuildId
         }
 
+        # Check if this server depends on MongoDB.Driver (incompatible with IL trimming)
+        $hasMongoDbDependency = Test-ServerHasMongoDbDependency -ServerProject $serverProject
+
+        if ($hasMongoDbDependency) {
+            Write-Host "Server $serverName depends on DocumentDb (with MongoDB.Driver) - trimming will be disabled" -ForegroundColor Yellow
+        }
+
         # Calculate VSIX version based on server version
         $vsixVersion = $null
         $vsixIsPrerelease = $false
@@ -473,7 +527,8 @@ function Get-ServerDetails {
                         architecture = $arch
                         extension = $os.extension
                         native = $false
-                        trimmed = $true
+                        # Disable trimming for servers with MongoDB.Driver dependency (uses extensive reflection)
+                        trimmed = !$hasMongoDbDependency
                     }
                 }
             }
@@ -498,7 +553,7 @@ function Get-ServerDetails {
                 architecture = $additionalPlatform.architecture
                 extension = $os.extension
                 native = $additionalPlatform.native
-                trimmed = $additionalPlatform.trimmed
+                trimmed = $additionalPlatform.trimmed -and !$hasMongoDbDependency
                 specialPurpose = $additionalPlatform.specialPurpose
             }
         }

@@ -179,6 +179,14 @@
     <Project Path="../../tools/Azure.Mcp.Tools.DeviceRegistry/tests/Azure.Mcp.Tools.DeviceRegistry.UnitTests/Azure.Mcp.Tools.DeviceRegistry.UnitTests.csproj" />
     <Project Path="../../tools/Azure.Mcp.Tools.DeviceRegistry/tests/Azure.Mcp.Tools.DeviceRegistry.LiveTests/Azure.Mcp.Tools.DeviceRegistry.LiveTests.csproj" />
   </Folder>
+  <Folder Name="/tools/Azure.Mcp.Tools.DocumentDb/" />
+  <Folder Name="/tools/Azure.Mcp.Tools.DocumentDb/src/">
+    <Project Path="../../tools/Azure.Mcp.Tools.DocumentDb/src/Azure.Mcp.Tools.DocumentDb.csproj" />
+  </Folder>
+  <Folder Name="/tools/Azure.Mcp.Tools.DocumentDb/tests/">
+    <Project Path="../../tools/Azure.Mcp.Tools.DocumentDb/tests/Azure.Mcp.Tools.DocumentDb.LiveTests/Azure.Mcp.Tools.DocumentDb.LiveTests.csproj" />
+    <Project Path="../../tools/Azure.Mcp.Tools.DocumentDb/tests/Azure.Mcp.Tools.DocumentDb.UnitTests/Azure.Mcp.Tools.DocumentDb.UnitTests.csproj" />
+  </Folder>
   <Folder Name="/tools/Azure.Mcp.Tools.EventGrid/" />
   <Folder Name="/tools/Azure.Mcp.Tools.EventGrid/src/">
     <Project Path="../../tools/Azure.Mcp.Tools.EventGrid/src/Azure.Mcp.Tools.EventGrid.csproj" />

@@ -963,6 +963,22 @@ Example prompts that generate Azure CLI commands:
 * "Get Azure Data Explorer databases in cluster 'mycluster'"
 * "Sample 10 rows from table 'StormEvents' in Azure Data Explorer database 'db1'"
 
+### 🗄️ Azure DocumentDB (with MongoDB compatibility)
+
+* "List indexes for collection 'items' in DocumentDB database 'test'"
+* "Create an index on field 'category' for collection 'items' in DocumentDB database 'test'"
+* "Drop index 'category_1' from collection 'items' in DocumentDB database 'test'"
+* "Show index statistics for collection 'items' in DocumentDB database 'test'"
+* "Show current DocumentDB operations"
+* "List all databases in DocumentDB"
+* "Get statistics for database 'mydb'"
+* "Get details for database 'analytics' in DocumentDB"
+* "Drop database 'testdb'"
+* "Show me collections in database 'mydb'"
+* "Get statistics for collection 'users'"
+* "Rename collection 'old-name' to 'new-name'"
+* "Sample documents from collection 'products'"
+
 ### 📣 Azure Event Grid
 
 * "List all Event Grid topics in subscription 'my-subscription'"

@@ -0,0 +1,4 @@
+pr: 1968
+changes:
+  - section: "Features Added"
+    description: "Added mcp tools for managing Azure DocumentDB (with MongoDB compatibility) index"
@@ -0,0 +1,3 @@
+changes:
+  - section: "Features Added"
+    description: "Added mcp tools for managing Azure DocumentDB (with MongoDB compatibility) database"
@@ -0,0 +1,3 @@
+changes:
+  - section: "Features Added"
+    description: "Added DocumentDB tools for managing Azure DocumentDB (with MongoDB compatibility) collection"
@@ -1694,6 +1694,86 @@ azmcp deviceregistry namespace list --subscription <subscription> \
                                     [--resource-group <resource-group>]
 ```
 
+### Azure DocumentDB (with MongoDB compatibility) Operations
+
+```bash
+# List all indexes on a collection
+# ❌ Destructive | ✅ Idempotent | ❌ OpenWorld | ✅ ReadOnly | ❌ Secret | ❌ LocalRequired
+azmcp documentdb index list indexes --connection-string <connection-string> \
+                                    --db-name <db-name> \
+                                    --collection-name <collection-name>
+
+# Create an index on a collection
+# ✅ Destructive | ❌ Idempotent | ❌ OpenWorld | ❌ ReadOnly | ❌ Secret | ❌ LocalRequired
+azmcp documentdb index create index --connection-string <connection-string> \
+                                    --db-name <db-name> \
+                                    --collection-name <collection-name> \
+                                    --keys <json-index-keys> \
+                                    [--options <json-index-options>]
+
+# Drop an index from a collection
+# ✅ Destructive | ❌ Idempotent | ❌ OpenWorld | ❌ ReadOnly | ❌ Secret | ❌ LocalRequired
+azmcp documentdb index drop index --connection-string <connection-string> \
+                                  --db-name <db-name> \
+                                  --collection-name <collection-name> \
+                                  --index-name <index-name>
+
+# List all databases or inspect a single database
+# ❌ Destructive | ✅ Idempotent | ❌ OpenWorld | ✅ ReadOnly | ❌ Secret | ❌ LocalRequired
+azmcp documentdb database list databases --connection-string <connection-string> \
+                                         [--db-name <db-name>]
+
+# Rename a collection
+# ✅ Destructive | ❌ Idempotent | ❌ OpenWorld | ❌ ReadOnly | ❌ Secret | ❌ LocalRequired
+azmcp documentdb collection rename collection --connection-string <connection-string> \
+                                              --db-name <db-name> \
+                                              --collection-name <collection-name> \
+                                              --new-collection-name <new-collection-name>
+
+# Drop a collection
+# ✅ Destructive | ❌ Idempotent | ❌ OpenWorld | ❌ ReadOnly | ❌ Secret | ❌ LocalRequired
+azmcp documentdb collection drop collection --connection-string <connection-string> \
+                                            --db-name <db-name> \
+                                            --collection-name <collection-name>
+
+# Sample documents from a collection
+# ❌ Destructive | ❌ Idempotent | ❌ OpenWorld | ✅ ReadOnly | ❌ Secret | ❌ LocalRequired
+azmcp documentdb collection sample documents --connection-string <connection-string> \
+                                             --db-name <db-name> \
+                                             --collection-name <collection-name> \
+                                             [--sample-size <sample-size>]
+
+# Get DocumentDB statistics for a database
+# ❌ Destructive | ✅ Idempotent | ❌ OpenWorld | ✅ ReadOnly | ❌ Secret | ❌ LocalRequired
+azmcp documentdb others get stats --connection-string <connection-string> \
+                                  --resource-type database \
+                                  --db-name <db-name>
+
+# Get DocumentDB statistics for a collection
+# ❌ Destructive | ✅ Idempotent | ❌ OpenWorld | ✅ ReadOnly | ❌ Secret | ❌ LocalRequired
+azmcp documentdb others get stats --connection-string <connection-string> \
+                                  --resource-type collection \
+                                  --db-name <db-name> \
+                                  --collection-name <collection-name>
+
+# Get DocumentDB statistics for indexes on a collection
+# ❌ Destructive | ✅ Idempotent | ❌ OpenWorld | ✅ ReadOnly | ❌ Secret | ❌ LocalRequired
+azmcp documentdb others get stats --connection-string <connection-string> \
+                                  --resource-type index \
+                                  --db-name <db-name> \
+                                  --collection-name <collection-name>
+
+# Get current DocumentDB operations
+# ❌ Destructive | ✅ Idempotent | ❌ OpenWorld | ✅ ReadOnly | ❌ Secret | ❌ LocalRequired
+azmcp documentdb others current ops --connection-string <connection-string> \
+                                    [--ops <json-filter>]
+
+# Drop a database
+# ✅ Destructive | ❌ Idempotent | ❌ OpenWorld | ❌ ReadOnly | ❌ Secret | ❌ LocalRequired
+azmcp documentdb database drop database --connection-string <connection-string> \
+                                        --db-name <db-name>
+```
+
 ### Azure Event Grid Operations
 
 ```bash

@@ -356,6 +356,28 @@ This file contains prompts used for end-to-end testing to ensure each tool is in
 | deviceregistry_namespace_list | List Device Registry namespaces in resource group <resource_group_name> |
 | deviceregistry_namespace_list | What Device Registry namespaces do I have in my Azure subscription? |
 
+## Azure DocumentDB (with MongoDB compatibility)
+
+| Tool Name | Test Prompt |
+|:----------|:----------|
+| documentdb_index_list_indexes | List indexes for collection <collection-name> in DocumentDB database <db-name> |
+| documentdb_index_list_indexes | Show me all indexes on collection <collection-name> in database <db-name> |
+| documentdb_index_create_index | Create an index on collection <collection-name> in DocumentDB database <db-name> using keys <keys> |
+| documentdb_index_create_index | Add a DocumentDB index for collection <collection-name> in database <db-name> with keys <keys> and options <options> |
+| documentdb_index_drop_index | Drop index <index-name> from collection <collection-name> in DocumentDB database <db-name> |
+| documentdb_index_drop_index | Remove the <index-name> index from DocumentDB collection <collection-name> in database <db-name> |
+| documentdb_others_get_stats | Show index statistics for collection <collection-name> in DocumentDB database <db-name> |
+| documentdb_others_get_stats | Get DocumentDB index stats for collection <collection-name> in database <db-name> |
+| documentdb_others_current_ops | Show current DocumentDB operations |
+| documentdb_others_current_ops | Get current DocumentDB operations filtered by <ops> |
+| documentdb_others_get_stats | Get statistics for database <db-name> |
+| documentdb_others_get_stats | Show me stats for DocumentDB database <db-name> |
+| documentdb_database_drop_database | Drop database <db-name> |
+| documentdb_database_drop_database | Delete the database <db-name> from DocumentDB |
+| documentdb_database_list_databases | List all databases in DocumentDB |
+| documentdb_database_list_databases | Show me all DocumentDB databases |
+| documentdb_database_list_databases | Get details for database <db-name> in DocumentDB |
+
 ## Azure Event Grid
 
 | Tool Name | Test Prompt |

@@ -104,6 +104,7 @@ private static IAreaSetup[] RegisterAreas()
             new Azure.Mcp.Tools.AzureTerraformBestPractices.AzureTerraformBestPracticesSetup(),
             new Azure.Mcp.Tools.Deploy.DeploySetup(),
             new Azure.Mcp.Tools.DeviceRegistry.DeviceRegistrySetup(),
+            new Azure.Mcp.Tools.DocumentDb.DocumentDbSetup(),
             new Azure.Mcp.Tools.EventGrid.EventGridSetup(),
             new Azure.Mcp.Tools.Acr.AcrSetup(),
             new Azure.Mcp.Tools.Advisor.AdvisorSetup(),

@@ -137,7 +137,7 @@
     },
     {
       "name": "get_azure_databases_details",
-      "description": "Comprehensive Azure database management tool for MySQL, PostgreSQL, SQL Database, SQL Server, and Cosmos DB. List and query databases, retrieve server configurations and parameters, explore table schemas, execute database queries, manage Cosmos DB containers and items, list and view detailed information about SQL servers, and view database server details across all Azure database services.",
+      "description": "Comprehensive Azure database management tool for MySQL, PostgreSQL, SQL Database, SQL Server, Cosmos DB, and Azure DocumentDB (MongoDB-compatible). List and query databases, retrieve server configurations and parameters, explore table schemas, execute database queries, manage Cosmos DB containers and items, inspect DocumentDB databases, indexes, statistics, and current operations, list and view detailed information about SQL servers, and view database server details across Azure database services.",
       "toolMetadata": {
         "destructive": {
           "value": false,
@@ -178,7 +178,81 @@
         "sql_db_get",
         "sql_server_get",
         "cosmos_list",
-        "cosmos_database_container_item_query"
+        "cosmos_database_container_item_query",
+        "documentdb_database_list_databases",
+        "documentdb_index_list_indexes",
+        "documentdb_others_current_ops",
+        "documentdb_others_get_stats"
+      ]
+    },
+    {
+      "name": "sample_azure_documentdb_collection_documents",
+      "description": "Retrieve sample documents from Azure DocumentDB collections to inspect document structure and infer schema patterns for query authoring.",
+      "toolMetadata": {
+        "destructive": {
+          "value": false,
+          "description": "This tool performs only additive updates without deleting or modifying existing resources."
+        },
+        "idempotent": {
+          "value": false,
+          "description": "Running this operation multiple times with the same arguments may have additional effects or produce different results."
+        },
+        "openWorld": {
+          "value": false,
+          "description": "This tool's domain of interaction is closed and well-defined, limited to a specific set of entities."
+        },
+        "readOnly": {
+          "value": true,
+          "description": "This tool only performs read operations without modifying any state or data."
+        },
+        "secret": {
+          "value": false,
+          "description": "This tool does not handle sensitive or secret information."
+        },
+        "localRequired": {
+          "value": false,
+          "description": "This tool is available in both local and remote server modes."
+        }
+      },
+      "mappedToolList": [
+        "documentdb_collection_sample_documents"
+      ]
+    },
+    {
+      "name": "edit_azure_documentdb_databases_and_collections",
+      "description": "Manage Azure DocumentDB databases, collections, and indexes. Create and drop indexes, rename or drop collections, and drop databases.",
+      "toolMetadata": {
+        "destructive": {
+          "value": true,
+          "description": "This tool may delete or modify existing resources in its environment."
+        },
+        "idempotent": {
+          "value": false,
+          "description": "Running this operation multiple times with the same arguments may have additional effects or produce different results."
+        },
+        "openWorld": {
+          "value": false,
+          "description": "This tool's domain of interaction is closed and well-defined, limited to a specific set of entities."
+        },
+        "readOnly": {
+          "value": false,
+          "description": "This tool may modify its environment by creating, updating, or deleting data."
+        },
+        "secret": {
+          "value": false,
+          "description": "This tool does not handle sensitive or secret information."
+        },
+        "localRequired": {
+          "value": false,
+          "description": "This tool is available in both local and remote server modes."
+        }
+      },
+      "mappedToolList": [
+        "documentdb_collection_drop_collection",
+        "documentdb_collection_rename_collection",
+        "documentdb_database_drop_database",
+        "documentdb_index_create_index",
+        "documentdb_index_drop_index"
       ]
     },
     {

@@ -0,0 +1,6 @@
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT License.
+
+using System.Runtime.CompilerServices;
+
+[assembly: InternalsVisibleTo("Azure.Mcp.Tools.DocumentDb.UnitTests")]