Databricks

Databricks MCP Server for Cloudflare Workers

Available Tools

112 tools available in the Databricks MCP server. Each tool can be called by AI assistants to perform specific actions.

databricks_delete_secret

Delete a secret.

Args:

scope: Scope name
key: Secret key

Returns: Confirmation of deletion.

{
  "type": "object",
  "required": [
    "scope",
    "key"
  ],
  "properties": {
    "key": {
      "type": "string",
      "description": "Secret key"
    },
    "scope": {
      "type": "string",
      "description": "Scope name"
    }
  }
}

databricks_list_secret_acls

List ACLs for a secret scope.

Args:

scope: Scope name

Returns: List of ACLs.

{
  "type": "object",
  "required": [
    "scope"
  ],
  "properties": {
    "scope": {
      "type": "string",
      "description": "Scope name"
    }
  }
}

databricks_get_experiment_by_name

Get an MLflow experiment by name.

Args:

experimentName: Experiment name/path

Returns: Experiment metadata.

{
  "type": "object",
  "required": [
    "experimentName"
  ],
  "properties": {
    "experimentName": {
      "type": "string",
      "description": "Experiment name"
    }
  }
}

databricks_list_schemas

List all schemas in a catalog.

Args:

catalogName: Catalog name

Returns: List of schemas.

{
  "type": "object",
  "required": [
    "catalogName"
  ],
  "properties": {
    "catalogName": {
      "type": "string",
      "description": "Catalog name"
    }
  }
}

databricks_get_cluster

Get details of a specific cluster.

Args:

clusterId: Cluster ID

Returns: Cluster configuration and status.

{
  "type": "object",
  "required": [
    "clusterId"
  ],
  "properties": {
    "clusterId": {
      "type": "string",
      "description": "Cluster ID"
    }
  }
}

databricks_list_clusters

List all clusters in the workspace.

Returns: List of clusters with their configuration and status.

{
  "type": "object",
  "properties": {}
}

databricks_get_model_version

Get details of a model version.

Args:

name: Model name
version: Version number

Returns: Model version details.

{
  "type": "object",
  "required": [
    "name",
    "version"
  ],
  "properties": {
    "name": {
      "type": "string",
      "description": "Model name"
    },
    "version": {
      "type": "string",
      "description": "Version number"
    }
  }
}

databricks_create_cluster

Create a new cluster.

Args:

clusterName: Name for the cluster
sparkVersion: Spark version (e.g., "13.3.x-scala2.12")
nodeTypeId: Node type ID (e.g., "i3.xlarge")
numWorkers: Number of worker nodes (for fixed-size clusters)
minWorkers: (Optional) Minimum workers for autoscaling
maxWorkers: (Optional) Maximum workers for autoscaling
autoterminationMinutes: (Optional) Auto-terminate after idle minutes

Returns: Created cluster ID.

{
  "type": "object",
  "required": [
    "clusterName",
    "sparkVersion",
    "nodeTypeId"
  ],
  "properties": {
    "maxWorkers": {
      "type": "integer",
      "minimum": 1,
      "description": "Max workers for autoscale"
    },
    "minWorkers": {
      "type": "integer",
      "minimum": 0,
      "description": "Min workers for autoscale"
    },
    "nodeTypeId": {
      "type": "string",
      "description": "Node type ID"
    },
    "numWorkers": {
      "type": "integer",
      "minimum": 0,
      "description": "Number of workers"
    },
    "clusterName": {
      "type": "string",
      "description": "Cluster name"
    },
    "sparkVersion": {
      "type": "string",
      "description": "Spark version"
    },
    "autoterminationMinutes": {
      "type": "integer",
      "minimum": 0,
      "description": "Auto-termination minutes"
    }
  }
}

databricks_start_cluster

Start a terminated cluster.

Args:

clusterId: Cluster ID to start

Returns: Confirmation that the cluster is starting.

{
  "type": "object",
  "required": [
    "clusterId"
  ],
  "properties": {
    "clusterId": {
      "type": "string",
      "description": "Cluster ID"
    }
  }
}

databricks_restart_cluster

Restart a running cluster.

Args:

clusterId: Cluster ID to restart

Returns: Confirmation that the cluster is restarting.

{
  "type": "object",
  "required": [
    "clusterId"
  ],
  "properties": {
    "clusterId": {
      "type": "string",
      "description": "Cluster ID"
    }
  }
}

databricks_terminate_cluster

Terminate a running cluster.

The cluster configuration is preserved and can be restarted later.

Args:

clusterId: Cluster ID to terminate

Returns: Confirmation that the cluster is terminating.

{
  "type": "object",
  "required": [
    "clusterId"
  ],
  "properties": {
    "clusterId": {
      "type": "string",
      "description": "Cluster ID"
    }
  }
}

databricks_delete_cluster

Permanently delete a cluster.

This removes the cluster completely. Use terminate_cluster to just stop it.

Args:

clusterId: Cluster ID to delete

Returns: Confirmation of deletion.

{
  "type": "object",
  "required": [
    "clusterId"
  ],
  "properties": {
    "clusterId": {
      "type": "string",
      "description": "Cluster ID"
    }
  }
}

databricks_list_cluster_events

List recent events for a cluster.

Args:

clusterId: Cluster ID
limit: (Optional) Maximum events to return (default: 50)

Returns: List of cluster events.

{
  "type": "object",
  "required": [
    "clusterId"
  ],
  "properties": {
    "limit": {
      "type": "integer",
      "maximum": 500,
      "minimum": 1,
      "description": "Maximum events"
    },
    "clusterId": {
      "type": "string",
      "description": "Cluster ID"
    }
  }
}

databricks_pin_cluster

Pin a cluster to ensure it appears in the cluster list.

Args:

clusterId: Cluster ID to pin

Returns: Confirmation of pinning.

{
  "type": "object",
  "required": [
    "clusterId"
  ],
  "properties": {
    "clusterId": {
      "type": "string",
      "description": "Cluster ID"
    }
  }
}

databricks_unpin_cluster

Unpin a cluster.

Args:

clusterId: Cluster ID to unpin

