← Explore all skills

MCP CONFIGURATION / dbt Labs

dbt MCP server configuration

Pins dbt Labs' MCP setup skill, which keeps tokens out of committed config and leaves SQL and codegen off until their flags are changed.

“Generates MCP server configuration JSON, resolves authentication setup, and validates server connectivity for dbt. Use when setting up, configuring, or troubleshooting the dbt MCP server for AI tools like Claude Desktop, Claude Code, Cursor, or VS Code.”

01 / THE REASONING

Why this made the selection.

  • Configuration that may be committed must use environment-variable references, and the file says never to log, display, or echo token values.
  • SQL and codegen stay disabled unless DISABLE_SQL or DISABLE_DBT_CODEGEN is set to false, and a .env file is supposed to be gitignored.

02 / THE REVIEW RECORD

What we actually inspected.

Source review has boundaries.
A clear record is more useful than a “safe” badge.

Material inspected

  • skills/dbt/skills/configuring-dbt-mcp-server/SKILL.md
  • README.md
  • LICENSE

Our findings

  • Committed configuration uses environment-variable references. A project .mcp.json may be committed only that way, never with literal tokens.
  • Token values are not logged, displayed, or echoed, and .env files are added to .gitignore.
  • SQL and codegen start disabled. CLI tools start enabled and are turned off with DISABLE_DBT_CLI=true.
  • The remote server is HTTP, requires a dbt platform account and a personal or service token, and the file says it consumes dbt Copilot credits.
  • The local server row says it consumes no credits. The remote server does not expose CLI run, build, or test. The local server does.
  • The file says to rotate tokens and to use the minimum required permission set.

Not established by this review

  • The resource was not executed. No MCP server was started and no token was set.
  • uvx, claude mcp add, and the client config editors were not run.
  • The credential, troubleshooting, and environment-variable references were not opened.
  • Not executed: it was not installed or run.

The review applies to the material and revision named here. A newer upstream release can change its behavior.

03 / PUT IT TO WORK

Add a skill to your workflow.

Upstream setup instructions ↗

DOCUMENTED COMMAND

/plugin install dbt@dbt-agent-marketplace

Copying does not execute this command. It may retrieve a newer version than the reviewed source.

  1. The repository README shows `/plugin marketplace add dbt-labs/dbt-agent-skills`, then `/plugin install dbt@dbt-agent-marketplace`. That installs the dbt plugin group, which lists this skill. It does not install this file alone.
  2. The same README shows `npx skills add dbt-labs/dbt-agent-skills/skills/dbt` for the skills/dbt directory, and `npx skills add dbt-labs/dbt-agent-skills` for every skill in the repository.
  3. This review did not install the skill.

Before you start

  • uv, for the local server path the skill links
  • A dbt project and dbt executable when CLI tools are used
  • A dbt platform account and a personal or service token for the remote server

04 / FOLLOW THE EVIDENCE

The source trail.

Our notes are separate from the original resource.
Check upstream before adopting a new version.

  1. https://github.com/dbt-labs/dbt-agent-skills/blob/7c7b5fa39e61694f1ae2b8ea1b8065e195c814ce/skills/dbt/skills/configuring-dbt-mcp-server/SKILL.md

    Supports: token handling, default-off SQL and codegen, and local versus remote server boundaries

  2. Repository README ↗Checked

    https://github.com/dbt-labs/dbt-agent-skills/blob/7c7b5fa39e61694f1ae2b8ea1b8065e195c814ce/README.md

    Supports: the dbt plugin install line and the skills/dbt directory install line

  3. Repository LICENSE ↗Checked

    https://github.com/dbt-labs/dbt-agent-skills/blob/7c7b5fa39e61694f1ae2b8ea1b8065e195c814ce/LICENSE

    Supports: Apache License 2.0

  4. https://raw.githubusercontent.com/dbt-labs/dbt-agent-skills/7c7b5fa39e61694f1ae2b8ea1b8065e195c814ce/skills/dbt/skills/configuring-dbt-mcp-server/SKILL.md

    Supports: upstreamDescription, review.notTested, review.reviewedAt

  5. https://raw.githubusercontent.com/dbt-labs/dbt-agent-skills/7c7b5fa39e61694f1ae2b8ea1b8065e195c814ce/README.md

    Supports: install.command

Evidence & Ask