MCP ConfigsMay 12, 2026·2 min read

Ragstar — dbt Knowledge Base + OAuth MCP Server

Ragstar is a self-hosted dbt knowledge base with a web UI and an OAuth-protected MCP server so agents can search models, lineage, and docs safely.

Agent ready

Safe staging for this asset

This asset is staged first. The copied prompt tells the agent to inspect the staged files and ask before activating scripts, MCP config, or global config.

Stage only · 17/100Policy: stage
Agent surface
Any MCP/CLI agent
Kind
Mcp Config
Install
Stage only
Trust
Trust: Established
Entrypoint
Asset
Safe staging command
npx -y tokrepo@latest install bab8a6ee-81d5-5f82-8afb-f9b2645b7a39 --target codex

Stages files first; activation requires review of the staged README and plan.

Intro

Ragstar is a self-hosted dbt knowledge base with a web UI and an OAuth-protected MCP server so agents can search models, lineage, and docs safely.

  • Best for: data teams using dbt who want an LLM-facing knowledge base with tools (not just exported docs)
  • Works with: Docker Compose, Postgres + Redis in the stack, dbt project docs/metadata, MCP clients for the built-in server
  • Setup time: 25-60 minutes

Practical Notes

  • Quant: the stack exposes multiple services (UI, API, worker, MCP) so budget time for ports and env configuration.
  • Quant: the MCP server provides tools such as listing models, semantic search, and retrieving model details including lineage.

Rollout pattern

  • Connect one dbt project first and validate that search results map to real model owners and descriptions.
  • Decide which environments get MCP access; keep production knowledge bases separated from experiments.
  • Add an internal policy: agents may retrieve model details, but changes to dbt code still go through PR review.

Watchouts

Because Ragstar includes an MCP server and a web UI, treat it as a real internal service: OAuth configured, secrets managed, and environments separated.

FAQ

Q: Is the MCP server available in hosted mode? A: The README states MCP is only for self-hosted/open source deployments due to a 1:1 client-server relationship.

Q: What can the MCP server do? A: It can list dbt models, search semantically, and fetch model details and project summaries.

Q: What is the safest first use case? A: Use it as read-only discovery: find the right model and lineage, then do changes via PRs in your dbt repo.

🙏

Source & Thanks

Source: https://github.com/pragunbhutani/dbt-llm-agent > License: MIT > GitHub stars: 171 · forks: 32

Discussion

Sign in to join the discussion.
No comments yet. Be the first to share your thoughts.

Related Assets