Microsoft Azure Recommendations API Client — Recommendations

naftiko: 1.0.0-alpha2
info:
  label: Microsoft Azure Recommendations API Client — Recommendations
  description: 'Microsoft Azure Recommendations API Client — Recommendations. 15 operations. Lead operation: Microsoft Azure
    List All Recommendations For A Subscription. Self-contained Naftiko capability covering one Microsoft Azure business surface.'
  tags:
  - Microsoft Azure
  - Recommendations
  created: '2026-05-19'
  modified: '2026-05-19'
binds:
- namespace: env
  keys:
    MICROSOFT_AZURE_API_KEY: MICROSOFT_AZURE_API_KEY
capability:
  consumes:
  - type: http
    namespace: recommendations-api-client-recommendations
    baseUri: https://management.azure.com
    description: Microsoft Azure Recommendations API Client — Recommendations business capability. Self-contained, no shared
      references.
    resources:
    - name: subscriptions-subscriptionId-providers-Microsoft.Web-recommendations
      path: /subscriptions/{subscriptionId}/providers/Microsoft.Web/recommendations
      operations:
      - name: microsoftazurerecommendationslist
        method: GET
        description: Microsoft Azure List All Recommendations For A Subscription
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: featured
          in: query
          type: boolean
          description: Specify <code>true</code> to return only the most critical recommendations. The default is <code>false</code>,
            which returns all recommendations.
        - name: $filter
          in: query
          type: string
          description: 'Filter is specified by using OData syntax. Example: $filter=channel eq ''Api'' or channel eq ''Notification''
            and startTime eq 2014-01-01T00:00:00Z and endTime eq 2'
    - name: subscriptions-subscriptionId-providers-Microsoft.Web-recommendations-reset
      path: /subscriptions/{subscriptionId}/providers/Microsoft.Web/recommendations/reset
      operations:
      - name: microsoftazurerecommendationsresetallfilters
        method: POST
        description: Microsoft Azure Reset All Recommendation Opt Out Settings For A Subscription
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: subscriptions-subscriptionId-providers-Microsoft.Web-recommendations-name-disabl
      path: /subscriptions/{subscriptionId}/providers/Microsoft.Web/recommendations/{name}/disable
      operations:
      - name: microsoftazurerecommendationsdisablerecommendationforsubscription
        method: POST
        description: Microsoft Azure Disables The Specified Rule So It Will Not Apply To A Subscription In The Future
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: name
          in: path
          type: string
          description: Rule name
          required: true
    - name: subscriptions-subscriptionId-resourceGroups-resourceGroupName-providers-Microsof
      path: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/hostingEnvironments/{hostingEnvironmentName}/recommendationHistory
      operations:
      - name: microsoftazurerecommendationslisthistoryforhostingenvironment
        method: GET
        description: Microsoft Azure Get Past Recommendations For An App, Optionally Specified By The Time Range
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: hostingEnvironmentName
          in: path
          type: string
          description: Name of the hosting environment.
          required: true
        - name: expiredOnly
          in: query
          type: boolean
          description: Specify <code>false</code> to return all recommendations. The default is <code>true</code>, which returns
            only expired recommendations.
        - name: $filter
          in: query
          type: string
          description: 'Filter is specified by using OData syntax. Example: $filter=channel eq ''Api'' or channel eq ''Notification''
            and startTime eq 2014-01-01T00:00:00Z and endTime eq 2'
    - name: subscriptions-subscriptionId-resourceGroups-resourceGroupName-providers-Microsof
      path: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/hostingEnvironments/{hostingEnvironmentName}/recommendations
      operations:
      - name: microsoftazurerecommendationslistrecommendedrulesforhostingenvironment
        method: GET
        description: Microsoft Azure Get All Recommendations For A Hosting Environment
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: hostingEnvironmentName
          in: path
          type: string
          description: Name of the app.
          required: true
        - name: featured
          in: query
          type: boolean
          description: Specify <code>true</code> to return only the most critical recommendations. The default is <code>false</code>,
            which returns all recommendations.
        - name: $filter
          in: query
          type: string
          description: 'Return only channels specified in the filter. Filter is specified by using OData syntax. Example:
            $filter=channel eq ''Api'' or channel eq ''Notification'''
    - name: subscriptions-subscriptionId-resourceGroups-resourceGroupName-providers-Microsof
      path: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/hostingEnvironments/{hostingEnvironmentName}/recommendations/disable
      operations:
      - name: microsoftazurerecommendationsdisableallforhostingenvironment
        method: POST
        description: Microsoft Azure Disable All Recommendations For An App
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: environmentName
          in: query
          type: string
          description: Name of the app.
          required: true
        - name: hostingEnvironmentName
          in: path
          type: string
          required: true
    - name: subscriptions-subscriptionId-resourceGroups-resourceGroupName-providers-Microsof
      path: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/hostingEnvironments/{hostingEnvironmentName}/recommendations/reset
      operations:
      - name: microsoftazurerecommendationsresetallfiltersforhostingenvironment
        method: POST
        description: Microsoft Azure Reset All Recommendation Opt Out Settings For An App
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: environmentName
          in: query
          type: string
          description: Name of the app.
          required: true
        - name: hostingEnvironmentName
          in: path
          type: string
          required: true
    - name: subscriptions-subscriptionId-resourceGroups-resourceGroupName-providers-Microsof
      path: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/hostingEnvironments/{hostingEnvironmentName}/recommendations/{name}
      operations:
      - name: microsoftazurerecommendationsgetruledetailsbyhostingenvironment
        method: GET
        description: Microsoft Azure Get A Recommendation Rule For An App
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: hostingEnvironmentName
          in: path
          type: string
          description: Name of the hosting environment.
          required: true
        - name: name
          in: path
          type: string
          description: Name of the recommendation.
          required: true
        - name: updateSeen
          in: query
          type: boolean
          description: Specify <code>true</code> to update the last-seen timestamp of the recommendation object.
        - name: recommendationId
          in: query
          type: string
          description: The GUID of the recommendation object if you query an expired one. You don't need to specify it to
            query an active entry.
    - name: subscriptions-subscriptionId-resourceGroups-resourceGroupName-providers-Microsof
      path: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/hostingEnvironments/{hostingEnvironmentName}/recommendations/{name}/disable
      operations:
      - name: microsoftazurerecommendationsdisablerecommendationforhostingenvironment
        method: POST
        description: Microsoft Azure Disables The Specific Rule For A Web Site Permanently
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: environmentName
          in: query
          type: string
          description: Site name
          required: true
        - name: name
          in: path
          type: string
          description: Rule name
          required: true
        - name: hostingEnvironmentName
          in: path
          type: string
          required: true
    - name: subscriptions-subscriptionId-resourceGroups-resourceGroupName-providers-Microsof
      path: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{siteName}/recommendationHistory
      operations:
      - name: microsoftazurerecommendationslisthistoryforwebapp
        method: GET
        description: Microsoft Azure Get Past Recommendations For An App, Optionally Specified By The Time Range
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: siteName
          in: path
          type: string
          description: Name of the app.
          required: true
        - name: expiredOnly
          in: query
          type: boolean
          description: Specify <code>false</code> to return all recommendations. The default is <code>true</code>, which returns
            only expired recommendations.
        - name: $filter
          in: query
          type: string
          description: 'Filter is specified by using OData syntax. Example: $filter=channel eq ''Api'' or channel eq ''Notification''
            and startTime eq 2014-01-01T00:00:00Z and endTime eq 2'
    - name: subscriptions-subscriptionId-resourceGroups-resourceGroupName-providers-Microsof
      path: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{siteName}/recommendations
      operations:
      - name: microsoftazurerecommendationslistrecommendedrulesforwebapp
        method: GET
        description: Microsoft Azure Get All Recommendations For An App
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: siteName
          in: path
          type: string
          description: Name of the app.
          required: true
        - name: featured
          in: query
          type: boolean
          description: Specify <code>true</code> to return only the most critical recommendations. The default is <code>false</code>,
            which returns all recommendations.
        - name: $filter
          in: query
          type: string
          description: 'Return only channels specified in the filter. Filter is specified by using OData syntax. Example:
            $filter=channel eq ''Api'' or channel eq ''Notification'''
    - name: subscriptions-subscriptionId-resourceGroups-resourceGroupName-providers-Microsof
      path: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{siteName}/recommendations/disable
      operations:
      - name: microsoftazurerecommendationsdisableallforwebapp
        method: POST
        description: Microsoft Azure Disable All Recommendations For An App
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: siteName
          in: path
          type: string
          description: Name of the app.
          required: true
    - name: subscriptions-subscriptionId-resourceGroups-resourceGroupName-providers-Microsof
      path: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{siteName}/recommendations/reset
      operations:
      - name: microsoftazurerecommendationsresetallfiltersforwebapp
        method: POST
        description: Microsoft Azure Reset All Recommendation Opt Out Settings For An App
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: siteName
          in: path
          type: string
          description: Name of the app.
          required: true
    - name: subscriptions-subscriptionId-resourceGroups-resourceGroupName-providers-Microsof
      path: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{siteName}/recommendations/{name}
      operations:
      - name: microsoftazurerecommendationsgetruledetailsbywebapp
        method: GET
        description: Microsoft Azure Get A Recommendation Rule For An App
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: siteName
          in: path
          type: string
          description: Name of the app.
          required: true
        - name: name
          in: path
          type: string
          description: Name of the recommendation.
          required: true
        - name: updateSeen
          in: query
          type: boolean
          description: Specify <code>true</code> to update the last-seen timestamp of the recommendation object.
        - name: recommendationId
          in: query
          type: string
          description: The GUID of the recommendation object if you query an expired one. You don't need to specify it to
            query an active entry.
    - name: subscriptions-subscriptionId-resourceGroups-resourceGroupName-providers-Microsof
      path: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{siteName}/recommendations/{name}/disable
      operations:
      - name: microsoftazurerecommendationsdisablerecommendationforsite
        method: POST
        description: Microsoft Azure Disables The Specific Rule For A Web Site Permanently
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: siteName
          in: path
          type: string
          description: Site name
          required: true
        - name: name
          in: path
          type: string
          description: Rule name
          required: true
  exposes:
  - type: rest
    namespace: recommendations-api-client-recommendations-rest
    port: 8080
    description: REST adapter for Microsoft Azure Recommendations API Client — Recommendations. One Spectral-compliant resource
      per consumed operation, prefixed with /v1.
    resources:
    - path: /v1/subscriptions/{subscriptionid}/providers/microsoft-web/recommendations
      name: subscriptions-subscriptionid-providers-microsoft-web-recommendations
      description: REST surface for subscriptions-subscriptionId-providers-Microsoft.Web-recommendations.
      operations:
      - method: GET
        name: microsoftazurerecommendationslist
        description: Microsoft Azure List All Recommendations For A Subscription
        call: recommendations-api-client-recommendations.microsoftazurerecommendationslist
        with:
          featured: rest.featured
          $filter: rest.$filter
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/subscriptions/{subscriptionid}/providers/microsoft-web/recommendations/reset
      name: subscriptions-subscriptionid-providers-microsoft-web-recommendations-reset
      description: REST surface for subscriptions-subscriptionId-providers-Microsoft.Web-recommendations-reset.
      operations:
      - method: POST
        name: microsoftazurerecommendationsresetallfilters
        description: Microsoft Azure Reset All Recommendation Opt Out Settings For A Subscription
        call: recommendations-api-client-recommendations.microsoftazurerecommendationsresetallfilters
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/subscriptions/{subscriptionid}/providers/microsoft-web/recommendations/{name}/disable
      name: subscriptions-subscriptionid-providers-microsoft-web-recommendations-name-disabl
      description: REST surface for subscriptions-subscriptionId-providers-Microsoft.Web-recommendations-name-disabl.
      operations:
      - method: POST
        name: microsoftazurerecommendationsdisablerecommendationforsubscription
        description: Microsoft Azure Disables The Specified Rule So It Will Not Apply To A Subscription In The Future
        call: recommendations-api-client-recommendations.microsoftazurerecommendationsdisablerecommendationforsubscription
        with:
          name: rest.name
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/subscriptions/{subscriptionid}/resourcegroups/{resourcegroupname}/providers/microsoft-web/hostingenvironments/{hostingenvironmentname}/recommendationhistory
      name: subscriptions-subscriptionid-resourcegroups-resourcegroupname-providers-microsof
      description: REST surface for subscriptions-subscriptionId-resourceGroups-resourceGroupName-providers-Microsof.
      operations:
      - method: GET
        name: microsoftazurerecommendationslisthistoryforhostingenvironment
        description: Microsoft Azure Get Past Recommendations For An App, Optionally Specified By The Time Range
        call: recommendations-api-client-recommendations.microsoftazurerecommendationslisthistoryforhostingenvironment
        with:
          hostingEnvironmentName: rest.hostingEnvironmentName
          expiredOnly: rest.expiredOnly
          $filter: rest.$filter
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/subscriptions/{subscriptionid}/resourcegroups/{resourcegroupname}/providers/microsoft-web/hostingenvironments/{hostingenvironmentname}/recommendations
      name: subscriptions-subscriptionid-resourcegroups-resourcegroupname-providers-microsof
      description: REST surface for subscriptions-subscriptionId-resourceGroups-resourceGroupName-providers-Microsof.
      operations:
      - method: GET
        name: microsoftazurerecommendationslistrecommendedrulesforhostingenvironment
        description: Microsoft Azure Get All Recommendations For A Hosting Environment
        call: recommendations-api-client-recommendations.microsoftazurerecommendationslistrecommendedrulesforhostingenvironment
        with:
          hostingEnvironmentName: rest.hostingEnvironmentName
          featured: rest.featured
          $filter: rest.$filter
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/subscriptions/{subscriptionid}/resourcegroups/{resourcegroupname}/providers/microsoft-web/hostingenvironments/{hostingenvironmentname}/recommendations/disable
      name: subscriptions-subscriptionid-resourcegroups-resourcegroupname-providers-microsof
      description: REST surface for subscriptions-subscriptionId-resourceGroups-resourceGroupName-providers-Microsof.
      operations:
      - method: POST
        name: microsoftazurerecommendationsdisableallforhostingenvironment
        description: Microsoft Azure Disable All Recommendations For An App
        call: recommendations-api-client-recommendations.microsoftazurerecommendationsdisableallforhostingenvironment
        with:
          environmentName: rest.environmentName
          hostingEnvironmentName: rest.hostingEnvironmentName
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/subscriptions/{subscriptionid}/resourcegroups/{resourcegroupname}/providers/microsoft-web/hostingenvironments/{hostingenvironmentname}/recommendations/reset
      name: subscriptions-subscriptionid-resourcegroups-resourcegroupname-providers-microsof
      description: REST surface for subscriptions-subscriptionId-resourceGroups-resourceGroupName-providers-Microsof.
      operations:
      - method: POST
        name: microsoftazurerecommendationsresetallfiltersforhostingenvironment
        description: Microsoft Azure Reset All Recommendation Opt Out Settings For An App
        call: recommendations-api-client-recommendations.microsoftazurerecommendationsresetallfiltersforhostingenvironment
        with:
          environmentName: rest.environmentName
          hostingEnvironmentName: rest.hostingEnvironmentName
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/subscriptions/{subscriptionid}/resourcegroups/{resourcegroupname}/providers/microsoft-web/hostingenvironments/{hostingenvironmentname}/recommendations/{name}
      name: subscriptions-subscriptionid-resourcegroups-resourcegroupname-providers-microsof
      description: REST surface for subscriptions-subscriptionId-resourceGroups-resourceGroupName-providers-Microsof.
      operations:
      - method: GET
        name: microsoftazurerecommendationsgetruledetailsbyhostingenvironment
        description: Microsoft Azure Get A Recommendation Rule For An App
        call: recommendations-api-client-recommendations.microsoftazurerecommendationsgetruledetailsbyhostingenvironment
        with:
          hostingEnvironmentName: rest.hostingEnvironmentName
          name: rest.name
          updateSeen: rest.updateSeen
          recommendationId: rest.recommendationId
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/subscriptions/{subscriptionid}/resourcegroups/{resourcegroupname}/providers/microsoft-web/hostingenvironments/{hostingenvironmentname}/recommendations/{name}/disable
      name: subscriptions-subscriptionid-resourcegroups-resourcegroupname-providers-microsof
      description: REST surface for subscriptions-subscriptionId-resourceGroups-resourceGroupName-providers-Microsof.
      operations:
      - method: POST
        name: microsoftazurerecommendationsdisablerecommendationforhostingenvironment
        description: Microsoft Azure Disables The Specific Rule For A Web Site Permanently
        call: recommendations-api-client-recommendations.microsoftazurerecommendationsdisablerecommendationforhostingenvironment
        with:
          environmentName: rest.environmentName
          name: rest.name
          hostingEnvironmentName: rest.hostingEnvironmentName
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/subscriptions/{subscriptionid}/resourcegroups/{resourcegroupname}/providers/microsoft-web/sites/{sitename}/recommendationhistory
      name: subscriptions-subscriptionid-resourcegroups-resourcegroupname-providers-microsof
      description: REST surface for subscriptions-subscriptionId-resourceGroups-resourceGroupName-providers-Microsof.
      operations:
      - method: GET
        name: microsoftazurerecommendationslisthistoryforwebapp
        description: Microsoft Azure Get Past Recommendations For An App, Optionally Specified By The Time Range
        call: recommendations-api-client-recommendations.microsoftazurerecommendationslisthistoryforwebapp
        with:
          siteName: rest.siteName
          expiredOnly: rest.expiredOnly
          $filter: rest.$filter
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/subscriptions/{subscriptionid}/resourcegroups/{resourcegroupname}/providers/microsoft-web/sites/{sitename}/recommendations
      name: subscriptions-subscriptionid-resourcegroups-resourcegroupname-providers-microsof
      description: REST surface for subscriptions-subscriptionId-resourceGroups-resourceGroupName-providers-Microsof.
      operations:
      - method: GET
        name: microsoftazurerecommendationslistrecommendedrulesforwebapp
        description: Microsoft Azure Get All Recommendations For An App
        call: recommendations-api-client-recommendations.microsoftazurerecommendationslistrecommendedrulesforwebapp
        with:
          siteName: rest.siteName
          featured: rest.featured
          $filter: rest.$filter
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/subscriptions/{subscriptionid}/resourcegroups/{resourcegroupname}/providers/microsoft-web/sites/{sitename}/recommendations/disable
      name: subscriptions-subscriptionid-resourcegroups-resourcegroupname-providers-microsof
      description: REST surface for subscriptions-subscriptionId-resourceGroups-resourceGroupName-providers-Microsof.
      operations:
      - method: POST
        name: microsoftazurerecommendationsdisableallforwebapp
        description: Microsoft Azure Disable All Recommendations For An App
        call: recommendations-api-client-recommendations.microsoftazurerecommendationsdisableallforwebapp
        with:
          siteName: rest.siteName
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/subscriptions/{subscriptionid}/resourcegroups/{resourcegroupname}/providers/microsoft-web/sites/{sitename}/recommendations/reset
      name: subscriptions-subscriptionid-resourcegroups-resourcegroupname-providers-microsof
      description: REST surface for subscriptions-subscriptionId-resourceGroups-resourceGroupName-providers-Microsof.
      operations:
      - method: POST
        name: microsoftazurerecommendationsresetallfiltersforwebapp
        description: Microsoft Azure Reset All Recommendation Opt Out Settings For An App
        call: recommendations-api-client-recommendations.microsoftazurerecommendationsresetallfiltersforwebapp
        with:
          siteName: rest.siteName
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/subscriptions/{subscriptionid}/resourcegroups/{resourcegroupname}/providers/microsoft-web/sites/{sitename}/recommendations/{name}
      name: subscriptions-subscriptionid-resourcegroups-resourcegroupname-providers-microsof
      description: REST surface for subscriptions-subscriptionId-resourceGroups-resourceGroupName-providers-Microsof.
      operations:
      - method: GET
        name: microsoftazurerecommendationsgetruledetailsbywebapp
        description: Microsoft Azure Get A Recommendation Rule For An App
        call: recommendations-api-client-recommendations.microsoftazurerecommendationsgetruledetailsbywebapp
        with:
          siteName: rest.siteName
          name: rest.name
          updateSeen: rest.updateSeen
          recommendationId: rest.recommendationId
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/subscriptions/{subscriptionid}/resourcegroups/{resourcegroupname}/providers/microsoft-web/sites/{sitename}/recommendations/{name}/disable
      name: subscriptions-subscriptionid-resourcegroups-resourcegroupname-providers-microsof
      description: REST surface for subscriptions-subscriptionId-resourceGroups-resourceGroupName-providers-Microsof.
      operations:
      - method: POST
        name: microsoftazurerecommendationsdisablerecommendationforsite
        description: Microsoft Azure Disables The Specific Rule For A Web Site Permanently
        call: recommendations-api-client-recommendations.microsoftazurerecommendationsdisablerecommendationforsite
        with:
          siteName: rest.siteName
          name: rest.name
        outputParameters:
        - type: object
          mapping: $.
  - type: mcp
    namespace: recommendations-api-client-recommendations-mcp
    port: 9090
    transport: http
    description: MCP adapter for Microsoft Azure Recommendations API Client — Recommendations. One tool per consumed operation,
      routed inline through this capability's consumes block.
    tools:
    - name: microsoft-azure-list-all-recommendations
      description: Microsoft Azure List All Recommendations For A Subscription
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: recommendations-api-client-recommendations.microsoftazurerecommendationslist
      with:
        featured: tools.featured
        $filter: tools.$filter
      outputParameters:
      - type: object
        mapping: $.
    - name: microsoft-azure-reset-all-recommendation
      description: Microsoft Azure Reset All Recommendation Opt Out Settings For A Subscription
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: recommendations-api-client-recommendations.microsoftazurerecommendationsresetallfilters
      outputParameters:
      - type: object
        mapping: $.
    - name: microsoft-azure-disables-specified-rule
      description: Microsoft Azure Disables The Specified Rule So It Will Not Apply To A Subscription In The Future
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: recommendations-api-client-recommendations.microsoftazurerecommendationsdisablerecommendationforsubscription
      with:
        name: tools.name
      outputParameters:
      - type: object
        mapping: $.
    - name: microsoft-azure-get-past-recommendations
      description: Microsoft Azure Get Past Recommendations For An App, Optionally Specified By The Time Range
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: recommendations-api-client-recommendations.microsoftazurerecommendationslisthistoryforhostingenvironment
      with:
        hostingEnvironmentName: tools.hostingEnvironmentName
        expiredOnly: tools.expiredOnly
        $filter: tools.$filter
      outputParameters:
      - type: object
        mapping: $.
    - name: microsoft-azure-get-all-recommendations
      description: Microsoft Azure Get All Recommendations For A Hosting Environment
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: recommendations-api-client-recommendations.microsoftazurerecommendationslistrecommendedrulesforhostingenvironment
      with:
        hostingEnvironmentName: tools.hostingEnvironmentName
        featured: tools.featured
        $filter: tools.$filter
      outputParameters:
      - type: object
        mapping: $.
    - name: microsoft-azure-disable-all-recommendations
      description: Microsoft Azure Disable All Recommendations For An App
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: recommendations-api-client-recommendations.microsoftazurerecommendationsdisableallforhostingenvironment
      with:
        environmentName: tools.environmentName
        hostingEnvironmentName: tools.hostingEnvironmentName
      outputParameters:
      - type: object
        mapping: $.
    - name: microsoft-azure-reset-all-recommendation-2
      description: Microsoft Azure Reset All Recommendation Opt Out Settings For An App
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: recommendations-api-client-recommendations.microsoftazurerecommendationsresetallfiltersforhostingenvironment
      with:
        environmentName: tools.environmentName
        hostingEnvironmentName: tools.hostingEnvironmentName
      outputParameters:
      - type: object
        mapping: $.
    - name: microsoft-azure-get-recommendation-rule
      description: Microsoft Azure Get A Recommendation Rule For An App
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: recommendations-api-client-recommendations.microsoftazurerecommendationsgetruledetailsbyhostingenvironment
      with:
        hostingEnvironmentName: tools.hosti

# --- truncated at 32 KB (35 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/microsoft-azure/refs/heads/main/capabilities/recommendations-api-client-recommendations.yaml