Elementary

official

Expose data observability, lineage, test results & incidents to AI agents via MCP

View on elementary-data.com

What can you do with Elementary MCP?

  • Browse model metadata and status — Inspect a model’s columns, tests, and execution history using get_model and get_models.
  • Explore table and column-level lineage — Trace upstream and downstream dependencies across dbt and BI tools with get_lineage.
  • Review open incidents and their context — List active incidents and drill into details via get_incidents and get_incident.
  • Search the test catalog and add tests — Find available tests with search_tests and add a test to a column using add_test.
  • Check test coverage for a model — Retrieve which columns are tested and which are not through get_test_coverage.
  • View historical execution runs — See past dbt run results and performance details with get_execution_history.

Documentation

Elementary MCP Server

The Elementary MCP Server allows you to connect your Elementary environment to any client that supports MCP (Model Context Protocol). This lets AI agents, copilots, or natural language interfaces query and act on your data stack using live context.

What is MCP?

MCP (Model Context Protocol) is an open protocol introduced by Anthropic. It defines a way for AI systems to retrieve context and trigger actions from external tools in a structured way.

The Elementary MCP Server exposes an interface to query key parts of your data environment — including:

  • Models
  • Tests
  • Incidents
  • Test coverage
  • Lineage (dbt + BI), including column-level
  • Incidents

This enables workflows like:

  • Asking “What’s the status of the model feeding the revenue dashboard?”
  • Automatically creating a freshness test for a column
  • Browsing lineage to find upstream causes of issues
  • Triggering updates or syncs without opening a UI

How it works

The MCP Server runs as a remote service and is exposed via a single authenticated endpoint. It is compatible with any MCP-enabled client, such as Claude, Cursor IDE and Custom agents and LLM copilots.

Supported operations

You can use the Elementary MCP Server for:

  • Full asset details - Metadata, column definitions, and test coverage
  • Lineage - Explore table + column-level lineage across dbt and BI tools
  • Incidents - View open incidents and their context
  • Tests - Browse and add tests using the test catalog
  • Models - Inspect model metadata and status
  • Execution History - View historical runs and performance details

Coming soon

We're expanding support to include:

  • Data health summaries
  • Volume and freshness metrics
  • Sync triggers
  • Cloud test config updates