IBM/data-intelligence-mcp-server

The IBM Data Intelligence MCP Server provides a modular and scalable implementation of the Model Context Protocol (MCP), purpose-built to integrate with IBM Data Intelligence services. It enables secure and extensible interaction between MCP clients and IBM's data intelligence capabilities.
For the list of tools supported in this version and sample prompts, refer to TOOLS_PROMPTS.md
For the list of skills supported in this version and instructions on how to use them, refer to SKILLS_REFERENCE.md
> **Note**: For MCP clients that don't support MCP prompts template registration, manual prompt templates are available in the PROMPTS_TEMPLATE_SAMPLES/ directory.
Resources:
- Integrating Claude with Watsonx Data Intelligence A step-by-step guide showing how Claude Desktop connects to the Data Intelligence MCP Server.
- Watsonx Orchestrate + Data Intelligence Demonstrates how Watsonx Orchestrate integrates with the MCP Server for automation.
- IBM Bob + Data Intelligence A step-by-step guide showing how IBM Bob connects to the Data Intelligence MCP Server.
---
Table of Contents
1. Quick Install - PyPI
- Prerequisites
- Installation
2. Quick Install - uvx
- Prerequisites
- Installation
3. Server
- HTTP Mode
- HTTPS Mode
4. Client Configuration
- Claude Desktop
- stdio (Recommended for local setup)
- http/https (Remote setup)
- VS Code Copilot
- stdio (Recommended for local setup)
- http/https (Remote setup)
- Watsonx Orchestrate
- IBM Bob
5. Configuration
- Client Settings
- SSL/TLS Configuration
6. Tool Groups
- Available Groups
- HTTP Mode — x-tool-groups Header
- stdio Mode — TOOL_GROUPS Environment Variable
7. Privacy Policy
---
Quick Install - PyPI
Prerequisites
- Python 3.11 or higher
- Data Intelligence SaaS or CPD 5.2.1
Installation
Standard Installation
Use pip/pip3 for standard installation:
Skills Setup (Optional)
After installation, you can copy the included skills folder to your location for easy access:
This interactive command will:
- Ask for your confirmation before copying
- Copy the skills folder to your given location
- Handle overwrites if the folder already exists
---
Quick Install and run - uv
Prerequisites
- uv installation guide
- Data Intelligence SaaS or CPD 5.2.1
Install and Running
stdio mode
http mode
To setup skills (optional):
---
Server
If you have installed the ibm-watsonx-data-intelligence-mcp-server locally on your host machine and want to connect from a client such as Claude, Copilot, or LMStudio, you can use the stdio mode as described in the examples under the Client Configuration section.
The server can also be configured and run in http/https mode.
Refer to Client Settings section on applicable environment variables for http mode. Update as required before starting the server below. Default DI_ENV_MODE is SaaS
HTTP Mode
HTTPS Mode
Refer to SERVER_HTTPS.md for detailed HTTPS server configuration and setup.
stdio Mode
When configuring the server through Claude, Copilot, or an MCP client in **stdio mode**, the server does not need to be started separately. The client will invoke the server directly using standard input/output.
---
Client Configuration
Claude Desktop
stdio (Recommended for local mcp server setup)
Prereq: uv installation guide
Add the MCP server to your Claude Desktop configuration:
http/https (Remote setup)
If the MCP server is running on a local/remote server in http/https mode.
For Cloud SaaS:
For CPD:
VS Code Copilot
stdio (Recommended for local mcp server setup)
Prereq: uv installation guide
Add the MCP server to your VS Code Copilot MCP configuration:
http/https (Remote setup)
If the MCP server is running on a local/remote server in http/https mode.
For Cloud SaaS:
For CPD:
Watsonx Orchestrate
Watsonx Orchestrate + Data Intelligence blog post demonstrates how Watsonx Orchestrate integrates with the MCP Server for automation.