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

This asset can be read and installed directly by agents

TokRepo exposes a universal CLI command, install contract, metadata JSON, adapter-aware plan, and raw content links so agents can judge fit, risk, and next actions.

Native · 94/100Policy: allow
Agent surface
Any MCP/CLI agent
Kind
Mcp
Install
Manual
Trust
Trust: Established
Entrypoint
docker compose
Universal CLI install command
npx tokrepo install bab8a6ee-81d5-5f82-8afb-f9b2645b7a39
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