Add IoT Hub device list command by Iris20050110 · Pull Request #3074 · microsoft/mcp

Iris20050110 · 2026-07-16T20:47:35Z

Adds the azmcp iothub device list command to list device identities in an Azure IoT Hub device registry. Returns device metadata without authentication keys, supports --max-count (default 100, maximum 100) with a truncated flag when more devices exist, and returns a validation error when --max-count is less than 1.

Includes the Azure.Mcp.Tools.IoTHub project (device list command, options, models, services, unit and live tests) and wires it into the server registration, command docs, e2e prompts, CHANGELOG, and consolidated-tools.json.

What does this PR do?

[Provide a clear, concise description of the changes]

[Add additional context, screenshots, or information that helps reviewers]

GitHub issue number?

[Link to the GitHub issue this PR addresses]

Pre-merge Checklist

Adds the `azmcp iothub device list` command to list device identities in an Azure IoT Hub device registry. Returns device metadata without authentication keys, supports --max-count (default 100, maximum 100) with a truncated flag when more devices exist, and returns a validation error when --max-count is less than 1. Includes the Azure.Mcp.Tools.IoTHub project (device list command, options, models, services, unit and live tests) and wires it into the server registration, command docs, e2e prompts, CHANGELOG, and consolidated-tools.json.

Copilot

Pull request overview

Adds a new Azure IoT Hub toolset and wires it into Azure MCP Server so users can run azmcp iothub device list to list device identities (metadata-only) from an IoT Hub device registry.

Changes:

Introduces Azure.Mcp.Tools.IoTHub with a device-list command, models, and services for IoT Hub device registry listing.
Adds unit + live test projects and live-test infrastructure (Bicep + post-deploy script) for the IoT Hub toolset.
Registers the new area/tool and updates server docs, e2e prompts, consolidated tool mapping, and changelog.

Invoking Livetests

Copilot submitted PRs are not trustworthy by default. Users with write access to the repo need to validate the contents of this PR before leaving a comment with the text /azp run mcp - pullrequest - live. This will trigger the necessary livetest workflows to complete required validation.

Reviewed changes

Copilot reviewed 36 out of 37 changed files in this pull request and generated 9 comments.

Show a summary per file

