MCP/AI context layerData Platform Engineer

How do I give AI agents context about my company data?

Bruin exposes governed assets, lineage, and column descriptions through MCP, so an agent answers from real business context instead of guessing at raw table and column names.

Command

bruin mcp

Defined in

MCP + YAML

Works with

Any MCP client + Bruin

What you get

Governed contextlineage-awarecolumn descriptions

How it works in code

/* @bruin
name: mart.revenue
description: Net daily revenue in USD, refunds excluded
columns:
  - name: revenue_usd
    description: Net revenue after refunds, USD
@bruin */

Run bruin mcp and the agent uses these descriptions and lineage as context.

About Bruin

What is Bruin?

Bruin is an open-source, AI-powered data platform. One project covers the whole path from source to answer: data ingestion (with ingestr), SQL and Python transformations, quality checks, column-level lineage, a data catalog and scheduling. On top of that data, an AI data analyst answers questions in Slack, Microsoft Teams, Google Chat, WhatsApp, Discord, Telegram, email or the browser, and builds dashboards from a prompt.

Pipelines are plain SQL, Python and YAML files in your own Git repository, and the work runs inside your own warehouse: Snowflake, BigQuery, Databricks, Redshift, Postgres, ClickHouse, DuckDB and others. The Bruin CLI is open source under Apache 2.0 and runs on a laptop, in CI or on-prem. Bruin Cloud is optional and adds scheduling, the AI data analyst, governance, SSO and audit logs.

For AI agents that means governed access to your data and pipelines over MCP or an API, with the context an agent needs to get the answer right.

Replaces
Separate tools for ingestion, transformation, orchestration, data quality, cataloguing and BI
Open source
Bruin CLI under Apache 2.0; ingestr source-available under the Functional Source License
Your data
Stays in your warehouse; pipelines stay in your Git repository
Security
ISO/IEC 27001:2022 certified and SOC 2 Type 2 attested
Used by
Data teams at Lessmore, StarBerry, NativeMinds, SCG, M8 Games and Fabrikatör

Why Bruin for AI agents

  • MCP for coding agents

    bruin mcp gives Claude Code, Cursor, VS Code and Codex tools to query data, compare tables, ingest data and build pipelines.

  • Read-only by default

    The Bruin Cloud Query API rejects any statement that is not a SELECT or WITH query, keeps credentials in Bruin and records every query in an audit log.

  • Context, not just tables

    Agents read semantic models, the glossary, column descriptions and AGENTS.md files, so they use your definitions instead of guessing.

  • Scoped tokens

    Personal and team tokens carry only the permissions an agent needs.

How it works

  1. 01

    Install the CLI

    Install Bruin and point it at your project and warehouse.

  2. 02

    Connect the agent

    In Claude Code, run claude mcp add bruin -- bruin mcp. Other clients use the same server.

  3. 03

    Add definitions

    Define metrics in a semantic model so the agent asks for them by name.

Give agents governed data

Bruin CLI and ingestr are on GitHub.

A demo walks through your own data.

Sign up to our newsletter

Practical updates on open-source data pipelines, AI analysts, governance, and what we are shipping at Bruin.

The signup form is hosted by Brevo. Allow marketing cookies to load it.