Connections & Capabilities
Connects To
Capabilities
Quickstart
Config
{
"mcpServers": {
"dbt-mcp": {
"command": "uvx",
"args": [
"--env-file",
"<path-to-.env-file>",
"dbt-mcp"
]
},
}
}Exposed MCP Tools (7)
execute_sqlExecutes SQL queries on dbt Platform infrastructure, leveraging Semantic Layer support.
Direct SQL execution can modify or expose sensitive data.
text_to_sqlGenerates SQL from natural language, using the dbt project context for assistance.
Poorly generated SQL could lead to inefficient queries or unintended data access.
get_model_detailsRetrieves detailed information about a specific dbt model, including compiled SQL and column definitions.
Read-only access to model metadata.
buildExecutes dbt models, tests, snapshots, and seeds in the order defined by the DAG.
Can modify data and project state.
trigger_job_runTriggers a dbt Cloud job run, with options to override settings like git branch and schema.
Can trigger unintended or malicious job executions.
generate_model_yamlGenerates model YAML files with column definitions, optionally inheriting descriptions from upstream models.
Modifies dbt project structure.
get_mcp_server_versionReturns the current version of the dbt MCP server.
Provides version information only.
Safety Assessment
The dbt MCP server offers powerful capabilities, but requires careful configuration and monitoring. Read-only tools are generally safe, while tools that modify data or execute code should be used with caution. Proper access controls and monitoring are essential to mitigate risks.
- Granular tool-based access control.
- Some tools are read-only, limiting potential damage.
- Experimental MCP bundle allows for controlled import.
- Clear documentation encourages responsible use.
- Includes tools that can execute SQL and modify dbt projects.
- Admin API provides access to job management and project settings.
- Potential for data modification or deletion if tools are misused.
- Secrets exposure risk if not configured and managed correctly.
- Lack of explicit sandboxing for certain execution tools.
