Delv
Official (Vendor)Active· 7d4.3by dbt Labs

dbt

dbt Labs' official MCP. Run models, explore the semantic layer, query the discovery API, and search project docs from your agent.

A
Safety & Trust

Delv Safety Grade: A

Score 84/100 · assessed 2026-04-18

Maintainer95
Permissions75
Supply chain75
Transparency85
Incidents100

dbt Labs' official MCP server provides agent access to dbt Cloud projects through a well-scoped API. The maintainer score is excellent given dbt Labs' position as a major data infrastructure vendor with substantial backing and enterprise adoption. Permissions are reasonably scoped to dbt Cloud API operations (running models, querying semantic layer, reading documentation), though model execution does trigger data warehouse queries which could have cost implications. Supply chain is solid via uvx distribution but lacks traditional package registry verification. The requirement for DBT_TOKEN means credential management is critical. Transparency is strong with open source code and clear documentation. No known security incidents. The semantic layer query translation feature is powerful but users should understand it generates and executes SQL against their warehouse. Overall a trustworthy official integration from a reputable vendor, appropriate for teams already using dbt Cloud with proper token scoping.

Green flags

  • Official dbt Labs product with enterprise vendor backing
  • Open source with clear documentation and examples
  • Scoped to dbt Cloud API, no filesystem or shell access
  • Semantic layer queries are translated, not arbitrary SQL
  • Active maintenance from established data infrastructure company

Red flags

  • DBT_TOKEN grants API access to entire dbt Cloud account
  • Model execution triggers billable warehouse queries
  • No package registry distribution, uvx-only install
  • Token stored in plaintext environment variables

Permissions requested

Outbound networkAccess secretsDB readDB write
Assessed by Delv Editorial using public metadata. Grades are advisory and update as the ecosystem changes. They do not replace your own review of permissions and code before granting an agent access to sensitive systems.

Install

uvx dbt-mcp
Env vars needed: DBT_HOSTDBT_TOKENDBT_PROJECT_DIR

Review

dbt Labs' official MCP turns Claude into a surprisingly capable dbt assistant. You point it at your dbt Cloud project via environment variables (host, token, project directory) and it can run models, query the semantic layer in plain English, check which models are stale, and pull documentation directly into your conversation. The semantic layer integration is the standout feature. Instead of writing SQL against your metrics layer, you ask 'what was revenue last quarter by region?' and it translates that into the correct semantic query. It's faster than context-switching to dbt Cloud's UI and genuinely useful during exploratory analysis or stakeholder conversations. I've used it most for drafting tests on new models. You can ask it to suggest tests based on column types and existing patterns in your project, then review the YAML inline. It's not perfect, the suggestions lean generic, but it's a decent starting point that beats staring at a blank schema file. The discovery API access means you can also ask it to surface lineage or find models that depend on a specific source, which is handy during impact analysis. Quirks: it requires dbt Cloud, so if you're running dbt Core locally without the Cloud layer, this won't help. The project directory variable can be fussy if your repo structure doesn't match dbt's expectations. And while it can run models, it's not a replacement for your CI pipeline, it's more for ad-hoc checks or quick validation during development. The documentation search works well but only if your team actually maintains inline docs, which, let's be honest, is hit or miss. Who shouldn't bother: teams not on dbt Cloud, or anyone who doesn't regularly need to interrogate their dbt project from outside the IDE. If you're just running `dbt run` locally and rarely touch the semantic layer, the setup overhead isn't worth it. But if you're already deep in dbt Cloud and want faster access to project metadata or semantic queries without leaving your agent, this is a solid addition.
Verdict

Install it if you're on dbt Cloud and regularly need to query the semantic layer, check model freshness, or draft tests without opening the UI. Skip it if you're running dbt Core locally or don't interact with the semantic layer often enough to justify the setup.

Good at

  • Semantic layer queries in plain English save time during exploratory analysis and stakeholder conversations.
  • Discovery API access lets you surface lineage, check freshness, and find downstream dependencies without leaving the agent.
  • Official vendor support means it's maintained in step with dbt Cloud API changes.
  • Drafting tests inline is faster than switching to your IDE and staring at YAML.

Watch out

  • Requires dbt Cloud, so dbt Core users running locally are out of luck.
  • Test suggestions are generic and need manual refinement, they won't catch domain-specific edge cases.
  • Project directory configuration can be fussy if your repo structure is non-standard.
  • Only as useful as your team's documentation discipline, sparse inline docs mean sparse search results.

Use cases

  • Asking the agent which models are stale
  • Drafting tests for new dbt models
  • Querying the semantic layer in plain English
  • Pulling project docs into a code review

Getting started

1. Run `uvx dbt-mcp` to install the server. 2. Add the server to your Claude Desktop config with `DBT_HOST` (your dbt Cloud host), `DBT_TOKEN` (service account token with read access), and `DBT_PROJECT_DIR` (path to your local dbt project). The config goes in `claude_desktop_config.json` under `mcpServers`. 3. Restart Claude Desktop and ask it to list your dbt models or check which are stale. If it can't connect, double-check your token permissions and that the project directory path is absolute. 4. Try a semantic layer query like 'what was total revenue last month?' to verify the integration works end-to-end. 5. Watch out for the project directory path, it needs to point to the root of your dbt project where `dbt_project.yml` lives, not a subdirectory.

Works with

Claude DesktopClaude CodeCursor

Similar MCPs