Databricks Field Guide MCP Server
Provides a Databricks field guide for learning Databricks, practicing certifications, answering engineering questions, reviewing Databricks code, estimating workload costs, and generating Databricks-related SQL, Python, YAML, Terraform, and toolkit templates. It is a read-only learning/reference server and does not connect to a Databricks workspace.
This server has a remotely hosted endpoint. Open its connector listing for connection details, authentication requirements, and setup instructions:
Databricks Field Guide MCP server
Learn Databricks, practice for a certification, and answer engineering questions with the Databricks Field Guide. Ask "Help me learn Databricks" to start a diagnostic, or "Help me prepare for Data Engineer Associate" to start domain practice. The assistant uses interactive MCP Apps cards where supported and asks one question at a time in text clients. Answers include the guide's source sections and official documentation links.
https://databricks.techfabric.com/mcpIt's a remote server over Streamable HTTP: no local server to run, no sign-in, and free public learning. The optional Claude Code plugin below bundles the connection and six skills; connecting MCP alone does not install skills.
Ask how to add a Unity Catalog row filter, and the agent gets the guide's section on it, the SQL function from that section and the Databricks documentation behind it. Databricks' own docs stay the authority on syntax and limits, which is why every answer links to them.
This isn't Databricks' own MCP server. Databricks runs managed MCP servers inside a workspace that act on your data. This one is built and run by TechFabric, a Databricks partner, and it never connects to a workspace.
What's in this repository
Registry descriptors and an optional client plugin. The official MCP Registry entry names this repository, and GitHub's MCP Registry shows this README in Copilot. The server's code isn't here and isn't open source.
File | What it is |
| The server's entry in the official MCP Registry, copied as published |
| Maintainer list for Glama |
| The TechFabric mark at 256 px, for dark and light backgrounds |
| Apache-2.0, for these files only |
| Claude Code marketplace descriptor |
| Anonymous MCP connection, six skills and a connection-check script |
The live server and the registry are the source of truth. If this README and
the server's tools/list ever disagree, the server is right. A weekly GitHub
Action compares server.json with the registry and opens a pull request when
the entry has changed.
Related MCP server: Databricks MCP Server
Add it to your agent
Claude Code
To install both skills and the connection, run in Claude Code:
/plugin marketplace add Fabric-Pro/databricks-field-guide-mcp
/plugin install field-guide@techfabric-field-guideStart a new session. The skills cover general Databricks questions, guided learning, certifications, code review, cost estimates and recent changes. They complement Databricks' development plugin, not replace workspace access or deployment tooling. Keep one Field Guide connection to avoid duplicate tools.
For just the MCP connection, without skills:
claude mcp add --transport http databricks-field-guide https://databricks.techfabric.com/mcpAdd --scope user to have it in every project.
agy
From a clone of this repository:
agy plugin install ./plugins/field-guideStart a new session. The native agy manifest and mcp_config.json bundle the
same six skills and preserve the HTTP connection without Claude-plugin conversion.
Claude Desktop and claude.ai
Open Customize, then Connectors, choose Add and then Add custom
connector. Name it, paste https://databricks.techfabric.com/mcp, keep the
authentication settings Claude detects, and choose Add. On a Team or
Enterprise plan, an owner may have to add the connector for the organisation
first.
ChatGPT
At chatgpt.com/plugins, choose + and then
Add custom MCP server. Paste the URL under Connection, choose no
authentication, and create it. In a chat, type @ and pick it. If Add custom
MCP server isn't there, your workspace's admin has to turn it on.
Codex
codex mcp add databricks-field-guide --url https://databricks.techfabric.com/mcpOr by hand, in ~/.codex/config.toml:
[mcp_servers.databricks-field-guide]
url = "https://databricks.techfabric.com/mcp"Cursor
In ~/.cursor/mcp.json for every project, or .cursor/mcp.json for one:
{
"mcpServers": {
"databricks-field-guide": { "url": "https://databricks.techfabric.com/mcp" }
}
}VS Code
In .vscode/mcp.json, then start it from that file or the MCP view. The tools
show up in Copilot's agent mode.
{
"servers": {
"databricks-field-guide": { "type": "http", "url": "https://databricks.techfabric.com/mcp" }
}
}GitHub Copilot
In VS Code, use the configuration above. Copilot CLI saves the server to
~/.copilot/mcp-config.json, for every project:
copilot mcp add --transport http databricks-field-guide https://databricks.techfabric.com/mcpCopilot's coding agent on github.com takes it in the repository's Settings, under Copilot and MCP servers. Every tool is read-only, so it can have all of them:
{
"mcpServers": {
"databricks-field-guide": {
"type": "http",
"url": "https://databricks.techfabric.com/mcp",
"tools": ["*"]
}
}
}Anything else
Point the client at the URL with the Streamable HTTP transport and no
authentication. A client that only speaks stdio can reach it through
mcp-remote:
npx mcp-remote https://databricks.techfabric.com/mcpGemini CLI and OpenCode each have their own line in the setup guide.
Tools
Tool | What it does |
| Starts a working diagnostic, a named concept lesson or certification practice, with an Apps card and text fallback |
| Finds the chapter sections, margin notes and events that answer a Databricks question, best first, each with its URL and section anchor |
| Reads a chapter, a margin note or one section of either as Markdown, with code, FAQs and the docs.databricks.com links it cites |
| Returns the SQL, Python, CLI and config blocks that match a topic, with the explanation around each one |
| Lists recent Databricks changes the guide tracks, newest first: margin notes, release-stage changes and updated chapters |
| The table of contents, with each chapter's part, summary, dates and main sections |
| Checks one SQL, Python or YAML file (a bundle, job, cluster or warehouse config) against the guide's own rules. Each finding gives the line, why, the fix, the guide's sentence with its section URL and the docs it cites, and the result lists the sections worth reading |
| Estimates a workload's monthly cost from the figures the guide states, as a range with its assumptions. Every number carries its source sentence, section URL, date and pricing page, and where the guide has no figure it says so instead of guessing |
| Opens a guided, interactive concept walkthrough |
| Asks sourced questions and scores the reader's actual answers |
| Provides role-based learning steps and checks progress supplied by the reader |
| Maps certification domains to guide coverage and official exam guides |
| Practices sourced terms by chapter or exam domain |
| Builds a guide-grounded diagram or chart |
| Compares engineering choices from the guide's stated trade-offs |
| Opens an interactive walkthrough of a chapter diagram |
| Says what TechFabric's free Chrome extension for Databricks (the TechFabric Toolkit for Databricks) does, feature by feature: where each shows up, whether it needs your connected workspace, and the tool here that does the same; plus install, permissions and privacy |
| Runs the extension's offline generators with its own code: Unity Catalog grants with rollback, table DDL and MERGE, bundle YAML and CLI, Terraform, Auto Loader, Lakeflow and CDC starters, data-quality checks, cost SQL, an error decoder, a pre-flight check for destructive SQL, MLflow and serving templates, and its snippet libraries |
All eighteen are read-only, and none calls a model: the review and the estimate are
deterministic checks against the guide's text, the toolkit's generators run the
extension's own code, and your agent does the reasoning. A rule applies only while the guide still says what it cites. The
rules leave out what the guide doesn't argue, such as SELECT * or collect()
on their own.
Three resources come with them: fieldguide://llms.txt, one line per page;
fieldguide://whats-new, the last 30 days of changes as JSON; and
fieldguide://page/{+path}, any published page as Markdown. Hosts that render
MCP Apps show the results as an interactive
view instead of plain text: since 1.3.0 that includes the review's findings and
the estimate as a table.
Prompts
Hosts that support MCP prompts show these as slash commands. In Claude Code
they're /mcp__databricks-field-guide__<name>.
Prompt | What it does |
| Starts a first learning or certification session |
| Teaches a topic with guide sections and practice |
| Runs a sourced quiz one question at a time |
| Opens an interactive concept explanation |
| Starts a role-based learning path |
| Prepares a certification's domain map and practice |
| Starts a recall deck |
| Estimates a named workload's cost from cited rates |
| Reviews this repository's Databricks setup against the guide. Your agent collects the bundles, notebooks, SQL and compute configs, runs |
| Estimates what the repository's workloads cost with |
| Summarises what Databricks changed lately and which of it touches this repository |
| Puts a chapter, or one section of it, into the conversation as Markdown |
| Finds the guide's code examples for a topic, optionally from one chapter |
Chapter and section arguments complete as you type, and so does the page
resource's path. MCP completes prompt arguments, not tool arguments, so these
prompts are where get_chapter's chapter names complete.
Notifications
On MCP 2026-07-28 a client can subscribe with subscriptions/listen to
fieldguide://whats-new or any fieldguide://page/.... When a deploy of the
guide changes a subscribed resource, such as a new margin note, a rewritten
chapter or a feature moving release stage, the server sends
notifications/resources/updated. Clients on 2025-11-25 have no stream to push
on, so they read whats_new instead.
Every answer says when its page last changed and how long a client may cache it: 10 minutes for what's new, 15 for search and an hour for chapters and code. The index is rebuilt on every deploy of the guide.
Things to ask
"Help me learn Databricks. Start with a short diagnostic."
"Help me prepare for Data Engineer Associate. Start practice now."
"Explain Unity Catalog interactively, then check my understanding."
"How do I add a Unity Catalog row filter? Use the Databricks Field Guide."
"What changed in Databricks in the last two weeks?"
"Get the Field Guide's SQL for a Unity Catalog column mask and apply it to the email column in my customers table."
"Read the Field Guide's Lakebase chapter and tell me whether branching fits our test environments."
"What does the Field Guide say about choosing compute to cut our Databricks bill?"
"Review this repo's Databricks bundle against the Field Guide." Or run
/mcp__databricks-field-guide__databricks-reviewin Claude Code."Estimate what a Medium Databricks App costs running office hours, using the Field Guide's figures."
"Check
pipelines/orders.sqlagainst the Field Guide and fix what it flags."
Sign-in, limits and privacy
From an installed plugin directory, node scripts/doctor.mjs checks anonymous
discovery, portable schemas, a working diagnostic, certification practice and
the Apps resource. Node.js 20 or newer is required. This is a connection check,
not proof that a particular host renders cards.
Practice comes from the guide, not real exam questions. Coverage gaps are shown; verify requirements against the linked official exam guide. The Field Guide is independent of Databricks and cannot guarantee a certification result or complete, up-to-the-minute platform coverage. Missing answers should be checked in official documentation. Progress stays in the conversation unless you ask to save it. Review skills ask before sending repository code; share only approved, sanitized files, without secrets or customer data.
There's no sign-in and no write tool. Each IP address gets 60 calls a minute
and 300 an hour; past that the server answers HTTP 429 with a Retry-After
header.
The server doesn't keep what you searched for or read, or the code you send
to review_databricks_code. A finding that quotes a line masks any secret on
it. The server's log line for a call names the tool and the protocol revision,
never the arguments. It stores two things: the per-IP call count, which expires
after about an hour, and one record per deploy of what changed, for
notifications. It makes no outbound request. The site's
privacy policy covers the rest.
It speaks MCP revision 2026-07-28, and clients still on 2025-11-25 are served on
the same URL. In the official registry it's
com.techfabric.databricks/field-guide.
Links
The Field Guide MCP server's documentation: every tool, resource and limit, and the setup for each client
License
The files in this repository are under the Apache License 2.0, copyright Tech Fabric LLC. The Field Guide's content and the server itself aren't covered by it.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Your Databricks Lakehouse in natural language: run SQL on your SQL warehouses, track long-running qu
Query your org's data in natural language — read-only MCP access to SQL, NoSQL, files & warehouses.
Services, case studies, 169 data and AI guides, and AI readiness scoring. Read-only, keyless.
Co-Learn with your Agent: fact-checked AI lessons with Human and Agent views.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceEnables AI assistants to interact with Databricks workspaces programmatically, providing comprehensive tools for cluster management, notebook operations, job orchestration, Unity Catalog data governance, user management, permissions control, and FinOps cost analytics.MIT
- FlicenseNot gradedqualityDmaintenanceEnables AI assistants to interact with Databricks workspaces by hosting secure MCP prompts and tools on Databricks Apps. It allows users to execute Python-based tools using the Databricks SDK and manage prompts through simple markdown files.-
- AlicenseNot gradedqualityDmaintenanceEnables AI agents to explore Unity Catalog metadata, execute SQL queries, and analyze data lineage including notebooks and jobs, empowering autonomous data discovery and query generation in Databricks.MIT
- FlicenseNot gradedqualityDmaintenanceEnables AI-assisted development by running and testing code directly on Databricks clusters via natural language, then deploying Databricks Asset Bundles.14-