Skip to content

deltaforge-mcp

Plugs DeltaForge into any MCP-compatible AI assistant. Exposes your Delta Lake catalog, pipeline graph, lineage, and query execution as typed tools an AI can call directly. No custom prompts, no clipboard-pasting schemas.

Signed binaries for every platform: deltaforge-org/delta-forge on GitHub

Install

curl -fsSL https://deltaforge.org/install.sh | sh -s -- --pkg deltaforge-mcp

Or via Homebrew (add the DeltaForge tap once, then install deltaforge-mcp as a formula):

# Add the tap (one-time)
brew tap deltaforge-org/tap
brew install deltaforge-mcp

Tap source: github.com/deltaforge-org/homebrew-tap

PowerShell
iwr -useb https://deltaforge.org/install.ps1 | iex; Install-DeltaForge -Pkg deltaforge-mcp

Or via winget (installs the signed binary into your PATH) or Scoop (the preferred choice for portable, no-admin installs):

winget
winget install DeltaForge.Mcp
Scoop
# Add the bucket (one-time, skip if already added)
scoop bucket add deltaforge https://github.com/deltaforge-org/scoop-bucket
scoop install deltaforge-mcp

Detects your architecture (x64 or ARM64) and downloads the matching binary. --pkg deltaforge-mcp selects the MCP server instead of the default CLI package:

curl -fsSL https://deltaforge.org/install.sh | sh -s -- --pkg deltaforge-mcp

Wire it into your AI assistant

Point your AI assistant's MCP config at the server binary. The format is the same across all MCP-compatible tools.

mcp config
{
  "mcpServers": {
    "deltaforge": {
      "command": "deltaforge-mcp",
      "args": ["--workspace", "your-workspace-id"]
    }
  }
}

Claude Desktop

Add the config block to claude_desktop_config.json: ~/Library/Application Support/Claude/ on macOS or %APPDATA%\Claude\ on Windows. Restart Claude Desktop to pick it up.

Cursor

Open Cursor Settings, navigate to the MCP section, and paste the config block. Cursor reloads MCP servers without restarting, so the tools become available immediately.

VS Code with Copilot

Add the config block to your workspace or user settings.json under the mcp.servers key. The Copilot chat panel picks up the server on the next activation.

Full reference of exposed tools: MCP server documentation. Other packages: install hub.

Got it installed. What now?

Register a workspace in the console, point it at a Git repo with SQL in it, and run your first query.