Skip to content

Releases: dbt-labs/dbt-mcp

v1.19.2

22 May 18:28
a7a081a

Choose a tag to compare

v1.19.2 - 2026-05-22

Under the Hood

  • Bump dbt-sl-sdk==0.13.3

Bug Fix

  • Fix unstructured tool errors being masked as 'outputSchema defined but no structured output returned'

v1.19.1

14 May 20:31
c84d955

Choose a tag to compare

v1.19.1 - 2026-05-14

Under the Hood

  • Silence asyncio DeprecationWarning in LSP connection unit tests by binding a fresh event loop and using loop.create_future() instead of bare asyncio.Future().
  • Make ToolDefinition.structured_output default to True and require title in generic_dbt_mcp_tool. Decorator now keyword-only.
  • Remove dbt-artifacts-parser from 7 day exclusion
  • Fix test_local_mcp_list_metrics_returns_valid_response integration test

v1.19.0

13 May 14:08
1d4837a

Choose a tag to compare

v1.19.0 - 2026-05-13

Enhancement or New Feature

  • list_metrics now accepts a list of substrings in the search parameter (results are unioned and deduplicated, fetched in parallel) and prefixes its CSV with a # Note: line whenever description/metadata are trimmed because the response exceeded DBT_MCP_SL_MAX_RESPONSE_CHARS. Trimming is also now scoped to broad listings (result count above metrics_related_max) so a narrow result set always returns full description and metadata.

Under the Hood

  • Sign release PR commits with github-actions bot for verified commit signatures
  • [Part 1 of 3]: Use dbt-artifacts-parser schemas for artifact schema parsing

Bug Fix

  • Add optional grain field to order_by in query_metrics; when provided it takes precedence over the matching group_by grain, preserving backward-compatible fallback when omitted
  • fix: list_tools no longer triggers host elicitation, preventing 'No tools' in dbt Core (CLI-only) setups after v1.17.0
  • list/run/test/build/codegen tools no longer return stderr noise (e.g. urllib3 deprecation warnings under externalbrowser auth) in place of 'OK' on success. The fix uses process.returncode as the success signal: on success only stdout is returned, on failure stderr is surfaced alongside stdout so error diagnostics aren't lost.

v1.18.1

11 May 19:23
7e4d521

Choose a tag to compare

v1.18.1 - 2026-05-11

Under the Hood

  • Handle metrics_with_related read timeouts

Bug Fix

  • Specify UTF-8 encoding for all text file reads/writes to fix UnicodeDecodeError on Windows (closes #765)

v1.18.0

08 May 16:44
506e3f3

Choose a tag to compare

v1.18.0 - 2026-05-08

Enhancement or New Feature

  • Move Admin API parameter docs into MCP tool schemas with shared descriptions
  • Share multi-project project_id description for Discovery and Semantic layer
  • Add JSON Schema parameter descriptions for Semantic Layer MCP tools
  • Add Discovery tool parameter descriptions for MCP schemas
  • Add MCP server instructions

Bug Fix

  • Add helpful hint for SSL errors during OAuth, suggesting that multi-cell users set DBT_HOST to the full hostname (e.g. abc123.us1.dbt.com)

v1.17.1

05 May 14:40
291ddd1

Choose a tag to compare

v1.17.1 - 2026-05-05

Bug Fix

  • Improve input validation for dbt CLI tool parameters and reduce verbosity of argument logging.
  • Fix server crash for CLI-only users introduced in v1.17.0: register_proxied_tools now filters enabled tools before calling get_config(), preventing an AssertionError when DBT_HOST is unset; replace bare assert with MissingHostError; improve lifespan error logging to include full traceback

v1.17.0

05 May 12:36
733bf6c

Choose a tag to compare

v1.17.0 - 2026-05-05

Enhancement or New Feature

  • Elicit DBT_HOST from user on first platform tool call when not set via env vars (#488)
  • Populate dbt_cloud_user_id in telemetry events by resolving the current user from the Admin API when not already set by OAuth
  • Register admin API tools in the multiproject MCP server so they are available when DBT_PROJECT_IDS is configured

Under the Hood

  • Make integration test check blocking for fork PRs: fail early instead of skipping when ok-to-test label is absent

Bug Fix

  • Fix UnicodeDecodeError when reading manifest.json on Windows with UTF-8 model descriptions
  • Fix dev env retrieval

Security

  • Add 7-day minimum package release age gate to prevent supply chain attacks via freshly-published malicious packages

v1.16.0

27 Apr 15:57
f293201

Choose a tag to compare

v1.16.0 - 2026-04-27

Enhancement or New Feature

  • Support parsing of fusion logs for warnings
  • Support dbt Fusion LSP via dbt lsp subcommand; prefer Fusion over legacy standalone binary, with DBT_LSP_PATH and editor storage paths as fallbacks

Bug Fix

  • Fix get_job_run_error returning empty failed_steps when artifact 404s raise NotFoundError

v1.15.1

22 Apr 09:16
156914e

Choose a tag to compare

v1.15.1 - 2026-04-22

Enhancement or New Feature

  • Reduce list_metrics response size by switching from JSON to CSV format, cutting response size by ~67% and reducing agent cost by up to 33% per query

Under the Hood

  • Move lazy imports in get_credentials to module level in credentials.py

v1.15.0

21 Apr 13:46
8d7534f

Choose a tag to compare

v1.15.0 - 2026-04-20

Enhancement or New Feature

  • ToolDispatcher routes between single-project and multi-project MCP
  • Add clone command to CLI tools
  • Remove get_job_run_artifact tool

Under the Hood

  • Add DBT_HOST_PREFIX support to remote session initialization
  • Update deprecated streamablehttp_client function to streamable_http_client

Bug Fix

  • Resolve symbolic links for mcp.lock file path before creating FileLock, preventing OSError when ~/.dbt/mcp.lock is a multi-level symbolic link.
  • Fix invalid mixed state when transitioning from single-project to multi-project OAuth login — stored prod/dev environments are no longer inherited when selected_project_ids is set
  • Fix proxied tools for single project MCP
  • Raise NotFoundError instead of ArtifactRetrievalError for 404 responses in get_job_run_artifact