Genie Agent
The Genie Agent MCP server is a Databricks managed MCP server that lets an agent query a single Genie Agent with natural language, without writing SQL. The agent sends a plain-language question, and Genie writes and runs the SQL against that agent's tables and returns the result, with Unity Catalog permissions enforced on every request.
A Genie Agent is a collection of up to 25 Unity Catalog tables that Genie keeps in context, so the server is scoped to that curated data rather than your whole workspace.
URL pattern | OAuth scope |
|---|---|
|
|
Connect an agent
To connect an agent to a Genie Agent MCP server, create a Genie Agent, share it with the users or service principals that need access, and point your agent at the pre-configured MCP URL for the space. For step-by-step setup and code examples across the OpenAI Agents SDK, LangGraph, and Model Serving, see Query data in Unity Catalog tables.
To connect external clients such as Cursor or Claude Desktop, see Connect MCPs to AI assistants and coding agents.
Limitations
- Read-only. The Genie Agent MCP server queries data; it doesn't write to your tables.
- No conversation history. The server invokes Genie as a tool, so it doesn't pass conversation history to the Genie API. To preserve history across turns, use Genie in a multi-agent system.