dbt-labs/dbt-mcp releases

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 - 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 - 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 - 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 - 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 - 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

v1.14.0 - 2026-04-14

Enhancement or New Feature

• Populate dbt_cloud_account_identifier in telemetry events
• Auto-fetch DBT_HOST_PREFIX from dbt Platform for SL and Discovery API URL construction
• list_metrics now returns dimensions and entities in the same response when the metric count is at or below a configurable threshold (default: 10, via DBT_MCP_SL_FULL_CONFIG_THRESHOLD), reducing LLM round trips from 3 tool calls to 1 for small-to-medium environments

Under the Hood

• Remove forked MCP SDK source
• Update dependabot config to batch examples/ security PRs
• Add patterns to examples dependencies in dependabot configuration
• Match baseline dependabot docs for multi-ecosystem-groups config

v1.13.0 - 2026-04-07

Enhancement or New Feature

• Add YML selectors support for CLI tools
• Reduce get_product_doc_pages page limit from 10 to 5 and add optional query parameter for section-level content extraction, significantly reducing response payload size to prevent IDE freezing
• Add search and key navigation for OAuth project selection

Under the Hood

• Using Admin API Client for dynamic multi-project server config
• Remove get_project_details tool
• Use admin api client for multiproject SL tools

v1.12.0 - 2026-04-01

Enhancement or New Feature

• Add multi-project discovery tools with config_override support for Server B

Under the Hood

• Add LLM-Assisted Contributions section to CONTRIBUTING.md and consolidate style guidelines from .cursor/rules into CONTRIBUTING.md
• Clarify OAuth page wording — dbt Cloud → dbt Platform, remove editor-specific framing
• Clarify selectors arg/prompt for CLI tools
• Split config_providers module into a package with separate files per provider type
• Extract CredentialsProvider into credentials.py to break circular import
• Follow redirects for DbtAdminAPIClient

v1.11.0 - 2026-03-25

Enhancement or New Feature

• Expose steps_override parameter in trigger_job_run tool
• Add list_projects tool to discover available projects in the account; add project description field to project objects
• Add --sample flag support to build and run tools
• Add AG2 multi-agent example
• Extract project/environment helpers for multi-project support
• Add multi-project semantic layer tools with project_id parameter
• Add more data to list_projects response: dbt_project_subdirectory, has_semantic_layer, type, environments (id/name/type), and repository_full_name
• Add selector flag to compile tool

Under the Hood

• Add automated tool set descriptions for README generation
• Add Claude Code skill for automating dbt-mcp releases
• Pin mcp SDK to dbt-labs/patched fork for stateless task leak fix
• Harden OAuth token handling: eagerly start background refresh, validate token expiry in get_token(), and stop setting settings.dbt_token in the OAuth path
• Switch dependencies to compatible release (~=) specifiers
• Remove dead code and unify OAuth expiry buffer constants
• Consolidate duplicate OAuth token refresh logic into shared function
• Migrate HTTP client from requests to httpx.AsyncClient for project and environment resolvers
• Remove test_tools_disabled from TestProductDocsRegistration suite

Bug Fix

• Address auth issues with misconfigured env vars

Security

• Update minimatch, rollup, and ajv in ui/pnpm-lock.yaml and ai package in examples/ai_sdk_agent to fix known security vulnerabilities

v1.10.0 - 2026-03-10

Enhancement or New Feature

• Adds product docs tools: search_product_docs and get_product_doc_pages

Under the Hood

• Add dependabot YML config
• Loosen version pin to dbt-protos>=1.0.431
• Add meta field passthrough to tool definition infra for MCP Apps support

v1.9.3 - 2026-03-02

Under the Hood

• Upgrade MCP SDK version pin from ==1.23.1 to ==1.26.0
• Metadata tool for current branch

v1.9.2 - 2026-02-25

Under the Hood

• Classify ToolCallErrors as client/server via TypeAlias unions and catch COMPILED timeouts as SemanticLayerQueryTimeoutError

v1.9.1 - 2026-02-25

Under the Hood

• Recategorize fetch_performance errors
• Add validation for dbt LSP args in LSPClient

Bug Fix

• Show user-friendly error message on OAuth setup failure instead of raw TypeError

v1.9.0 - 2026-02-11

Enhancement or New Feature

• Add Dockerfile and .dockerignore for containerized deployment
• Add get_all_macros discovery tool
• Move Logging setup before settings so settings can be logged.
• Add AI SDK agent example for building TypeScript applications with dbt MCP

Under the Hood

• Handle invalid tool names in tool allowlist
• Enhance docs gen script to include d2.png updates / proper MCP casing
• Align get_lineage_dev to have similar signature to get_lineage. Rename get_model_lineage_dev to get_lineage to align to naming better as well.
• Use task:d2 to generate d2.png
• Add human tool descriptions for improved README documentation

