Getting started with watsonx.data intelligence MCP server

Securely access, explore your data, and complete tasks across data governance and catalog, data quality, data lineage, and Data Product Hub through natural language by using IBM watsonx.data intelligence Model Context Protocol (MCP) server and an AI agent of your choice.

Connection models

Watsonx.data intelligence supports one MCP server connection model.

Remote MCP server (managed)
The remote MCP server is a hosted within the watsonx.data intelligence cluster.

Configuration workflow

Follow the workflow to set up the remote MCP server and and AI agent of your choice.

  1. Configure the client to authenticate by using your API credentials. For more information, see Generating API keys and Available APIs. Authentication is required to ensure that the tool access is authorized and scoped to your user or service identity.

  2. Register the managed MCP server as a remote MCP server in the configuration of your AI agent.
    You can configure an AI agent. This list includes, but is not limited to the following agents:

    For other agents, you can configure the MCP server by using environment variables or an .env file. For more information, see MCP configuration file and environment variables.

  3. Optional: Set up skills as described in Setting up and using skills.

Capabilities

Ask your AI agent to list the tasks that it can help you complete.

Tools

You can use tools across the following areas to complete tasks:

  • Connection management
  • Data product management
  • Data protection and governance
  • Data quality
  • Lineage
  • Semantic search and query
  • Text-to-SQL
  • Metadata enrichment
  • Metadata import
  • Project and container management
  • Search and discovery
  • Reporting
  • Workflow management

For a detailed tools list with descriptions and prompts, see MCP Tools Reference.

To add and use custom tools, see Adding custom tools to the managed MCP server.

Skills

Skills are modular, reusable capabilities that provide AI agents with specialized instructions how to perform specific tasks. To use skills, you must download the skills folder and copy its contents to a location based on the requirements of your AI agent as described in Setting up and using skills.

For a detailed skills list with descriptions and prompts, see MCP Skills

Understanding the interaction model

The MCP server enables conversational data access through the following workflow:

  • You submit a natural language query to your agent.
  • The agent interprets your request and selects the appropriate MCP tool.
  • The MCP server executes the operation against your watsonx.data intelligence instance.
  • Results are returned to the agent.
  • The agent presents the results in a conversational format.