dbt-mcp
A MCP (Model Context Protocol) server for interacting with dbt resources.
Decision gist · record as of 2026-08-14
Yes, if you are building or using AI agents that need to interact with dbt projects. The package is actively maintained, has low install friction, carries a permissive license, and exposes a comprehensive set of dbt operations through a standardized protocol. Start with a test integration to verify the tools you need are available and that your authentication setup works with your dbt environment.AI-flagged interpretation of the facts on this page — verify before relying
Before you install
- Requires Python 3.12 (supports_current).
- You must have dbt credentials configured (dbt Cloud API token or local dbt project) and a running dbt environment to connect to; the server itself does not operate standalone.
- Low friction installation with a pure-Python wheel.
License · maintenance · safety
permissive license (permissive) — Apache License 2.0 is permissive; you may use, modify, and distribute this package freely provided you retain license notices and include a copy of the license with any derivative works.
last release 2026-07-20 (25 days) · last repo commit 2026-08-14 · 596 stars
0 known vulnerabilities (OSV.dev, 2026-08-14) · 115,538 downloads/mo, #12,246 on PyPI
Alternatives
Verify before relying
pip install dbt-mcp
# Start the MCP server (requires dbt credentials and configuration)
python -m dbt_mcp.server
# In your MCP client, connect to the server and call tools like:
# { "name": "list_metrics", "arguments": {} }
# { "name": "get_lineage", "arguments": { "node_name": "my_model" } }- Whether all 14 runtime dependencies are required for basic operation or if some are optional based on which tools are used
- Performance characteristics when querying large dbt projects or executing complex lineage operations
- Whether the MCP server can be embedded in applications or is intended only for standalone agent integration
What it is and what it does
dbt-mcp is a Model Context Protocol server that bridges dbt projects and AI agents. It wraps dbt's discovery, semantic layer, admin, and CLI capabilities into standardized MCP tools that agents can call to understand project structure, execute queries, and trigger jobs. The server runs as a FastAPI application via uvicorn and exposes tools for SQL execution, metric queries, lineage traversal, model discovery, job management, and documentation search—all without requiring the agent to understand dbt's native APIs.
You install and run it to connect AI agents to your dbt environment. The server handles authentication via authlib and JWT, manages state with filelock, and communicates with dbt Platform or local dbt projects depending on which tools you invoke. It's designed for teams that want agents to reason about data models, suggest transformations, or automate dbt operations within a larger AI workflow.
Use it for
- Connect an AI agent to your dbt project so it can understand model lineage and suggest data transformations
- Enable an agent to execute metric queries and generate SQL from natural language descriptions of your data
- Automate dbt job triggering and monitoring through an agent interface without manual API calls
- Let an agent search dbt documentation and project resources to answer questions about your data architecture
- Generate boilerplate dbt YAML and SQL via an agent using codegen tools without manual scaffolding
Worth the install?
AI-flagged interpretation of the facts on this page. Verify before relying on it.
Yes, if you are building or using AI agents that need to interact with dbt projects.
The package is actively maintained, has low install friction, carries a permissive license, and exposes a comprehensive set of dbt operations through a standardized protocol. Start with a test integration to verify the tools you need are available and that your authentication setup works with your dbt environment.
Install
dbt-mcp on PyPI
Before you install
Low friction installation with a pure-Python wheel. Maintained actively with recent releases; last commit 2026-08-14 and 596 repository stars indicate ongoing development. Dependencies are pinned to specific versions with security-only updates.
Requires Python 3.12 (supports_current). You must have dbt credentials configured (dbt Cloud API token or local dbt project) and a running dbt environment to connect to; the server itself does not operate standalone.
License in practice
Apache License 2.0 is permissive; you may use, modify, and distribute this package freely provided you retain license notices and include a copy of the license with any derivative works.
Quickstart
pip install dbt-mcp
# Start the MCP server (requires dbt credentials and configuration)
python -m dbt_mcp.server
# In your MCP client, connect to the server and call tools like:
# { "name": "list_metrics", "arguments": {} }
# { "name": "get_lineage", "arguments": { "node_name": "my_model" } }Verify before relying
- Whether all 14 runtime dependencies are required for basic operation or if some are optional based on which tools are used
- Performance characteristics when querying large dbt projects or executing complex lineage operations
- Whether the MCP server can be embedded in applications or is intended only for standalone agent integration
Package facts
| License | permissive license permissive |
| Python support | Supports the current Python release <3.14,>=3.12 |
| Install friction | Low. Pure-Python wheel |
| Runtime dependencies | 14 packagesauthlibdbt-artifacts-parserdbt-protosdbt-sl-sdkdbtlabs-vortexfastapifilelockhttpxmcppydantic-settingspyjwtpyyamlstarletteuvicorn |
| Maintenance | Actively maintained 25 days since the last release |
| Last repo commit | |
| First released | |
| Downloads | 115,538 / month, #12,246 on PyPI 30-day window, as of 2026-08-14 |
| Known vulnerabilities | None known OSV.dev, checked 2026-08-14 |
| Classifiers | Development Status :: 5 - Production/StableIntended Audience :: DevelopersIntended Audience :: Information TechnologyIntended Audience :: System AdministratorsLicense :: OSI Approved :: Apache Software LicenseOperating System :: OS IndependentProgramming Language :: Python :: 3Topic :: Scientific/Engineering :: Information AnalysisTyping :: Typed |
Evidence: dbt_mcp-1.22.1-py3-none-any.whl
Tags
Let your AI agent find packages like this
Example. Real query, live index.
You found this page by searching. An agent finds it by wishing: SkillFed indexes 14,416 PyPI packages by what they can do, searchable in plain language.
wish › “mcp server for dbt”
- dbt-mcpExposes dbt project metadata and operations through a Model Context…
- dbt-sqlserverA dbt adapter that enables data transformation and testing workflows…
- dbt-core-interfaceProvides a lightweight Python interface to dbt-core (v1.8+) for…
Give your agent the search over MCP, or paste the wish link into any chat.
More Information Analysis packages
A drop-in replacement for Python's standard `re` module that adds advanced regex features like nested sets, fuzzy matching, lookaround in conditionals, and full Unicode case-folding while maintaining backward compatibility.
pyarrow provides Python bindings to Apache Arrow's C++ libraries for efficient columnar data processing, serialization, and interoperability with pandas, NumPy, and other Python ecosystem tools.
NetworkX provides data structures and algorithms for creating, analyzing, and manipulating graphs and networks, supporting everything from simple undirected graphs to complex directed and weighted networks.
Connects Python applications to Snowflake data warehouses using the DB API 2.0 specification, enabling SQL queries, data transfers, and warehouse operations.
ContourPy calculates contours of 2D quadrilateral grids using C++11 algorithms wrapped in Python, offering serial and multithreaded implementations without requiring Matplotlib as a dependency.
Snowpark Python provides APIs to query and process data directly in Snowflake without moving data to your local system, with support for both native Snowpark and pandas-compatible interfaces.
Install it if you use Snowflake and want to process data without moving it to your application layer.
See also opensearch-mcp-server-py · snowflake-labs-mcp · dbt-metabase · dbt-sl-sdk · awslabs.cloudwatch-mcp-server · dbt-colibri · dbt-core-experimental-parser · dbt-core · nextcloud-mcp-server · postgres-mcp