File	Description
tools/Azure.Mcp.Tools.IoTHub/tests/test-resources.bicep	Adds Bicep template to provision an IoT Hub for live tests.
tools/Azure.Mcp.Tools.IoTHub/tests/test-resources-post.ps1	Adds post-deploy script to create test devices.
tools/Azure.Mcp.Tools.IoTHub/tests/Azure.Mcp.Tools.IoTHub.UnitTests/Device/IoTHubDeviceListCommandTests.cs	Adds unit tests for the device list command behavior.
tools/Azure.Mcp.Tools.IoTHub/tests/Azure.Mcp.Tools.IoTHub.UnitTests/Azure.Mcp.Tools.IoTHub.UnitTests.csproj	Adds unit test project for the IoT Hub toolset.
tools/Azure.Mcp.Tools.IoTHub/tests/Azure.Mcp.Tools.IoTHub.LiveTests/IoTHubCommandTests.cs	Adds live test coverage for `iothub_device_list`.
tools/Azure.Mcp.Tools.IoTHub/tests/Azure.Mcp.Tools.IoTHub.LiveTests/Azure.Mcp.Tools.IoTHub.LiveTests.csproj	Adds live test project for IoT Hub toolset.
tools/Azure.Mcp.Tools.IoTHub/src/Services/IoTHubService.cs	Implements ARM-side IoT Hub discovery and key retrieval helpers.
tools/Azure.Mcp.Tools.IoTHub/src/Services/IoTHubDeviceService.cs	Implements data-plane device registry listing via IoT Hub REST + SAS auth.
tools/Azure.Mcp.Tools.IoTHub/src/Services/IIoTHubService.cs	Adds IoT Hub service contract (hub lookup + keys).
tools/Azure.Mcp.Tools.IoTHub/src/Services/IIoTHubDeviceService.cs	Adds device registry service contract (list devices).
tools/Azure.Mcp.Tools.IoTHub/src/Options/IoTHubOptionDefinitions.cs	Defines CLI options for IoT Hub commands (name, max-count).
tools/Azure.Mcp.Tools.IoTHub/src/Options/Device/IoTHubDeviceListOptions.cs	Adds options POCO for the device list command.
tools/Azure.Mcp.Tools.IoTHub/src/Models/IoTHubKey.cs	Adds model to represent IoT Hub SAS policies/keys (internal plumbing).
tools/Azure.Mcp.Tools.IoTHub/src/Models/IoTHubDescription.cs	Adds model for IoT Hub metadata returned from ARM query.
tools/Azure.Mcp.Tools.IoTHub/src/Models/DeviceListResult.cs	Adds response model (devices + truncated flag).
tools/Azure.Mcp.Tools.IoTHub/src/Models/DeviceIdentity.cs	Adds device identity DTO (intentionally excluding auth keys).
tools/Azure.Mcp.Tools.IoTHub/src/IoTHubSetup.cs	Registers IoT Hub services + commands into the area system.
tools/Azure.Mcp.Tools.IoTHub/src/GlobalUsings.cs	Adds global usings for the new toolset.
tools/Azure.Mcp.Tools.IoTHub/src/Commands/IoTHubJsonContext.cs	Adds STJ source-gen context for IoT Hub models (AOT-safe).
tools/Azure.Mcp.Tools.IoTHub/src/Commands/Device/IoTHubDeviceListCommand.cs	Adds `azmcp iothub device list` command implementation.
tools/Azure.Mcp.Tools.IoTHub/src/Commands/BaseIoTHubCommand.cs	Adds IoT Hub command base to share common subscription/resource-group options.
tools/Azure.Mcp.Tools.IoTHub/src/Azure.Mcp.Tools.IoTHub.csproj	Adds new toolset project and dependencies.
tools/Azure.Mcp.Tools.IoTHub/src/AssemblyInfo.cs	Adds InternalsVisibleTo for new test projects.
servers/Azure.Mcp.Server/src/Program.cs	Registers the new IoT Hub area and adjusts console logging behavior.
servers/Azure.Mcp.Server/README.md	Adds IoT Hub to the supported services list.
servers/Azure.Mcp.Server/docs/e2eTestPrompts.md	Adds e2e prompts for IoT Hub device list tool.
servers/Azure.Mcp.Server/docs/azmcp-commands.md	Documents the new `azmcp iothub device list` command.
servers/Azure.Mcp.Server/CHANGELOG.md	Adds changelog entry for the new IoT Hub command.
package.json	Adds root Node dependency on `@azure/mcp`.
package-lock.json	Locks root Node dependency graph for `@azure/mcp`.
dotnet-tools.json	Adds a dotnet tool manifest with the `azmcp` tool.
Directory.Packages.props	Adds IoTHub ARM SDK package version and bumps OTel exporter version.
core/Azure.Mcp.Core/src/Services/Http/HttpClientService.cs	Redirects debug output to stderr to avoid corrupting stdout JSON.
core/Azure.Mcp.Core/src/Areas/Server/Resources/consolidated-tools.json	Adds consolidated mapping entry for the new IoT Hub device list tool.
.vscode/settings.json	Adds VS Code MCP sampling config for a local IoT Hub-only server profile.
.vscode/mcp.json	Adds a local MCP server config to run Azure.Mcp.Server filtered to `iothub`.
.github/CODEOWNERS	Adds CODEOWNERS entries for the new IoT Hub toolset.

Iris20050110 · 2026-07-16T22:19:10Z

@microsoft-github-policy-service agree company="Microsoft"

The tenant and credential are removed because they are never being used. Removed unused dependencies Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>

Remove unused namespace Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>

Update agent description Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>

Removed unused logger Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>

Removed nonexist dependency Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>

Update Absolute Path to Relative Path Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>

Try dotnet build, if failed, install the relevant packages Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>

…merge

…dated proxy mode

…playback-safe hub name

jichang1 · 2026-07-28T23:28:53Z

