MCP/AI context layerAnalytics Engineer

What is the best way to provide business context to an AI data agent?

Define metric meanings, ownership, and descriptions in asset metadata. The Bruin MCP server passes that business context to the agent, so answers use your definitions rather than generic assumptions.

Command

bruin mcp

Defined in

MCP + YAML

Works with

Any MCP client + Bruin

What you get

Business definitionsmetric contextgoverned answers

How it works in code

/* @bruin
name: mart.active_users
description: Users with >=1 session in the last 28 days
owner: growth-team
@bruin */

Run bruin mcp and the agent answers using your business definitions.

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.