Releases: dbt-labs/dbt-mcp
Releases · dbt-labs/dbt-mcp
v1.19.2
v1.19.1
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
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
v1.18.0
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
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
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
v1.16.0 - 2026-04-27
Enhancement or New Feature
- Support parsing of fusion logs for warnings
- Support dbt Fusion LSP via
dbt lspsubcommand; prefer Fusion over legacy standalone binary, withDBT_LSP_PATHand editor storage paths as fallbacks
Bug Fix
- Fix get_job_run_error returning empty failed_steps when artifact 404s raise NotFoundError
v1.15.1
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_credentialsto module level incredentials.py
v1.15.0
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