Returns: Confirmation of unpinning.

{
  "type": "object",
  "required": [
    "clusterId"
  ],
  "properties": {
    "clusterId": {
      "type": "string",
      "description": "Cluster ID"
    }
  }
}

databricks_list_dbfs

List files and directories in DBFS.

Args:

path: DBFS path (e.g., "/mnt/data" or "dbfs:/mnt/data")

Returns: List of files and directories with metadata.

{
  "type": "object",
  "required": [
    "path"
  ],
  "properties": {
    "path": {
      "type": "string",
      "description": "DBFS path"
    }
  }
}

databricks_get_dbfs_status

Get status/metadata of a DBFS path.

Args:

path: DBFS path

Returns: File or directory metadata.

{
  "type": "object",
  "required": [
    "path"
  ],
  "properties": {
    "path": {
      "type": "string",
      "description": "DBFS path"
    }
  }
}

databricks_mkdirs_dbfs

Create a directory in DBFS.

Creates parent directories as needed.

Args:

path: Directory path to create

Returns: Confirmation of creation.

{
  "type": "object",
  "required": [
    "path"
  ],
  "properties": {
    "path": {
      "type": "string",
      "description": "Directory path"
    }
  }
}

databricks_delete_dbfs

Delete a file or directory in DBFS.

Args:

path: Path to delete
recursive: (Optional) Delete recursively if directory (default: false)

Returns: Confirmation of deletion.

{
  "type": "object",
  "required": [
    "path"
  ],
  "properties": {
    "path": {
      "type": "string",
      "description": "Path to delete"
    },
    "recursive": {
      "type": "boolean",
      "description": "Delete recursively"
    }
  }
}

databricks_read_dbfs

Read contents of a file in DBFS.

For files larger than 1MB, use offset and length for chunked reading.

Args:

path: File path to read
offset: (Optional) Byte offset to start reading (default: 0)
length: (Optional) Number of bytes to read (default: 1MB, max: 1MB)

Returns: Base64-encoded file content and bytes read.

{
  "type": "object",
  "required": [
    "path"
  ],
  "properties": {
    "path": {
      "type": "string",
      "description": "File path"
    },
    "length": {
      "type": "integer",
      "maximum": 1048576,
      "minimum": 1,
      "description": "Bytes to read"
    },
    "offset": {
      "type": "integer",
      "minimum": 0,
      "description": "Byte offset"
    }
  }
}

databricks_put_dbfs

Write content to a file in DBFS.

For files larger than 1MB, use the streaming API (create, add_block, close).

Args:

path: Destination file path
contents: Base64-encoded content
overwrite: (Optional) Overwrite existing file (default: false)

Returns: Confirmation of write.

{
  "type": "object",
  "required": [
    "path",
    "contents"
  ],
  "properties": {
    "path": {
      "type": "string",
      "description": "Destination path"
    },
    "contents": {
      "type": "string",
      "description": "Base64-encoded content"
    },
    "overwrite": {
      "type": "boolean",
      "description": "Overwrite existing"
    }
  }
}

databricks_move_dbfs

Move a file or directory in DBFS.

Args:

sourcePath: Source path
destinationPath: Destination path

Returns: Confirmation of move.

{
  "type": "object",
  "required": [
    "sourcePath",
    "destinationPath"
  ],
  "properties": {
    "sourcePath": {
      "type": "string",
      "description": "Source path"
    },
    "destinationPath": {
      "type": "string",
      "description": "Destination path"
    }
  }
}

databricks_list_instance_pools

List all instance pools.

Returns: List of instance pools.

{
  "type": "object",
  "properties": {}
}

databricks_get_instance_pool

Get details of a specific instance pool.

Args:

instancePoolId: Instance pool ID

Returns: Instance pool details.

{
  "type": "object",
  "required": [
    "instancePoolId"
  ],
  "properties": {
    "instancePoolId": {
      "type": "string",
      "description": "Instance pool ID"
    }
  }
}

databricks_create_instance_pool

Create a new instance pool.

Args:

instancePoolName: Pool name
nodeTypeId: Node type ID
minIdleInstances: (Optional) Minimum idle instances
maxCapacity: (Optional) Maximum capacity
idleInstanceAutoterminationMinutes: (Optional) Auto-termination minutes

Returns: Created instance pool ID.

{
  "type": "object",
  "required": [
    "instancePoolName",
    "nodeTypeId"
  ],
  "properties": {
    "nodeTypeId": {
      "type": "string",
      "description": "Node type ID"
    },
    "maxCapacity": {
      "type": "integer",
      "minimum": 1,
      "description": "Maximum capacity"
    },
    "instancePoolName": {
      "type": "string",
      "description": "Pool name"
    },
    "minIdleInstances": {
      "type": "integer",
      "minimum": 0,
      "description": "Minimum idle instances"
    },
    "idleInstanceAutoterminationMinutes": {
      "type": "integer",
      "minimum": 0,
      "description": "Auto-termination minutes"
    }
  }
}

databricks_edit_instance_pool

Edit an existing instance pool.

Args:

instancePoolId: Instance pool ID
instancePoolName: New pool name
nodeTypeId: Node type ID
minIdleInstances: (Optional) Minimum idle instances
maxCapacity: (Optional) Maximum capacity

Returns: Confirmation of update.

{
  "type": "object",
  "required": [
    "instancePoolId",
    "instancePoolName",
    "nodeTypeId"
  ],
  "properties": {
    "nodeTypeId": {
      "type": "string",
      "description": "Node type ID"
    },
    "maxCapacity": {
      "type": "integer",
      "minimum": 1,
      "description": "Maximum capacity"
    },
    "instancePoolId": {
      "type": "string",
      "description": "Instance pool ID"
    },
    "instancePoolName": {
      "type": "string",
      "description": "Pool name"
    },
    "minIdleInstances": {
      "type": "integer",
      "minimum": 0,
      "description": "Minimum idle instances"
    }
  }
}

databricks_delete_instance_pool

Delete an instance pool.

Args:

instancePoolId: Instance pool ID

Returns: Confirmation of deletion.

