Connect Genie Code to MCP servers

Connect Genie Code to external tools and data sources through the Model Context Protocol (MCP). Genie Code can use any MCP servers that have been added to your workspace and that you have permission to use.

Note

MCP servers are only supported in Genie Code Agent mode.

What is MCP?

MCP is an open source standard that connects AI agents to tools, resources, prompts, and other contextual information. MCP provides a standardized way to expose tools, data, and workflows to Genie Code without embedding that context directly into prompts or instructions.

MCP is designed for cases where important context already exists but is difficult to access from an AI agent, like Genie Code. MCP offers a secure way to give Genie Code access to context like the following:

• Documentation systems: Teams often keep runbooks or operational docs in tools like Confluence. Instead of copying sections into prompts, that content can be exposed once through an external MCP server and referenced when relevant. Your documents might also already be in Databricks as a vector search index, which Genie Code can use to query relevant documents.
• Tools and services: Platform teams may maintain APIs or scripts for setup, validation, or deployment. MCP allows those capabilities to be made directly available to Genie Code.
• Data sources: If you already have data in Databricks, you can connect Genie Code to a Genie space to help you analyze the data using natural language. For data stored outside of Databricks, you can give Genie Code secure access through external MCP servers.
• Custom apps: You can also add custom functionality hosted via Databricks Apps. This allows you to connect Genie Code to proprietary tools, workflows, or integrations built specifically for you or your organization, all managed securely within your Databricks workspace.

In these cases, MCP replaces manual copy-pasting with a structured, reusable approach, making the right context available only when it is needed.

You can connect Genie Code to any MCP servers in your workspace that you have permission to use. Workspace admins control which servers are available, while users can select from those approved sources as needed.

To learn more about MCP servers in Databricks and how to create your own, see Model Context Protocol (MCP) on Databricks.

Add MCP servers to Genie Code

To connect Genie Code to an MCP server, add it in your Genie Code settings:

1. Open Genie Code settings. In Genie Code panel, click Settings.
2. Under MCP Servers, click Add Server.
3. Select the MCP server(s) you want to add. You can select Databricks managed MCP servers or external MCP servers:
   • Unity Catalog function: Select the schema(s) for the function(s). This allows Genie Code to use functions to run predefined SQL queries.
     • For help on adding Github MCP servers, see create a Github MCP server
   • Vector search: Select the schema(s) for the index(es). This allows Genie Code to query the vector search index to find relevant documents.
   • Genie space: Select the Genie space(s). The Genie MCP invokes Genie as a tool, allowing you to query the Genie space(s) to analyze data using natural language.
   • Unity Catalog connection: Select the connection(s) to use as external MCP servers. You must log in to the connection first before it can be used.
   • Databricks App: Select the App(s) to use as custom MCP servers. This allows you to use any custom-defined tools.
4. Click Save.

After they've been added, MCP servers are immediately available to Genie Code. You can start using them in Agent mode without changing your prompts or instructions. Genie Code will automatically draw on these servers when relevant.

Currently, MCP access is limited to 20 tools across all servers. You can choose which tools and servers to enable or disable in your Genie Code settings.