CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

configuring-dbt-mcp-server

Generates MCP server configuration JSON, resolves authentication setup, and validates server connectivity for dbt. Use when setting up, configuring, or troubleshooting the dbt MCP server for AI tools like Claude Desktop, Claude Code, Cursor, or VS Code.

Quality

88%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

The canonical home for this skill is dbt-labs/dbt-agent-skills

SKILL.md
Quality
Evals
Security

Quality

Content

86%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

A highly actionable, well-structured skill: every configuration variant is copy-paste ready, clients are handled specifically, and detail is properly offloaded to clearly labeled reference files. The only weaknesses are minor redundancy between the mermaid flow and the questions section, and verification that stops short of inline error recovery.

Suggestions

Collapse the mermaid Decision Flow and the 'Questions to Ask' section into one representation, and merge the two overlapping Local/Remote table rows to remove contradictory-sounding framing.

Add a short inline verification step for the remote server (e.g., a curl or client-side check against the HTTP endpoint) and a one-line 'if this fails, see troubleshooting.md' pointer after each test to close the feedback loop.

DimensionReasoningScore

Conciseness

The body is dominated by directly usable material (JSON templates, commands, file paths) with almost no explanation of concepts Claude already knows. However, the mermaid decision flow duplicates the "Questions to Ask" section, and two Local/Remote table rows ("Required for development... can also connect... for consumption" vs "Works without a dbt platform account but can also connect... for development") overlap confusingly, which is trimmable redundancy.

4 / 5

Actionability

Copy-paste-ready JSON configs for every auth mode (CLI-only, OAuth, token, .env, remote), exact commands ("claude mcp add dbt -s user -- uvx dbt-mcp", "uvx --env-file .env dbt-mcp"), and precise client UI steps with config file locations. The common cases are fully covered with executable guidance.

5 / 5

Workflow Clarity

The sequence (decision questions → prerequisites → templates → client setup → verification) is clear and includes validation checkpoints ("No errors = successful configuration", client verification prompts, "MCP: List Servers"). It falls short of the 5 anchor because there is no inline failure-recovery loop (delegated entirely to references/troubleshooting.md) and no test procedure for the remote server configuration.

4 / 5

Progressive Disclosure

Three real, one-level-deep reference files (finding-credentials.md, troubleshooting.md, environment-variables.md) are clearly signaled with purpose statements ("for detailed guidance on obtaining tokens and IDs", "for common issues and fixes"), and detail content is appropriately split out while the core configs stay inline. No nested references; navigation is easy.

5 / 5

Total

18

/

20

Passed

Description

87%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A strong description: third-person voice, three concrete capabilities, and an explicit 'Use when...' clause naming the exact clients. It is specific and distinctive with only minor keyword-coverage gaps.

DimensionReasoningScore

Specificity

"Generates MCP server configuration JSON, resolves authentication setup, and validates server connectivity" lists three concrete, distinct actions covering the core workflow. Minor gaps keep it below the comprehensive 5 anchor (e.g., tool enabling and client-specific setup steps are not mentioned).

4 / 5

Completeness

Both halves are explicit: the what ("Generates MCP server configuration JSON, resolves authentication setup, and validates server connectivity") and an explicit "Use when setting up, configuring, or troubleshooting" trigger clause. This matches the 5 anchor with concrete trigger phrases; the 4 anchor applies only when the when-clause is less explicit.

5 / 5

Trigger Term Quality

"setting up, configuring, or troubleshooting the dbt MCP server" plus naming all four clients ("Claude Desktop, Claude Code, Cursor, or VS Code") gives good natural-keyword coverage. A few common phrasings like "connect dbt to Claude" or "MCP integration" are missing, so it is not a 5.

4 / 5

Distinctiveness Conflict Risk

"the dbt MCP server for AI tools like Claude Desktop, Claude Code, Cursor, or VS Code" carves out a clear niche with distinct triggers. It is narrowly scoped to dbt MCP setup, so conflict with other skills is minimal.

5 / 5

Total

18

/

20

Passed

Validation

93%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

metadata_version

'metadata.version' is missing

Warning

Total

15

/

16

Passed

Repository

dbt-labs/dbt-agent-skills

Path

skills/dbt/skills/configuring-dbt-mcp-server/SKILL.md

Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.