{
  "type": "object",
  "required": [
    "instancePoolId"
  ],
  "properties": {
    "instancePoolId": {
      "type": "string",
      "description": "Instance pool ID"
    }
  }
}

databricks_list_jobs

List all jobs in the workspace.

Args:

limit: (Optional) Maximum number of jobs to return (default: 20)
offset: (Optional) Offset for pagination
name: (Optional) Filter jobs by name (substring match)

Returns: List of jobs with their settings and metadata.

{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "description": "Filter by job name"
    },
    "limit": {
      "type": "integer",
      "maximum": 100,
      "minimum": 1,
      "description": "Maximum jobs to return"
    },
    "offset": {
      "type": "integer",
      "minimum": 0,
      "description": "Pagination offset"
    }
  }
}

databricks_get_job

Get details of a specific job.

Args:

jobId: Job ID

Returns: Job configuration and metadata.

{
  "type": "object",
  "required": [
    "jobId"
  ],
  "properties": {
    "jobId": {
      "type": "integer",
      "description": "Job ID"
    }
  }
}

databricks_create_job

Create a new job.

Args:

name: Job name
tasks: Array of task definitions (JSON)
schedule: (Optional) Cron schedule expression
timezone: (Optional) Timezone for schedule (default: UTC)

Returns: Created job ID.

{
  "type": "object",
  "required": [
    "name",
    "tasks"
  ],
  "properties": {
    "name": {
      "type": "string",
      "description": "Job name"
    },
    "tasks": {
      "type": "string",
      "description": "Tasks configuration as JSON string"
    },
    "schedule": {
      "type": "string",
      "description": "Cron expression"
    },
    "timezone": {
      "type": "string",
      "description": "Timezone for schedule"
    }
  }
}

databricks_update_job

Update an existing job.

Args:

jobId: Job ID to update
settings: New job settings as JSON string

Returns: Confirmation of update.

{
  "type": "object",
  "required": [
    "jobId",
    "settings"
  ],
  "properties": {
    "jobId": {
      "type": "integer",
      "description": "Job ID"
    },
    "settings": {
      "type": "string",
      "description": "New settings as JSON string"
    }
  }
}

databricks_delete_job

Delete a job.

Args:

jobId: Job ID to delete

Returns: Confirmation of deletion.

{
  "type": "object",
  "required": [
    "jobId"
  ],
  "properties": {
    "jobId": {
      "type": "integer",
      "description": "Job ID"
    }
  }
}

databricks_run_job

Trigger a job run immediately.

Args:

jobId: Job ID to run
parameters: (Optional) Runtime parameters as JSON string

Returns: Run ID of the triggered run.

{
  "type": "object",
  "required": [
    "jobId"
  ],
  "properties": {
    "jobId": {
      "type": "integer",
      "description": "Job ID"
    },
    "parameters": {
      "type": "string",
      "description": "Runtime parameters as JSON"
    }
  }
}

databricks_list_runs

List job runs.

Args:

jobId: (Optional) Filter by job ID
activeOnly: (Optional) Only return active runs
completedOnly: (Optional) Only return completed runs
limit: (Optional) Maximum runs to return (default: 20)
offset: (Optional) Pagination offset

Returns: List of job runs with status.

{
  "type": "object",
  "properties": {
    "jobId": {
      "type": "integer",
      "description": "Filter by job ID"
    },
    "limit": {
      "type": "integer",
      "maximum": 100,
      "minimum": 1,
      "description": "Maximum runs to return"
    },
    "offset": {
      "type": "integer",
      "minimum": 0,
      "description": "Pagination offset"
    },
    "activeOnly": {
      "type": "boolean",
      "description": "Only active runs"
    },
    "completedOnly": {
      "type": "boolean",
      "description": "Only completed runs"
    }
  }
}

databricks_get_run

Get details of a specific job run.

Args:

runId: Run ID

Returns: Run details including status and tasks.

{
  "type": "object",
  "required": [
    "runId"
  ],
  "properties": {
    "runId": {
      "type": "integer",
      "description": "Run ID"
    }
  }
}

databricks_get_run_output

Get the output of a job run.

Args:

runId: Run ID

Returns: Run output including notebook output if applicable.

{
  "type": "object",
  "required": [
    "runId"
  ],
  "properties": {
    "runId": {
      "type": "integer",
      "description": "Run ID"
    }
  }
}

databricks_cancel_run

Cancel a running job run.

Args:

runId: Run ID to cancel

Returns: Confirmation of cancellation.

{
  "type": "object",
  "required": [
    "runId"
  ],
  "properties": {
    "runId": {
      "type": "integer",
      "description": "Run ID"
    }
  }
}

databricks_cancel_all_runs

Cancel all active runs of a job.

Args:

jobId: Job ID

Returns: Confirmation of cancellation.

{
  "type": "object",
  "required": [
    "jobId"
  ],
  "properties": {
    "jobId": {
      "type": "integer",
      "description": "Job ID"
    }
  }
}

databricks_list_experiments

List MLflow experiments.

Args:

maxResults: (Optional) Maximum experiments to return
pageToken: (Optional) Pagination token

Returns: List of experiments.

{
  "type": "object",
  "properties": {
    "pageToken": {
      "type": "string",
      "description": "Pagination token"
    },
    "maxResults": {
      "type": "integer",
      "maximum": 1000,
      "minimum": 1,
      "description": "Maximum results"
    }
  }
}

databricks_get_experiment

Get details of an MLflow experiment.

Args:

experimentId: Experiment ID

Returns: Experiment metadata.

{
  "type": "object",
  "required": [
    "experimentId"
  ],
  "properties": {
    "experimentId": {
      "type": "string",
      "description": "Experiment ID"
    }
  }
}

databricks_create_experiment

Create a new MLflow experiment.

Args:

name: Experiment name (workspace path)
artifactLocation: (Optional) Location to store artifacts

Returns: Created experiment ID.

{
  "type": "object",
  "required": [
    "name"
  ],
  "properties": {
    "name": {
      "type": "string",
      "description": "Experiment name"
    },
    "artifactLocation": {
      "type": "string",
      "description": "Artifact location"
    }
  }
}

databricks_delete_experiment