Bug Fix

• Split selector into model_selector and column_selector for dbt.listNodes LSP command
• Fix empty error messages in semantic layer query_metrics tool errors
• Fix get_metrics_compiled_sql and query_metrics failing with "Group by metric_time not found" when combining metrics from different semantic models

v1.8.1 - 2026-01-27

Bug Fix

• Fix Admin API tools failing due to improper URL encoding of include_related parameter

v1.8.0 - 2026-01-27

Enhancement or New Feature

• Extend detect_binary_type timeout to account for long-running dbt executable
• Add MCP tool to expose server version
• Add the ability to retrieve project information in the Admin tools (incl. repo)
• Add metadata field to get_dimensions tool response
• Add get_model_performance discovery tool
• Add automatic token refresh at startup using refresh token instead of requiring full re-authentication
• Add ability to select production environment during OAuth setup instead of relying on auto-detection
• Add a new CLI tool get_node_details_dev to retrieve information for a node in the current project

Under the Hood

• Use httpx for admin tools
• Add to_fastmcp_internal_tool utility to ToolDefinition
• Fix event loop issues with proxied tools by moving registration to app lifecycle
• Prevent duplicate flows for internal/external PRs
• CrewAI agent example with dbt-mcp
• Upgrade dependencies to address CVEs
• Use Python importlib over git in subprocess to get version for manifest.json
• Add generic_dbt_mcp_tool decorator

Bug Fix

• Fix get_job_run_error returning empty failed_steps when artifacts don't exist
• Make development environment optional when reusing OAuth context, fixing re-auth loop for projects without a dev environment
• Expand tilde (~) in DBT_PATH, DBT_PROJECT_DIR, and DBT_PROFILES_DIR environment variables to support paths like ~/.local/bin/dbt

v1.7.0 - 2026-01-09

Enhancement or New Feature

• Add MCP Bundle for one-click installation
• Adding get_lineage discovery mcp tool.

Under the Hood

• Fix integration tests
• Running integration tests in CI
• Using client session for client tool
• Fixing integration tests for branches from forks

v1.6.2 - 2026-01-06

Under the Hood

• Using uv for Python pre-commit hooks

Security

• fix: Prevent template injection vulnerabilities

v1.6.1 - 2025-12-17

Under the Hood

• Migrate admin tools definitions to use the dbt_mcp_tool decorator
• Close proxied_tools_manager for exceptions in listing proxied tools

v1.6.0 - 2025-12-11

Enhancement or New Feature

• Add ability to get model lineage via the cli.

Under the Hood

• Add Fusion tools to ToolName enum

v1.5.2 - 2025-12-10

Under the Hood

• Add search tool to ToolName enum

v1.5.1 - 2025-12-09

Under the Hood

• Upgrade python MCP SDK
• Add x-dbt-partner-source header to discovery tools
• Extend JSON encoder to handle PyArrow time, timedelta, and binary types in semantic layer query result
• Decouple tool registration from ToolName

v1.5.0 - 2025-12-05

Enhancement or New Feature

• Added explicit allowlist system for tool configuration, enabling fine-grained control over which tools are available.

Under the Hood

• Automate Toolset and Tools documentation generation into README
• Test TOOLSET_TO_DISABLE_ATTR and TOOLSET_TO_ENABLE_ATTR
• Python Cursor rule and stylistic guidelines

Bug Fix

• Fix discovery tool prompt tool parameters
• Fix JSON serialization error when querying metrics that return Decimal values from the dbt Semantic Layer

v1.4.0 - 2025-12-03

Enhancement or New Feature

• Get resource details for search resources
• stderr logger configuration with formatting and log lever override

Under the Hood

• Rename keyword search tool
• Refactor discovery fetchers to share pagination
• Override js-yaml version
• Update gitignore
• Remove pandas dependency
• Use httpx for semantic layer requests
• Use httpx for discovery requests
• Remove search tool
• Fix semantic layer client blocking requests

Bug Fix

• Fix lsp binary detection on Windows

v1.3.0 - 2025-11-18

Enhancement or New Feature

• Extend get_job_run_error to support optional warnings
• Add search tools to discovery toolset
• Refactor proxied tools. Enable new search tools.

Under the Hood

• Add discovery tool context
• Update d2 diagram with get_all_sources/get_source_details
• Add Semantic Layer tools context

v1.2.0 - 2025-11-12

Enhancement or New Feature

• Add get_source_details tool to retrieve column-level information for dbt sources, providing feature parity with get_model_details
• Return SL query results in ISO timestamp format rather than Unix timestamp

