Skip to content

dbt-labs/dbt-mcp

v1.22.0 Breaking

This release includes 2 breaking changes for platform teams planning a safe upgrade.

Published 12d MCP Developer Tools
✓ No known CVEs patched
Read the diff → Tool health → What is this tool? →

✓ No known CVEs patched in this version

Topics

data-analytics data-engineering dbt llm mcp mcp-server
+1 more
model-context-protocol

Affected surfaces

breaking_upgrade auth

ReleasePort's take

Light signal
editorial:auto 12d

Release v1.22.0 introduces get_node_details and enhances get_lineage while deprecating several older API tools.

Why it matters: Deprecates 10 type‑specific get_*_details and model‑relationship endpoints; migrate to the new unified APIs before they are removed in a future release.

Summary

AI summary

Updates Enhancement or New Feature, Under the Hood, and v1.22.0 - 2026-07-14 across a mixed release.

Changes in this release

Feature Medium

Adds get_node_details tool; deprecates 8 type-specific get_*_details tools

Adds get_node_details tool; deprecates 8 type-specific get_*_details tools

Source: llm_adapter@2026-07-14

Confidence: low

Feature Medium

Enriches get_lineage results with description; adds direction param; deprecates get_model_parents and get_model_children

Enriches get_lineage results with description; adds direction param; deprecates get_model_parents and get_model_children

Source: llm_adapter@2026-07-14

Confidence: low

Feature Low

Adds meta_filter param to list_metrics for pre-filtering by config.meta

Adds meta_filter param to list_metrics for pre-filtering by config.meta

Source: llm_adapter@2026-07-14

Confidence: high

Feature Low

Adds get_node_details tool for fetching any dbt resource details

Adds get_node_details tool for fetching any dbt resource details

Source: granite4.1:30b@2026-07-15-audit

Confidence: low

Feature Low

Enriches get_lineage results with a description field per node

Enriches get_lineage results with a description field per node

Source: granite4.1:30b@2026-07-15-audit

Confidence: low

Feature Low

Adds direction parameter (upstream/downstream/both) to get_lineage

Adds direction parameter (upstream/downstream/both) to get_lineage

Source: granite4.1:30b@2026-07-15-audit

Confidence: low

Deprecation Medium

Deprecates 8 type-specific get_*_details tools in favor of get_node_details

Deprecates 8 type-specific get_*_details tools in favor of get_node_details

Source: llm_adapter@2026-07-14

Confidence: high

Deprecation Medium

Deprecates get_model_parents and get_model_children in favor of get_lineage with direction param

Deprecates get_model_parents and get_model_children in favor of get_lineage with direction param

Source: llm_adapter@2026-07-14

Confidence: high

Full changelog

v1.22.0 - 2026-07-14

Enhancement or New Feature

  • Add get_node_details tool for fetching details of any dbt resource type; deprecate the 8 type-specific get_*_details tools in favor of get_node_details
  • Enrich get_lineage results with a description field per node; add a direction param (upstream/downstream/both) to narrow results to one side of the graph; deprecate get_model_parents and get_model_children in favor of get_lineage(depth=1, direction=...)
  • Add meta_filter param to list_metrics to pre-filter by config.meta and preserve metadata column under progressive trimming

Under the Hood

  • Add docs/deprecating-tools.md: full process guide for the deprecate-then-remove tool lifecycle, plus CONTRIBUTING.md pointer.

Breaking Changes

  • Deprecate the eight type-specific get_*_details tools (get_model_details, get_seed_details, etc.) in favor of get_node_details
  • Deprecate get_model_parents and get_model_children in favor of get_lineage with direction parameter

Weekly OSS security release digest.

The CVE patches and breaking changes that affected production tools this week. One email, every Sunday.

No spam, unsubscribe anytime.

Share this release

Track dbt-labs/dbt-mcp

Get notified when new releases ship.

Sign up free

About dbt-labs/dbt-mcp

A MCP (Model Context Protocol) server for interacting with dbt.

All releases →

Beta — feedback welcome: [email protected]