Delete an MLflow experiment.

Args:

experimentId: Experiment ID

Returns: Confirmation of deletion.

{
  "type": "object",
  "required": [
    "experimentId"
  ],
  "properties": {
    "experimentId": {
      "type": "string",
      "description": "Experiment ID"
    }
  }
}

databricks_restore_experiment

Restore a deleted MLflow experiment.

Args:

experimentId: Experiment ID

Returns: Confirmation of restoration.

{
  "type": "object",
  "required": [
    "experimentId"
  ],
  "properties": {
    "experimentId": {
      "type": "string",
      "description": "Experiment ID"
    }
  }
}

databricks_search_runs

Search for MLflow runs.

Args:

experimentIds: Array of experiment IDs to search
filter: (Optional) Filter string (e.g., "metrics.accuracy > 0.9")
maxResults: (Optional) Maximum results to return
orderBy: (Optional) Order by fields (e.g., ["metrics.accuracy DESC"])
pageToken: (Optional) Pagination token

Returns: List of matching runs.

{
  "type": "object",
  "required": [
    "experimentIds"
  ],
  "properties": {
    "filter": {
      "type": "string",
      "description": "Filter expression"
    },
    "orderBy": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Order by fields"
    },
    "pageToken": {
      "type": "string",
      "description": "Pagination token"
    },
    "maxResults": {
      "type": "integer",
      "maximum": 50000,
      "minimum": 1,
      "description": "Maximum results"
    },
    "experimentIds": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Experiment IDs"
    }
  }
}

databricks_create_run

Create a new MLflow run.

Args:

experimentId: Experiment ID
runName: (Optional) Run name
tags: (Optional) Tags as JSON array [{key, value}]

Returns: Created run details.

{
  "type": "object",
  "required": [
    "experimentId"
  ],
  "properties": {
    "tags": {
      "type": "string",
      "description": "Tags as JSON array"
    },
    "runName": {
      "type": "string",
      "description": "Run name"
    },
    "experimentId": {
      "type": "string",
      "description": "Experiment ID"
    }
  }
}

databricks_update_run

Update an MLflow run status.

Args:

runId: Run ID
status: New status (RUNNING, SCHEDULED, FINISHED, FAILED, KILLED)
endTime: (Optional) End timestamp in milliseconds

Returns: Confirmation of update.

{
  "type": "object",
  "required": [
    "runId",
    "status"
  ],
  "properties": {
    "runId": {
      "type": "string",
      "description": "Run ID"
    },
    "status": {
      "enum": [
        "RUNNING",
        "SCHEDULED",
        "FINISHED",
        "FAILED",
        "KILLED"
      ],
      "type": "string",
      "description": "Status"
    },
    "endTime": {
      "type": "integer",
      "description": "End timestamp (ms)"
    }
  }
}

databricks_delete_run

Delete an MLflow run.

Args:

runId: Run ID

Returns: Confirmation of deletion.

{
  "type": "object",
  "required": [
    "runId"
  ],
  "properties": {
    "runId": {
      "type": "string",
      "description": "Run ID"
    }
  }
}

databricks_log_metric

Log a metric to an MLflow run.

Args:

runId: Run ID
key: Metric name
value: Metric value
timestamp: (Optional) Timestamp in milliseconds
step: (Optional) Step number

Returns: Confirmation of logging.

{
  "type": "object",
  "required": [
    "runId",
    "key",
    "value"
  ],
  "properties": {
    "key": {
      "type": "string",
      "description": "Metric name"
    },
    "step": {
      "type": "integer",
      "description": "Step number"
    },
    "runId": {
      "type": "string",
      "description": "Run ID"
    },
    "value": {
      "type": "number",
      "description": "Metric value"
    },
    "timestamp": {
      "type": "integer",
      "description": "Timestamp (ms)"
    }
  }
}

databricks_log_param

Log a parameter to an MLflow run.

Args:

runId: Run ID
key: Parameter name
value: Parameter value

Returns: Confirmation of logging.

{
  "type": "object",
  "required": [
    "runId",
    "key",
    "value"
  ],
  "properties": {
    "key": {
      "type": "string",
      "description": "Parameter name"
    },
    "runId": {
      "type": "string",
      "description": "Run ID"
    },
    "value": {
      "type": "string",
      "description": "Parameter value"
    }
  }
}

databricks_set_tag

Set a tag on an MLflow run.

Args:

runId: Run ID
key: Tag name
value: Tag value

Returns: Confirmation of setting.

{
  "type": "object",
  "required": [
    "runId",
    "key",
    "value"
  ],
  "properties": {
    "key": {
      "type": "string",
      "description": "Tag name"
    },
    "runId": {
      "type": "string",
      "description": "Run ID"
    },
    "value": {
      "type": "string",
      "description": "Tag value"
    }
  }
}

databricks_list_models

List registered MLflow models.

Args:

maxResults: (Optional) Maximum models to return
pageToken: (Optional) Pagination token

Returns: List of registered models.

{
  "type": "object",
  "properties": {
    "pageToken": {
      "type": "string",
      "description": "Pagination token"
    },
    "maxResults": {
      "type": "integer",
      "maximum": 1000,
      "minimum": 1,
      "description": "Maximum results"
    }
  }
}

databricks_get_model

Get details of a registered model.

Args:

name: Model name

Returns: Model metadata including versions.

{
  "type": "object",
  "required": [
    "name"
  ],
  "properties": {
    "name": {
      "type": "string",
      "description": "Model name"
    }
  }
}

databricks_create_model

Create a new registered model.

Args:

name: Model name
description: (Optional) Model description
tags: (Optional) Tags as JSON array [{key, value}]

Returns: Created model details.

{
  "type": "object",
  "required": [
    "name"
  ],
  "properties": {
    "name": {
      "type": "string",
      "description": "Model name"
    },
    "tags": {
      "type": "string",
      "description": "Tags as JSON array"
    },
    "description": {
      "type": "string",
      "description": "Model description"
    }
  }
}

databricks_delete_model

Delete a registered model.

Args:

name: Model name

Returns: Confirmation of deletion.

