MCP Server

Databricks MCP — Claude & ChatGPT Connector

MCP Databricks Endpoint (ChatGPT & Claude Connector)

URL: POST /api/mcp/databricks

Header:

  • Mcp-Session-Id (optional but recommended) — will be echoed back in every response.

Methods Supported (method):

  • initialize
  • notifications/initialized
  • ping
  • tools/list
  • tools/call

Example — List tools:

{ "jsonrpc": "2.0", "method": "tools/list", "params": {}, "id": 1 }

Example — Call tool:

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": { "name": "list_tables", "arguments": { "database": "datamarts", "schema": "gold" } },
  "id": 1
}

Tools

  • list_databases_and_schemas
  • list_tables
  • describe_table
  • query_table
  • execute_custom_query
  • search_tables
  • get_column_info

Security

  • Read-only enforced (blocks INSERT/UPDATE/DELETE/CREATE/DROP/etc.)
  • Row limit enforced
  • Session header echoed to prevent ChatGPT link expiry
post/api/mcp/databricks

Headers

Mcp-Session-Idstring nullable

Request body

jsonrpcstring

JSON-RPC version. Always '2.0'

methodstring

MCP method: initialize | tools/list | tools/call

paramsobject nullable

Method parameters. For tools/call: { name, arguments }

idinteger nullable

Request ID. Echoed back in response.

Response

Successful Response

{"stackTrail":"paths:/api/mcp/databricks:post:responses:200:content:application/json:schema","oasType":"schema","type":"unknown"}

Changes