@@ -0,0 +1,16 @@
+{
+  "servers": {
+    "iris-local-mcp": {


remove the files in .vscode

jichang1 · 2026-07-28T23:41:31Z

 ```
+### Azure IoT Hub Operations
+
+#### Device Registry Operations


Add all IoT Hub Operations in one place.
There's an Azure service named 'Azure Device Registry' so lets not use the same command group name. Could you please sync with Adarsh if sth like 'Device Identity' works

jichang1 · 2026-07-28T23:44:19Z

    {
      "name": "get_azure_iot_hub",
-      "description": "Get details about an Azure IoT Hub.",
+      "description": "Get details about an Azure IoT Hub and list devices registered in its device registry.",


Does this mean 'get iot hub' command also pulls devices?

jichang1 · 2026-07-29T00:45:08Z

@@ -0,0 +1,16 @@
+{


Could you please capture a screenshot of the evaluator run with the ranking score and post to the PR description

Copilot AI review requested due to automatic review settings July 16, 2026 20:47

Iris20050110 requested review from a team as code owners July 16, 2026 20:47

Iris20050110 requested review from KarishmaGhiya, g2vinay, hallipr, jairmyree, tmeschter, vukelich and xirzec July 16, 2026 20:47

Copilot started reviewing on behalf of Iris20050110 July 16, 2026 20:48 View session

Copilot AI reviewed Jul 16, 2026

View reviewed changes

Iris20050110 added the tools-IoTHub on-boarding IoTHub Toolset label Jul 21, 2026

Iris20050110 and others added 14 commits July 21, 2026 16:40

Potential fix for pull request finding

5a3655f

The tenant and credential are removed because they are never being used. Removed unused dependencies Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>

Potential fix for pull request finding

d03f3e6

Remove unused namespace Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>

Potential fix for pull request finding

9cc7619

Remove unused namespace Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>

Potential fix for pull request finding

1eb21b2

Update agent description Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>

Potential fix for pull request finding

1e49c9b

Removed unused logger Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>

Potential fix for pull request finding

eeb8845

Removed nonexist dependency Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>

Potential fix for pull request finding

6b0a429

Update Absolute Path to Relative Path Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>

Potential fix for pull request finding

f109273

Try dotnet build, if failed, install the relevant packages Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>

Merge remote-tracking branch 'upstream/main' into iothub-devicelist

e6adfb3

Merge branch 'main' into iothub-devicelist

7e03834

Fix main merge breakage: migrate device-list to new tool design

7d7c5b2

Merge branch 'main' into iothub-devicelist

9d3a06d

Remove stray Azure.Mcp.Core consolidated-tools.json orphaned by #3137 …

5243c64

…merge

Register iothub_device_list in consolidated-tools.json to fix consoli…

212d095

…dated proxy mode

Iris20050110 added 3 commits July 24, 2026 02:37

Fix camel case for property name

eb78a4f

Add iothub device-list live test recording; use ResourceBaseName for …

38b52ef

…playback-safe hub name

Merge remote-tracking branch 'upstream/main' into iothub-devicelist

43cdbee

jichang1 reviewed Jul 28, 2026

View reviewed changes

Comment thread .vscode/mcp.json

@@ -0,0 +1,16 @@

{

"servers": {

"iris-local-mcp": {

jichang1 Jul 28, 2026

Copy link
Copy Markdown

Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

remove the files in .vscode

jichang1 reviewed Jul 28, 2026

View reviewed changes

jichang1 reviewed Jul 29, 2026

View reviewed changes

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

Add IoT Hub device list command - #3074

Add IoT Hub device list command#3074
Iris20050110 wants to merge 18 commits into
mainfrom
iothub-devicelist

Iris20050110 commented Jul 16, 2026 •

edited

Loading

Uh oh!

Copilot AI left a comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Iris20050110 commented Jul 16, 2026

Uh oh!

jichang1 Jul 28, 2026

Uh oh!

jichang1 Jul 28, 2026 •

edited

Loading

Uh oh!

jichang1 Jul 28, 2026

Uh oh!

jichang1 Jul 29, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

Uh oh!

Conversation

Iris20050110 commented Jul 16, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

What does this PR do?

GitHub issue number?

Pre-merge Checklist

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Invoking Livetests

Reviewed changes

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Iris20050110 commented Jul 16, 2026

Uh oh!

jichang1 Jul 28, 2026

Choose a reason for hiding this comment

Uh oh!

jichang1 Jul 28, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

jichang1 Jul 28, 2026

Choose a reason for hiding this comment

Uh oh!

jichang1 Jul 29, 2026

Choose a reason for hiding this comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

Iris20050110 commented Jul 16, 2026 •

edited

Loading

jichang1 Jul 28, 2026 •

edited

Loading