{
  "type": "object",
  "required": [
    "name"
  ],
  "properties": {
    "name": {
      "type": "string",
      "description": "Model name"
    }
  }
}

databricks_list_model_versions

List versions of a registered model.

Args:

name: Model name

Returns: List of model versions.

{
  "type": "object",
  "required": [
    "name"
  ],
  "properties": {
    "name": {
      "type": "string",
      "description": "Model name"
    }
  }
}

databricks_delete_model_version

Delete a model version.

Args:

name: Model name
version: Version number

Returns: Confirmation of deletion.

{
  "type": "object",
  "required": [
    "name",
    "version"
  ],
  "properties": {
    "name": {
      "type": "string",
      "description": "Model name"
    },
    "version": {
      "type": "string",
      "description": "Version number"
    }
  }
}

databricks_list_pipelines

List Delta Live Tables pipelines.

Args:

maxResults: (Optional) Maximum pipelines to return
pageToken: (Optional) Pagination token
filter: (Optional) Filter expression

Returns: List of pipelines.

{
  "type": "object",
  "properties": {
    "filter": {
      "type": "string",
      "description": "Filter expression"
    },
    "pageToken": {
      "type": "string",
      "description": "Pagination token"
    },
    "maxResults": {
      "type": "integer",
      "maximum": 100,
      "minimum": 1,
      "description": "Maximum results"
    }
  }
}

databricks_get_pipeline

Get details of a specific pipeline.

Args:

pipelineId: Pipeline ID

Returns: Pipeline details including status and configuration.

{
  "type": "object",
  "required": [
    "pipelineId"
  ],
  "properties": {
    "pipelineId": {
      "type": "string",
      "description": "Pipeline ID"
    }
  }
}

databricks_create_pipeline

Create a new Delta Live Tables pipeline.

Args:

name: Pipeline name
spec: Pipeline specification as JSON string

Returns: Created pipeline ID.

{
  "type": "object",
  "required": [
    "name",
    "spec"
  ],
  "properties": {
    "name": {
      "type": "string",
      "description": "Pipeline name"
    },
    "spec": {
      "type": "string",
      "description": "Pipeline specification as JSON"
    }
  }
}

databricks_update_pipeline

Update an existing pipeline.

Args:

pipelineId: Pipeline ID
spec: Updated pipeline specification as JSON string

Returns: Confirmation of update.

{
  "type": "object",
  "required": [
    "pipelineId",
    "spec"
  ],
  "properties": {
    "spec": {
      "type": "string",
      "description": "Updated specification as JSON"
    },
    "pipelineId": {
      "type": "string",
      "description": "Pipeline ID"
    }
  }
}

databricks_delete_pipeline

Delete a pipeline.

Args:

pipelineId: Pipeline ID

Returns: Confirmation of deletion.

{
  "type": "object",
  "required": [
    "pipelineId"
  ],
  "properties": {
    "pipelineId": {
      "type": "string",
      "description": "Pipeline ID"
    }
  }
}

databricks_start_pipeline

Start a pipeline update.

Args:

pipelineId: Pipeline ID
fullRefresh: (Optional) Perform a full refresh (default: false)

Returns: Update ID.

{
  "type": "object",
  "required": [
    "pipelineId"
  ],
  "properties": {
    "pipelineId": {
      "type": "string",
      "description": "Pipeline ID"
    },
    "fullRefresh": {
      "type": "boolean",
      "description": "Perform full refresh"
    }
  }
}

databricks_stop_pipeline

Stop a running pipeline.

Args:

pipelineId: Pipeline ID

Returns: Confirmation of stop.

{
  "type": "object",
  "required": [
    "pipelineId"
  ],
  "properties": {
    "pipelineId": {
      "type": "string",
      "description": "Pipeline ID"
    }
  }
}

databricks_list_repos

List Git repos in the workspace.

Args:

pathPrefix: (Optional) Filter by path prefix
pageToken: (Optional) Pagination token

Returns: List of repos.

{
  "type": "object",
  "properties": {
    "pageToken": {
      "type": "string",
      "description": "Pagination token"
    },
    "pathPrefix": {
      "type": "string",
      "description": "Filter by path prefix"
    }
  }
}

databricks_get_repo

Get details of a specific repo.

Args:

repoId: Repo ID

Returns: Repo details including branch info.

{
  "type": "object",
  "required": [
    "repoId"
  ],
  "properties": {
    "repoId": {
      "type": "integer",
      "description": "Repo ID"
    }
  }
}

databricks_create_repo

Create a new Git repo in the workspace.

Args:

url: Git repository URL
provider: Git provider (e.g., gitHub, bitbucketCloud, gitLab)
path: (Optional) Workspace path for the repo

Returns: Created repo details.

{
  "type": "object",
  "required": [
    "url",
    "provider"
  ],
  "properties": {
    "url": {
      "type": "string",
      "description": "Git repository URL"
    },
    "path": {
      "type": "string",
      "description": "Workspace path"
    },
    "provider": {
      "type": "string",
      "description": "Git provider"
    }
  }
}

databricks_update_repo

Update a repo (switch branch or tag).

Args:

repoId: Repo ID
branch: (Optional) Branch to checkout
tag: (Optional) Tag to checkout

Returns: Updated repo details.

{
  "type": "object",
  "required": [
    "repoId"
  ],
  "properties": {
    "tag": {
      "type": "string",
      "description": "Tag to checkout"
    },
    "branch": {
      "type": "string",
      "description": "Branch to checkout"
    },
    "repoId": {
      "type": "integer",
      "description": "Repo ID"
    }
  }
}

databricks_delete_repo

Delete a repo from the workspace.

Args:

repoId: Repo ID

Returns: Confirmation of deletion.

{
  "type": "object",
  "required": [
    "repoId"
  ],
  "properties": {
    "repoId": {
      "type": "integer",
      "description": "Repo ID"
    }
  }
}

databricks_list_git_credentials

List Git credentials for the current user.

Returns: List of Git credentials.

{
  "type": "object",
  "properties": {}
}

databricks_create_git_credential

Create a new Git credential.

Args:

