DataBridge AI Workbench

### Configure Step

# 📊 Dashboard

341
MCP Tools
--
Projects
--
Workflow Steps
--
Version

### Recent Activity

Timestamp | Tool | Status
--- | --- | ---
Loading...

### Quick Start

Get started with DataBridge AI:

# 📡 Agent Communication Console

Communication Stream
[--:--:--.---] SYSTEM
Agent Communication Console initialized. Ready to process requests. Type a query below or use Quick Actions.

# 🔧 Tool Workbench

### Available Tools

- Loading tools...

### Select a Tool

Choose a tool from the list to configure and run it.

### Output

// Tool output will appear here

# 📁 Hierarchy Projects

### Projects

- Loading projects...

### Select a Project

Choose a project from the list to view its details.

# ⚡ Workflow Editor

### Tool Palette

### Workflow Steps

Click tools to add steps to your workflow.

# ✈️ Wright Pipeline Builder

Build hierarchy-driven data marts with the 4-object pipeline pattern. Configure each step and preview generated SQL.

### Pipeline Configuration

Project Name
Report Type
Account Segment
Target Database
Target Schema
Measure Prefix
Hierarchy Table
Mapping Table
Fact Table
Has Sign Change Has Exclusions Has Group Filter Precedence

### VW_1: Translation View

Translates ID_SOURCE column values to physical database columns using CASE statements.

ID_SOURCE Column Mappings
Additional Columns

    -- Click "Generate" to create VW_1 Translation View SQL

### DT_2: Granularity Table

UNPIVOT operation to normalize data and apply exclusion filters.

Unpivot Measures
Exclusion Categories

    -- Click "Generate" to create DT_2 Granularity Table SQL

### DT_3A: Pre-Aggregation Fact

UNION ALL branches for different join patterns. Each branch handles different dimension combinations.

Join Patterns (UNION ALL Branches)
Branch Name
Hierarchy Filter Columns
Fact Join Keys

    -- Click "Generate" to create DT_3A Pre-Aggregation SQL

### DT_3: Final Data Mart

Final data mart with formula precedence cascade and surrogate key generation.

Formula Precedence Levels
Dimension Keys to Include

    -- Click "Generate" to create DT_3 Data Mart SQL

# ⚙️ Administration

### Configuration

Data Directory
NestJS Backend URL
API Key

# 📚 Documentation & Help

### DataBridge AI v0.39.0

A headless, MCP-native data reconciliation engine with 341 MCP tools across twenty major modules.

#### Core Capabilities

🔄 Data Reconciliation | Compare and validate data from CSV, SQL, PDF, JSON sources
🏗️ Hierarchy Builder | Create and manage multi-level hierarchy projects (up to 15 levels)
🧠 Cortex AI | Snowflake Cortex integration with natural language to SQL
📊 Wright Module | Hierarchy-driven data mart generation with 4-object pipeline
📚 Data Catalog | Centralized metadata registry with business glossary
🔍 Lineage Tracking | Column-level lineage and impact analysis
✅ Data Quality | Expectation suites and data contracts
🔧 dbt Integration | Generate dbt projects from hierarchies

### Quick Start

# Install from PyPI pip install databridge-ai # Run as MCP Server python -m src.server

### Architecture

graph TD A[Claude/LLM Client] --> B[MCP Protocol] B --> C[DataBridge MCP Server] C --> D[Hierarchy Builder] C --> E[Data Reconciliation] C --> F[Cortex AI Agent] C --> G[Wright Module] D --> H[(Snowflake)] E --> I[(CSV/SQL/PDF)] F --> H G --> H

### Tool Categories (341 Tools)

#### 📂 File Discovery & Staging (3 tools)

find_files stage_file get_working_directory

#### 🔄 Data Reconciliation (38 tools)

load_csv load_json query_database profile_data compare_hashes fuzzy_match_columns extract_text_from_pdf ocr_image merge_sources

#### 🏗️ Hierarchy Builder (44 tools)

create_hierarchy_project create_hierarchy add_source_mapping import_hierarchy_csv export_hierarchy_csv generate_hierarchy_scripts push_hierarchy_to_snowflake

#### 🧠 Cortex AI (25 tools)

cortex_complete cortex_summarize cortex_sentiment cortex_reason analyst_ask create_semantic_model

#### 📊 Wright Module (18 tools)

create_mart_config generate_mart_pipeline discover_hierarchy_pattern validate_mart_pipeline

#### 📚 Data Catalog (15 tools)

catalog_create_asset catalog_search catalog_create_term catalog_scan_connection

#### 🔍 Lineage & Impact (11 tools)

track_column_lineage analyze_change_impact export_lineage_diagram

### Available Templates (20 Templates)

#### Accounting Domain

Template ID | Name | Industry
--- | --- | ---
standard_pl | Standard P&L | General
standard_bs | Standard Balance Sheet | General
oil_gas_los | Oil & Gas LOS | Oil & Gas
upstream_oil_gas_pl | Upstream Oil & Gas P&L | Oil & Gas - E&P
manufacturing_pl | Industrial Manufacturing P&L | Manufacturing
saas_pl | SaaS Company P&L | SaaS

#### Operations Domain

Template ID | Name | Industry
--- | --- | ---
geographic_hierarchy | Geographic Hierarchy | General
department_hierarchy | Department Hierarchy | General
upstream_field_hierarchy | Upstream Field Hierarchy | Oil & Gas
fleet_hierarchy | Fleet & Route Hierarchy | Transportation

### Available Skills (7 Skills)

Skill ID | Name | Industries | Capabilities
--- | --- | --- | ---
financial-analyst | Financial Analyst | General | GL reconciliation, trial balance, bank rec, COA design
fpa-oil-gas-analyst | FP&A Oil & Gas Analyst | Oil & Gas | LOS analysis, JIB, reserves, hedge accounting
manufacturing-analyst | Manufacturing Analyst | Manufacturing | Standard costing, COGS, variances, inventory
saas-metrics-analyst | SaaS Metrics Analyst | SaaS | ARR/MRR, cohorts, CAC/LTV, unit economics
transportation-analyst | Transportation Analyst | Transportation | Operating ratio, fleet, lanes, driver metrics

### API Reference

#### MCP Configuration (Claude Desktop)

{ "mcpServers": { "DataBridge_AI": { "command": "python", "args": ["-m", "src.server"] } } }

#### Programmatic Usage

from src.server import mcp # Run as MCP server mcp.run() # Or get tools list tools = await mcp.get_tools() print(f"Loaded {len(tools)} tools")

#### Environment Variables

Variable | Description | Default
--- | --- | ---
DATA_DIR | Data directory for projects | ./data
NESTJS_BACKEND_URL | NestJS backend URL | http://localhost:8001
NESTJS_API_KEY | API key for backend | -
SNOWFLAKE_ACCOUNT | Snowflake account | -