Under the Hood

• Undo removal of .env.example file

Bug Fix

• correctly apply config.disable_tools when registering lsp tools

v1.1.0 - 2025-11-03

Enhancement or New Feature

• This adds the get all sources tool.

• add auto-disable and better validation of MCP settings.
  A whole bunch of tests needed to change because of this
  Created fixture for allowing the default behavior
  to assume all required fields for settings are fully set

• Add list_saved_queries tool to the Semantic Layer, enabling discovery of predefined MetricFlow queries via GraphQL API. This allows AI agents to list and search saved queries with their associated metrics, dimensions, and filters.

Under the Hood

• Abstract LSP client and LSP connection via providers.
• Add version number guidelines to contributing.md
• Make release version determination automatic based on changie changelog entries. The workflow now defaults to 'auto' mode which uses 'changie batch auto' to

Bug Fix

• Minor update to the instruction for LSP tool

v1.0.0 - 2025-10-20

Enhancement or New Feature

• Incroduce support for fusion LSP

Under the Hood

• Add support for Python debugger
• Update pyproject.toml including development status
• Add example for aws_strands_agent

Bug Fix

• Exclude Python 3.14 for now as pyarrow hasn't released wheels yet

v0.10.3 - 2025-10-08

Under the Hood

• Improved retry logic and post project selection screen
• Avoid double counting in usage tracking proxied tools
• Categorizing ToolCallErrors

v0.10.2 - 2025-10-08

Enhancement or New Feature

• Improved oauth error handling
• Remove oauth env var feature flag. Enable oauth broadly.

Under the Hood

• Improved logging for development
• Updating prompts to include examples to avoid bad parameter generation
• Remove DBT_HOST prefix
• Update usage tracking with new fields
• Write .user.yml if it does not exist
• Changed UsageTracker to a protocol

v0.10.1 - 2025-10-02

Bug Fix

• Fix get_job_run_error truncated log output

v0.10.0 - 2025-10-01

Enhancement or New Feature

• Add get_job_run_error to Admin API tools

v0.9.1 - 2025-09-30

Under the Hood

• Reorganize code and add ability to format the arrow table differently

v0.9.0 - 2025-09-30

Enhancement or New Feature

• Adding the dbt codegen toolset.

Under the Hood

• Updates README with new tools
• Fix .user.yml error with Fusion

v0.8.4 - 2025-09-29

Enhancement or New Feature

• Allow doc files to skip changie requirements

Under the Hood

• Upgrade @vitejs/plugin-react
• Add ruff lint config to enforce Python 3.9+ coding style
• Opt-out of usage tracking with standard dbt methods

v0.8.3 - 2025-09-24

Under the Hood

• Rename SemanticLayerConfig.service_token to SemanticLayerConfig.token

Bug Fix

• Fix Error handling as per native MCP error spec

v0.8.2 - 2025-09-23

Enhancement or New Feature

• Use dbt --help to identify binary type
• Increase dbt CLI timeout default

Under the Hood

• Implement SemanticLayerClientProvider

Bug Fix

• Update how we identify CLIs

v0.8.1 - 2025-09-22

Under the Hood

• Create ConfigProvider ABC

v0.8.0 - 2025-09-22

Enhancement or New Feature

• Allow creating pre-releases
• Return compiled code in get_model_details

Under the Hood

• Handle Claude Desktop running multiple MCP server instances
• Add docs for using the MCP server with google ADK and dbt-core
• Add search string to SL metadata queries
• Improve parameters in query_metrics examples
• Reduce token usage in get_job_run_details response by removing debug param and unnecessary logs
• Automatically refresh oauth token
• Improve dbt platform context mcp.yml parsing
• Add PR and issue templates
• Address claude desktop re-triggering oauth on exit
• Turning off caching for static files

Bug Fix

• Add account id to dbt platform context

v0.7.0 - 2025-09-09

Enhancement or New Feature

• Add tools to retrieve exposure information from Disco API

Under the Hood

• Expect string sub in oauth JWT
• Using sync endpoints for oauth FastAPI server
• Fix release pipeline

v0.6.2 - 2025-09-08

Enhancement or New Feature

• Adding the ability to return the config.meta attribute from list metrics to give the LLM more context
• Oauth initial implementation
• Fix #251 - Add flag for no color + ability to detect binary type

Under the Hood

• Add docs for using the MCP server with Pydantic AI
• Don't run mypy on examples

v0.6.1 - 2025-08-28

Enhancement or New Feature

• Add support for --vars flag
• Allow headers in AdminApiConfig

Under the Hood

• Remove redundant and outdated documentation

v0.6.0 - 2025-08-22

Under the Hood