provider: Git provider (e.g., gitHub, bitbucketCloud, gitLab)
username: Git username
personalAccessToken: Personal access token

Returns: Created credential details.

{
  "type": "object",
  "required": [
    "provider",
    "username",
    "personalAccessToken"
  ],
  "properties": {
    "provider": {
      "type": "string",
      "description": "Git provider"
    },
    "username": {
      "type": "string",
      "description": "Git username"
    },
    "personalAccessToken": {
      "type": "string",
      "description": "Personal access token"
    }
  }
}

databricks_delete_git_credential

Delete a Git credential.

Args:

credentialId: Credential ID

Returns: Confirmation of deletion.

{
  "type": "object",
  "required": [
    "credentialId"
  ],
  "properties": {
    "credentialId": {
      "type": "integer",
      "description": "Credential ID"
    }
  }
}

databricks_list_secret_scopes

List all secret scopes.

Returns: List of secret scopes.

{
  "type": "object",
  "properties": {}
}

databricks_create_secret_scope

Create a new secret scope.

Args:

scope: Scope name

Returns: Confirmation of creation.

{
  "type": "object",
  "required": [
    "scope"
  ],
  "properties": {
    "scope": {
      "type": "string",
      "description": "Scope name"
    }
  }
}

databricks_delete_secret_scope

Delete a secret scope.

This also deletes all secrets and ACLs in the scope.

Args:

scope: Scope name

Returns: Confirmation of deletion.

{
  "type": "object",
  "required": [
    "scope"
  ],
  "properties": {
    "scope": {
      "type": "string",
      "description": "Scope name"
    }
  }
}

databricks_list_secrets

List secrets in a scope.

Note: This lists secret metadata only, not the actual values.

Args:

scope: Scope name

Returns: List of secret keys.

{
  "type": "object",
  "required": [
    "scope"
  ],
  "properties": {
    "scope": {
      "type": "string",
      "description": "Scope name"
    }
  }
}

databricks_put_secret

Create or update a secret.

Args:

scope: Scope name
key: Secret key
value: Secret value (will be stored securely)

Returns: Confirmation of storage.

{
  "type": "object",
  "required": [
    "scope",
    "key",
    "value"
  ],
  "properties": {
    "key": {
      "type": "string",
      "description": "Secret key"
    },
    "scope": {
      "type": "string",
      "description": "Scope name"
    },
    "value": {
      "type": "string",
      "description": "Secret value"
    }
  }
}

databricks_get_secret_acl

Get ACL for a principal on a scope.

Args:

scope: Scope name
principal: Principal name (user or group)

Returns: ACL details.

{
  "type": "object",
  "required": [
    "scope",
    "principal"
  ],
  "properties": {
    "scope": {
      "type": "string",
      "description": "Scope name"
    },
    "principal": {
      "type": "string",
      "description": "Principal name"
    }
  }
}

databricks_put_secret_acl

Set ACL for a principal on a scope.

Args:

scope: Scope name
principal: Principal name (user or group)
permission: Permission level (READ, WRITE, or MANAGE)

Returns: Confirmation of setting.

{
  "type": "object",
  "required": [
    "scope",
    "principal",
    "permission"
  ],
  "properties": {
    "scope": {
      "type": "string",
      "description": "Scope name"
    },
    "principal": {
      "type": "string",
      "description": "Principal name"
    },
    "permission": {
      "enum": [
        "READ",
        "WRITE",
        "MANAGE"
      ],
      "type": "string",
      "description": "Permission level"
    }
  }
}

databricks_delete_secret_acl

Delete ACL for a principal on a scope.

Args:

scope: Scope name
principal: Principal name (user or group)

Returns: Confirmation of deletion.

{
  "type": "object",
  "required": [
    "scope",
    "principal"
  ],
  "properties": {
    "scope": {
      "type": "string",
      "description": "Scope name"
    },
    "principal": {
      "type": "string",
      "description": "Principal name"
    }
  }
}

databricks_execute_sql

Execute a SQL statement on a Databricks SQL warehouse.

The statement will be executed and results returned inline if they complete within the timeout. For long-running queries, use databricks_get_sql_status to poll for completion.

Args:

warehouseId: SQL warehouse ID to execute on
statement: SQL statement to execute
catalog: (Optional) Default catalog for the statement
schema: (Optional) Default schema for the statement
waitTimeout: (Optional) Time to wait for results (e.g., "50s", default: "50s")
format: (Optional) Result format: JSON_ARRAY, CSV, or ARROW_STREAM

Returns: Statement ID and status. If completed, includes result data.

{
  "type": "object",
  "required": [
    "warehouseId",
    "statement"
  ],
  "properties": {
    "format": {
      "enum": [
        "JSON_ARRAY",
        "CSV",
        "ARROW_STREAM"
      ],
      "type": "string",
      "description": "Result format"
    },
    "schema": {
      "type": "string",
      "description": "Default schema"
    },
    "catalog": {
      "type": "string",
      "description": "Default catalog"
    },
    "statement": {
      "type": "string",
      "description": "SQL statement to execute"
    },
    "waitTimeout": {
      "type": "string",
      "description": "Wait timeout (e.g., \"50s"
    },
    "warehouseId": {
      "type": "string",
      "description": "SQL warehouse ID"
    }
  }
}

databricks_get_sql_status

Get the status and results of a SQL statement.

Use this to poll for completion of long-running queries or to retrieve results.

Args:

statementId: Statement ID from executeStatement

Returns: Statement status and results if available.

{
  "type": "object",
  "required": [
    "statementId"
  ],
  "properties": {
    "statementId": {
      "type": "string",
      "description": "Statement ID"
    }
  }
}

databricks_get_sql_result_chunk

Get a specific chunk of SQL statement results.

For large results that are split into multiple chunks, use this to fetch each chunk.

Args:

statementId: Statement ID
chunkIndex: Chunk index (0-based)

Returns: Result data for the specified chunk.

{
  "type": "object",
  "required": [
    "statementId",
    "chunkIndex"
  ],
  "properties": {
    "chunkIndex": {
      "type": "integer",
      "minimum": 0,
      "description": "Chunk index (0-based)"
    },
    "statementId": {
      "type": "string",
      "description": "Statement ID"
    }
  }
}

