iceDQ MCP Server

Connect your AI assistant to the iceDQ Data Reliability Platform

Website  •  Documentation  •  Support  •  Privacy Policy

What Is This?

The iceDQ MCP Server lets you manage your entire data quality lifecycle through conversation with an AI assistant. Ask it to explore your data sources, create validation rules, run reconciliations, monitor executions, and analyze results — no UI switching required.

48 tools covering the full data quality lifecycle, grouped by what they do (see manifest.json for the exact tool names and descriptions the assistant calls):

(The 48th tool, get_guidance, isn't listed above — the assistant calls it internally before complex multi-step operations; it's not something you ask for directly.)

Compatibility

Per the v1.0.0 release notes:

Recommended AI model: Claude Sonnet 4 or higher, for the most accurate rule creation and workflow understanding.

Before You Start: Get Your iceDQ Credentials

Every install method below needs the same values from your iceDQ instance. See the Credentials Guide for exactly where to find each one in the iceDQ UI, and the Authentication Guide for how the two auth modes differ.

Optional: VERIFY_SSL (default true; set "false" only for self-signed certs), REQUEST_TIMEOUT (default 60 seconds), DEBUG (default false).

Base URL has no default. Every organization runs its own iceDQ instance — the https://app.icedq.net value used throughout this guide's examples is illustrative only, not a shared cloud endpoint. Always replace it with your own instance's URL.

If you're launching via npx (every client below except Claude Desktop's packaged extension), also set NODE_OPTIONS=--use-system-ca in the env block — this is in every official config example and avoids TLS errors on machines with a corporate root CA installed.

Installation

Jump to your client:

• Claude Desktop
• VS Code + GitHub Copilot Chat
• VS Code + Claude Code
• Cursor

Each section below is a condensed quick-start. For the full walkthrough with screenshots and troubleshooting, follow the linked guide on docs.icedq.com.

Claude Desktop

📖 Full guide: Setup in Claude Desktop

Two paths — Path A (recommended) installs a packaged .mcpb extension with a settings form and stores your password in your OS keychain; Path B hand-edits a config file and needs Node.js 18+.

Path A: Download the .mcpb from the Releases page, then in Claude Desktop go to Settings → Extensions → Install Extension and select the file. Fill in the credentials form that appears and click Save.

Path B: Edit claude_desktop_config.json (Windows: %APPDATA%\Claude\claude_desktop_config.json, macOS: ~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "icedq": {
      "command": "npx",
      "args": ["-y", "@icedq/mcp-server"],
      "env": {
        "ICEDQ_BASE_URL": "https://app.icedq.net",
        "ICEDQ_REALM": "icedq",
        "ICEDQ_CLIENT_ID": "your-client-id",
        "ICEDQ_CLIENT_SECRET": "your-client-secret",
        "AUTH_TYPE": "username_password",
        "ICEDQ_USERNAME": "your-username",
        "ICEDQ_PASSWORD": "your-password",
        "ICEDQ_ORG_ID": "your-org-id"
      }
    }
  }
}

Fully quit and reopen Claude Desktop (closing the window isn't enough), then verify with List my iceDQ workspaces.

VS Code + GitHub Copilot Chat

📖 Full guide: Setup in VS Code & Cursor

Requires Node.js 18+ and the GitHub Copilot Chat extension, installed and signed in.

1. Command Palette (Ctrl+Shift+P / Cmd+Shift+P) → MCP: Open user configuration → opens mcp.json.
2. Add: