Dbt Semantic Layer MCP Server

MCP Server for querying DBT Semantic Layer

Local serverstdio

What is the Dbt Semantic Layer MCP server?

Dbt Semantic Layer MCP server exists for a simple reason — assistants are far more useful when they can act on Dbt Semantic Layer directly instead of describing what you should do. MCP Server for querying DBT Semantic Layer.

What you get

A Model-Connector-Presenter (MCP) server for seamlessly querying the dbt Semantic Layer through Claude Desktop and other compatible AI assistants.

The dbt Semantic Layer is a powerful feature that allows you to define metrics once in your dbt project and reuse them consistently across your entire data stack. It provides:

  • 🔍 Metric Discovery: Browse and search available metrics in your dbt Semantic Layer
  • 📊 Query Creation: Generate and execute semantic queries through natural language
  • 🧮 Data Analysis: Filter, group, and order metrics for deeper insights
  • 📈 Result Visualization: Display query results in an easy-to-understand format

Setting it up

The server ships on npm as @smithery/cli, so your MCP client can launch it on demand — there is no separate build step. Add the server block to your client's configuration, restart it, and the tools register themselves.

Configuration and credentials

  • A dbt Cloud account with Semantic Layer enabled - API access to your dbt Cloud instance - Node.js (v14 or later)

Choosing this one

This sits in the developer tooling group, where several servers overlap in what they claim to do but differ sharply once you actually set them up. It is maintained by TommyBez; worth a glance at recent repository activity before you build anything load-bearing on it.

This entry was verified against Dbt Semantic Layer's own documentation before publication; SyncDev keeps the directory reviewed rather than auto-generated.

Before you rely on it

  • It runs with your machine's permissions. That is convenient and also the reason to think about what you point it at before you approve a tool call.
  • MCP clients confirm each tool call by default. Leave that on until you have watched what the dbt semantic layer mcp server does with a few real requests.

How to install the Dbt Semantic Layer MCP server

{
  "mcpServers": {
    "dbt-semantic-layer": {
      "command": "npx",
      "args": ["-y", "@smithery/cli"]
    }
  }
}

Add to claude_desktop_config.json, then restart Claude Desktop.

Configuration

  • A dbt Cloud account with Semantic Layer enabled - API access to your dbt Cloud instance - Node.js (v14 or later)

Frequently asked questions

You need a dbt Cloud account with Semantic Layer enabled, API access to your dbt Cloud instance, and Node.js v14 or later.