databricks_cancel_sql

Cancel a running SQL statement.

Args:

statementId: Statement ID to cancel

Returns: Confirmation of cancellation.

{
  "type": "object",
  "required": [
    "statementId"
  ],
  "properties": {
    "statementId": {
      "type": "string",
      "description": "Statement ID to cancel"
    }
  }
}

databricks_list_warehouses

List all SQL warehouses in the workspace.

Returns: List of SQL warehouses with their status and configuration.

{
  "type": "object",
  "properties": {}
}

databricks_get_warehouse

Get details of a specific SQL warehouse.

Args:

warehouseId: SQL warehouse ID

Returns: Warehouse configuration and status.

{
  "type": "object",
  "required": [
    "warehouseId"
  ],
  "properties": {
    "warehouseId": {
      "type": "string",
      "description": "SQL warehouse ID"
    }
  }
}

databricks_start_warehouse

Start a stopped SQL warehouse.

Args:

warehouseId: SQL warehouse ID to start

Returns: Confirmation that the warehouse is starting.

{
  "type": "object",
  "required": [
    "warehouseId"
  ],
  "properties": {
    "warehouseId": {
      "type": "string",
      "description": "SQL warehouse ID"
    }
  }
}

databricks_stop_warehouse

Stop a running SQL warehouse.

Args:

warehouseId: SQL warehouse ID to stop

Returns: Confirmation that the warehouse is stopping.

{
  "type": "object",
  "required": [
    "warehouseId"
  ],
  "properties": {
    "warehouseId": {
      "type": "string",
      "description": "SQL warehouse ID"
    }
  }
}

databricks_list_tokens

List all personal access tokens for the current user.

Returns: List of token metadata (not the actual token values).

{
  "type": "object",
  "properties": {}
}

databricks_get_function

Get details of a specific function.

Args:

fullName: Full function name (catalog.schema.function)

Returns: Function metadata.

{
  "type": "object",
  "required": [
    "fullName"
  ],
  "properties": {
    "fullName": {
      "type": "string",
      "description": "Full function name (catalog.schema.function)"
    }
  }
}

databricks_create_token

Create a new personal access token.

Args:

comment: (Optional) Token description
lifetimeSeconds: (Optional) Token lifetime in seconds (default: 90 days)

Returns: Token value (shown only once) and metadata.

{
  "type": "object",
  "properties": {
    "comment": {
      "type": "string",
      "description": "Token description"
    },
    "lifetimeSeconds": {
      "type": "integer",
      "minimum": 60,
      "description": "Lifetime in seconds"
    }
  }
}

databricks_revoke_token

Revoke a personal access token.

Args:

tokenId: Token ID to revoke

Returns: Confirmation of revocation.

{
  "type": "object",
  "required": [
    "tokenId"
  ],
  "properties": {
    "tokenId": {
      "type": "string",
      "description": "Token ID"
    }
  }
}

databricks_list_catalogs

List all catalogs in Unity Catalog.

Returns: List of catalogs with metadata.

{
  "type": "object",
  "properties": {}
}

databricks_get_catalog

Get details of a specific catalog.

Args:

name: Catalog name

Returns: Catalog metadata and properties.

{
  "type": "object",
  "required": [
    "name"
  ],
  "properties": {
    "name": {
      "type": "string",
      "description": "Catalog name"
    }
  }
}

databricks_create_catalog

Create a new catalog in Unity Catalog.

Args:

name: Catalog name
comment: (Optional) Catalog description

Returns: Created catalog details.

{
  "type": "object",
  "required": [
    "name"
  ],
  "properties": {
    "name": {
      "type": "string",
      "description": "Catalog name"
    },
    "comment": {
      "type": "string",
      "description": "Catalog description"
    }
  }
}

databricks_delete_catalog

Delete a catalog.

Args:

name: Catalog name
force: (Optional) Force delete even if not empty (default: false)

Returns: Confirmation of deletion.

{
  "type": "object",
  "required": [
    "name"
  ],
  "properties": {
    "name": {
      "type": "string",
      "description": "Catalog name"
    },
    "force": {
      "type": "boolean",
      "description": "Force delete"
    }
  }
}

databricks_get_schema

Get details of a specific schema.

Args:

fullName: Full schema name (catalog.schema)

Returns: Schema metadata.

{
  "type": "object",
  "required": [
    "fullName"
  ],
  "properties": {
    "fullName": {
      "type": "string",
      "description": "Full schema name (catalog.schema)"
    }
  }
}

databricks_create_schema

Create a new schema in a catalog.

Args:

catalogName: Catalog name
name: Schema name
comment: (Optional) Schema description

Returns: Created schema details.

{
  "type": "object",
  "required": [
    "catalogName",
    "name"
  ],
  "properties": {
    "name": {
      "type": "string",
      "description": "Schema name"
    },
    "comment": {
      "type": "string",
      "description": "Schema description"
    },
    "catalogName": {
      "type": "string",
      "description": "Catalog name"
    }
  }
}

databricks_delete_schema

Delete a schema.

Args:

fullName: Full schema name (catalog.schema)

Returns: Confirmation of deletion.

{
  "type": "object",
  "required": [
    "fullName"
  ],
  "properties": {
    "fullName": {
      "type": "string",
      "description": "Full schema name (catalog.schema)"
    }
  }
}

databricks_list_tables

List all tables in a schema.

Args:

catalogName: Catalog name
schemaName: Schema name

Returns: List of tables.

{
  "type": "object",
  "required": [
    "catalogName",
    "schemaName"
  ],
  "properties": {
    "schemaName": {
      "type": "string",
      "description": "Schema name"
    },
    "catalogName": {
      "type": "string",
      "description": "Catalog name"
    }
  }
}

databricks_get_table

Get details of a specific table.

Args:

fullName: Full table name (catalog.schema.table)

Returns: Table metadata including columns.

{
  "type": "object",
  "required": [
    "fullName"
  ],
  "properties": {
    "fullName": {
      "type": "string",
      "description": "Full table name (catalog.schema.table)"
    }
  }
}

databricks_delete_table

Delete a table.

Args:

fullName: Full table name (catalog.schema.table)

Returns: Confirmation of deletion.

{
  "type": "object",
  "required": [
    "fullName"
  ],
  "properties": {
    "fullName": {
      "type": "string",
      "description": "Full table name (catalog.schema.table)"
    }
  }
}

databricks_list_volumes

List all volumes in a schema.

Args:

catalogName: Catalog name
schemaName: Schema name

Returns: List of volumes.

{
  "type": "object",
  "required": [
    "catalogName",
    "schemaName"
  ],
  "properties": {
    "schemaName": {
      "type": "string",
      "description": "Schema name"
    },
    "catalogName": {
      "type": "string",
      "description": "Catalog name"
    }
  }
}

databricks_get_volume

Get details of a specific volume.

Args:

fullName: Full volume name (catalog.schema.volume)

Returns: Volume metadata.

{
  "type": "object",
  "required": [
    "fullName"
  ],
  "properties": {
    "fullName": {
      "type": "string",
      "description": "Full volume name (catalog.schema.volume)"
    }
  }
}

databricks_create_volume

Create a new volume.

Args:

catalogName: Catalog name
schemaName: Schema name
name: Volume name
volumeType: Volume type (MANAGED or EXTERNAL)
storageLocation: (Optional) Storage location for external volumes
comment: (Optional) Volume description

Returns: Created volume details.

{
  "type": "object",
  "required": [
    "catalogName",
    "schemaName",
    "name",
    "volumeType"
  ],
  "properties": {
    "name": {
      "type": "string",
      "description": "Volume name"
    },
    "comment": {
      "type": "string",
      "description": "Volume description"
    },
    "schemaName": {
      "type": "string",
      "description": "Schema name"
    },
    "volumeType": {
      "enum": [
        "MANAGED",
        "EXTERNAL"
      ],
      "type": "string",
      "description": "Volume type"
    },
    "catalogName": {
      "type": "string",
      "description": "Catalog name"
    },
    "storageLocation": {
      "type": "string",
      "description": "Storage location"
    }
  }
}

databricks_delete_volume

Delete a volume.

Args:

fullName: Full volume name (catalog.schema.volume)

Returns: Confirmation of deletion.

{
  "type": "object",
  "required": [
    "fullName"
  ],
  "properties": {
    "fullName": {
      "type": "string",
      "description": "Full volume name (catalog.schema.volume)"
    }
  }
}

databricks_list_functions

List all functions in a schema.

Args:

catalogName: Catalog name
schemaName: Schema name

Returns: List of functions.

{
  "type": "object",
  "required": [
    "catalogName",
    "schemaName"
  ],
  "properties": {
    "schemaName": {
      "type": "string",
      "description": "Schema name"
    },
    "catalogName": {
      "type": "string",
      "description": "Catalog name"
    }
  }
}

databricks_list_workspace

List contents of a workspace directory.

Args:

path: Workspace path (e.g., "/Users/user@example.com")

Returns: List of workspace objects (notebooks, folders, etc.).

{
  "type": "object",
  "required": [
    "path"
  ],
  "properties": {
    "path": {
      "type": "string",
      "description": "Workspace path"
    }
  }
}

databricks_get_workspace_status

Get status/metadata of a workspace object.

Args:

path: Workspace path to the object

Returns: Object metadata including type, language, and timestamps.

{
  "type": "object",
  "required": [
    "path"
  ],
  "properties": {
    "path": {
      "type": "string",
      "description": "Workspace path"
    }
  }
}

databricks_mkdirs

Create a directory in the workspace.

Creates parent directories as needed.

Args:

path: Directory path to create

Returns: Confirmation of creation.

{
  "type": "object",
  "required": [
    "path"
  ],
  "properties": {
    "path": {
      "type": "string",
      "description": "Directory path"
    }
  }
}

databricks_delete_workspace

Delete a workspace object (notebook, folder, etc.).

Args:

path: Path to delete
recursive: (Optional) Delete recursively if folder (default: false)

Returns: Confirmation of deletion.

{
  "type": "object",
  "required": [
    "path"
  ],
  "properties": {
    "path": {
      "type": "string",
      "description": "Path to delete"
    },
    "recursive": {
      "type": "boolean",
      "description": "Delete recursively"
    }
  }
}

databricks_import_notebook

Import a notebook into the workspace.

Args:

path: Destination path for the notebook
content: Base64-encoded content
format: Import format (SOURCE, HTML, JUPYTER, DBC, R_MARKDOWN)
language: (Optional) Notebook language (PYTHON, SCALA, SQL, R) - required for SOURCE format
overwrite: (Optional) Overwrite existing file (default: false)

Returns: Confirmation of import.

{
  "type": "object",
  "required": [
    "path",
    "content",
    "format"
  ],
  "properties": {
    "path": {
      "type": "string",
      "description": "Destination path"
    },
    "format": {
      "enum": [
        "SOURCE",
        "HTML",
        "JUPYTER",
        "DBC",
        "R_MARKDOWN"
      ],
      "type": "string",
      "description": "Import format"
    },
    "content": {
      "type": "string",
      "description": "Base64-encoded content"
    },
    "language": {
      "enum": [
        "PYTHON",
        "SCALA",
        "SQL",
        "R"
      ],
      "type": "string",
      "description": "Notebook language"
    },
    "overwrite": {
      "type": "boolean",
      "description": "Overwrite existing"
    }
  }
}

databricks_export_notebook

Export a notebook from the workspace.

Args:

path: Path to the notebook
format: (Optional) Export format (SOURCE, HTML, JUPYTER, DBC, R_MARKDOWN) - default: SOURCE

Returns: Base64-encoded notebook content.

{
  "type": "object",
  "required": [
    "path"
  ],
  "properties": {
    "path": {
      "type": "string",
      "description": "Notebook path"
    },
    "format": {
      "enum": [
        "SOURCE",
        "HTML",
        "JUPYTER",
        "DBC",
        "R_MARKDOWN"
      ],
      "type": "string",
      "description": "Export format"
    }
  }
}