• Update docs with new tools
• Using streamable http for SQL tools
• Correctly handle admin API host containing protocol prefix

v0.5.0 - 2025-08-20

Enhancement or New Feature

• Add support for --full-refresh flag
• Adds a new tool to get model health (last run, tests, source freshness) from discovery API
• Add operational/admin tools to interact with the dbt platform

Under the Hood

• LangGraph create_react_agent example
• Make model_name optional for more discovery tools
• Update example with OpenAI to show tool calls

Bug Fix

• Fix for timeout on Windows

v0.4.2 - 2025-08-13

Enhancement or New Feature

• Add default --limit to show tool

Under the Hood

• Define toolsets

Bug Fix

• Fix the prompt to ensure grain is passed even for non-time group by"

v0.4.1 - 2025-08-08

Under the Hood

• Upgrade dbt-sl-sdk

v0.4.0 - 2025-08-08

Enhancement or New Feature

• Tool policies
• Added Semantic Layer tool to get compiled sql

Under the Hood

• Fix JSON formatting in README
• Document dbt Copilot credits relationship

Bug Fix

• Make model_name of get_model_details optional

v0.3.0 - 2025-08-05

Enhancement or New Feature

• Add ToolAnnotations
• Add alias field to GET_MODEL_DETAILS GraphQL query

Under the Hood

• Test remote tool equality
• Fix initialization integration test
• Refactor README
• Rename Remote Tools to SQL Tools
• Document Remote MCP
• Improved Remote MCP instructions

Bug Fix

• Apply dbt_cli_timeout to all dbt commands

v0.2.20 - 2025-07-25

Enhancement or New Feature

• Allow for disabling CLI tools

Under the Hood

• Update codeowners
• Improve DISABLE_TOOLS configuration
• Remote MCP example
• Add unit tests for env vars combinations
• Add instructions for Claude Code in README
• Add new example for OpenAI + HTTP Streamable MCP

v0.2.19 - 2025-07-22

Under the Hood

• Create list of tool names

v0.2.18 - 2025-07-22

Enhancement or New Feature

• Move env var parsing to pydantic_settings for better validation

Under the Hood

• Add integration test for server initialization

Bug Fix

• Fix SL validation error message when no misspellings are found

v0.2.17 - 2025-07-18

v0.2.16 - 2025-07-18

Under the Hood

• Adding the ability to exclude certain tools when registering
• OpenAI responses example

v0.2.15 - 2025-07-16

Under the Hood

• Refactor sl tools for reusability
• Update VSCode instructions in README

v0.2.14 - 2025-07-14

Enhancement or New Feature

• Make dbt CLI command timeout configurable

Bug Fix

• Allow passing entities in the group by

v0.2.13 - 2025-07-11

Under the Hood

• Decouple discovery tools from FastMCP

v0.2.12 - 2025-07-09

Bug Fix

• Catch every tool error and surface as string

v0.2.11 - 2025-07-03

Bug Fix

• fix order_by input

v0.2.10 - 2025-07-03

Enhancement or New Feature

• Upgrade MCP SDK

v0.2.9 - 2025-07-02

Enhancement or New Feature

• Decrease amount of data retrieved when listing models

Under the Hood

• OpenAI conversational analytics example
• README updates
• Move Discover headers to config

v0.2.8 - 2025-07-02

Enhancement or New Feature

• Raise errors if no node is selected (can also be configured)

Bug Fix

• Fix when people provide DBT_PROJECT_DIR as a relative path
• Fix link in README

v0.2.7 - 2025-06-30

Under the Hood

• Timeout dbt list command
• Troubleshooting section in README on clients not finding uvx
• Update Discovery config for simpler usage

Bug Fix

• Fixing bug when ordering SL query by a metric

v0.2.6 - 2025-06-16

Under the Hood

• Instructing the LLM to more likely use a selector
• Instruct LLM to add limit as an argument instead of SQL
• Fix use of limit in dbt show
• Indicate type checking

v0.2.5 - 2025-06-06

Under the Hood

• Small improvements to improve logging and code organization.
• Move --selector to the code instead of the prompt
• Cursor deeplink setup
• Fix Cursor deeplinks
• Fix Cursor env var mess up

Bug Fix

• Fix Discovery API config enablement

v0.2.4 - 2025-06-03

Bug Fix

• Add the missing selector argument when running commands

v0.2.3 - 2025-06-02

Under the Hood

• Fix release action to fetch tags

v0.2.2 - 2025-06-02

Under the Hood

• Update README to run the MCP server with uvx
• Logging usage events
• Improve remote tools error logging
• Move create-release-tag to release Action
• Update release process documentation

Bug Fix

• Fix typo in GH action to create release