Skip to content

[BUG] CLI tools JSON reports every option type as string #3768

Closed

Description

Describe the bug

The CLI tools JSON for Azure MCP Server 3.0.0-beta.44 reports every option as "type": "string", including options whose authoritative C# types are arrays, integers, booleans, a 64-bit integer, or enums.

This causes generated CLI parameter documentation to publish incorrect types.

Evidence

The committed beta.44 snapshot is here:

https://github.com/diberry/microsoft-mcp-doc-generation/blob/main/mcp-cli-metadata/3.0.0-beta.44%2B32200bb8396d0f7dcbebc7f6d96a38fc147881d1/cli-output.json

Snapshot summary:

  • Version/source commit: 3.0.0-beta.44+32200bb8396d0f7dcbebc7f6d96a38fc147881d1
  • ADME tools: 8
  • ADME option entries: 70
  • Distinct reported option types: only string
  • Entire snapshot option entries: 2,841
  • Distinct reported option types across the entire snapshot: only string

Representative ADME mismatches:

Command Option CLI JSON type Source type
adme schema list --status string SchemaStatus?
adme schema list --schema-version-major string int?
adme schema list --latest-version string bool
adme search --kind string string[]
adme search --cursor-pagination-mode string bool
adme search --returned-fields string string[]?
adme storage record fetch --ids string string[]
adme storage record fetch --frame-of-reference string bool
adme storage record get --version string long?
adme storage record list --limit string int?

Authoritative beta.44 source at commit 32200bb8396d0f7dcbebc7f6d96a38fc147881d1:

Expected behavior

Each option's type in the CLI JSON should reflect its actual option type (including collection, numeric, boolean, and enum types) so downstream consumers can generate accurate parameter documentation and validation.

Actual behavior

Every option has "type": "string" in the beta.44 CLI JSON snapshot.

Impact

Downstream documentation generation renders the CLI JSON type value verbatim, so non-string ADME parameters are documented incorrectly unless manually corrected from source.

Activity

  1. added
    needs-team-attentionWorkflow: This issue needs attention from Azure service team or MCP team.
    questionFurther information is requested
    tools-CoreAZMCP Core functionality that all other tools build on top of
    on Sep 23, 2026
  2. github-actions commented on Sep 23, 2026

    @github-actions
    Contributor

    Thanks for the feedback! We are routing this to the appropriate team for follow-up. cc Alan Zimmer (@alzimmermsft) Vinay Gera (@g2vinay) @microsoft/azure-mcp.

  3. added a commit that references this issue on Sep 28, 2026
    a9a215d
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Labels

customer-reportedneeds-team-attentionWorkflow: This issue needs attention from Azure service team or MCP team.questionFurther information is requestedserver-Azure.McpAzure.Mcp.Servertools-CoreAZMCP Core functionality that all other tools build on top of

Type

No type

Projects

No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions