Skip to main content
Digital Advisor API

Get started with the Digital Advisor MCP server

Contributors netapp-aoife

Configure the Digital Advisor Model Context Protocol (MCP) server in your MCP client application to securely access Digital Advisor information using MCP tools.

Prerequisites

Before configuring the Digital Advisor MCP server, verify the following:

  • You have access to Digital Advisor.

  • You are registered for Digital Advisor API access.

  • You have been approved to use the MCP server by registering with the Active IQ MCP and Digital Coach Early Access Program.

  • You have an active Digital Advisor personal access token. If you don't already have a token, follow the steps to generate your personal access token.

  • Your application supports remote HTTP MCP servers and custom request headers.

Configure your MCP client

Use the following steps to add the Digital Advisor MCP server to your MCP client configuration.

Steps
  1. Open the MCP configuration file for your MCP client.

  2. Add the Digital Advisor MCP server, and then save the file.

    The following example shows how to add the Digital Advisor MCP server to the MCP configuration file in Visual Studio Code.

    {
      "servers": {
        "netapp-digital-advisor": {
          "url": "MCP_ENDPOINT_URL",
          "type": "http",
          "headers": {
            "Authorization": "YOUR_PERSONAL_ACCESS_TOKEN"
          }
        }
      },
      "inputs": []
    }
  3. Restart or reload your MCP client so that it connects to the server.

  4. Confirm that the Digital Advisor tools are listed in your MCP client.

Caution

Your configuration file contains a credential. Do not share it or commit it to source control. Revoke the token immediately if you believe it was exposed using the steps in Revoke a personal access token.

Available tools

The following tools are available from the Digital Advisor MCP server. Most tools require an identifier that you can obtain by using the search tool first.

  • Results are limited to the Digital Advisor information that the authenticated user is authorized to access.

  • Search text must contain between 3 to 50 supported characters.

  • Tools that return multiple records might require pagination to retrieve the complete result set.

  • The capacityForecast tool accepts one cluster or one system per request.

  • The capacity tool includes only systems with recent AutoSupport data.

  • AutoSupport raw section content is truncated at 1MB.

Tool Description

search

Finds system, cluster, customer, site, and watchlist identifiers for use with other tools. Supports cluster, customer, customer group, hostname, serial number, site, system ID, and watchlist searches.

summary

Returns fleet-wide counts and summaries for systems, clusters, sites, platforms, AutoSupport status, ONTAP upgrades, contract renewals, end-of-support dates, and risks.

inventory

Returns node-level inventory information, including system health, hardware model, operating system, platform type, AutoSupport status, contract details, cluster membership, and recommendations.

capacity

Returns current ONTAP, E-Series, and StorageGRID capacity. Capacity values are returned in KiB. Only systems that sent AutoSupport data within the previous 60 days are included.

capacityForecast

Returns 18 months of capacity information, which includes 12 months of historical data and a 6-month forecast, for one ONTAP cluster, ONTAP system, or StorageGRID system.

risks

Returns Digital Advisor wellness risks that cover security, ransomware, performance, availability, capacity, configuration, protection, efficiency, interoperability, and sustainability. Results include severity and corrective actions.

cases

Returns support case details, including status, priority, subject, resolution, reporter, associated system, and RMA part information when available.

volumes

Returns ONTAP volume details, such as state, capacity, encryption, autonomous ransomware protection, efficiency features, protocols, provisioning, workloads, and recommendations.

autosupport

Returns AutoSupport messages for ONTAP, E-Series, and StorageGRID. Lists AutoSupport records, lists the sections in a selected record, or retrieves raw section content.

ontapClusters

Returns ONTAP cluster details, including cluster name, ONTAP version, management IP address, member nodes, and available upgrade recommendations.

upgradeAdvisor

Provides ONTAP upgrade readiness information, including risks and blockers for a target ONTAP version, and pre-upgrade checks with warnings and blockers.

execute

Runs read-only GraphQL queries against the platform for advanced or custom data retrieval beyond what the standard tools provide.

introspect

Explores the GraphQL schema to discover available query fields, types, and data structures for building custom queries.

feedback

Submits feedback about tools, including data errors, missing features, or improvement suggestions.

Note: Do not include any customer identifiable information or personal identifiable information in the feedback submission.