# GoldenFlow

Data transformation toolkit — 43+ built-in transforms for phones, dates, addresses, names, categoricals. 10 MCP tools. DQBench Transform Score: 100/100. Built on Polars.

## Quick Start

```bash
# Connect this server (installs CLI if needed)
npx -y @smithery/cli@latest mcp add benzsevern/goldenflow

# Browse available tools
npx -y @smithery/cli@latest tool list benzsevern/goldenflow

# Get full schema for a tool
npx -y @smithery/cli@latest tool get benzsevern/goldenflow transform

# Call a tool
npx -y @smithery/cli@latest tool call benzsevern/goldenflow transform '{}'
```

## Direct MCP Connection

Endpoint: `https://goldenflow--benzsevern.run.tools`

## Tools (10)

- `transform` — Transform a data file using GoldenFlow. Zero-config or config-driven.
- `map` — Auto-map schemas between source and target files.
- `profile` — Profile a data file showing column types, nulls, and patterns.
- `learn` — Generate a YAML config from data patterns.
- `diff` — Compare two data files and show what changed (added, removed, modified rows).
- `validate` — Dry-run transform on a file. Shows what would change without writing output.
- `list_transforms` — List all registered transforms with their modes, input types, and auto-apply status.
- `explain_transform` — Describe what a specific transform does, its mode, and input types.
- `list_domains` — List available domain packs (e.g., people_hr, ecommerce, finance).
- `select_from_findings` — Map GoldenCheck findings to recommended GoldenFlow transforms. Bridge tool for Check-to-Flow handoff.

```bash
# Get full input/output schema for a tool
npx -y @smithery/cli@latest tool get benzsevern/goldenflow <tool-name>
```