ai_gateway_mcp_services

Creates, updates, deletes, gets or lists an ai_gateway_mcp_services resource.

Overview

Name	ai_gateway_mcp_services
Type	Resource
Id	databricks_workspace.catalog.ai_gateway_mcp_services

Fields

The following fields are returned by SELECT queries:

list

Name	Datatype	Description
name	string	Resource name of the MCP service. Format: ``mcp-services/{catalog}.{schema}.{mcp_service}``. Each ``{...}`` component is capped at 255 characters individually. Server-derived on Create from ``parent`` + ``mcp_service_id``; required and immutable on Update/Get/Delete.
metastore_id	string	Metastore hosting the MCP service.
browse_only	boolean	Whether the caller sees only metadata available through the BROWSE privilege.
comment	string	User-provided description.
▶config	object	Operational configuration: connection, tool selectors, rate limit. Required on CreateMcpService; on UpdateMcpService it is required only when ``config`` (or a ``config.*`` subpath) appears in ``update_mask``.
create_time	string (date-time)	When the MCP service was created.
created_by	string	Creator identity.
effective_owner	string	The resolved owner of the MCP service. Falls back to the caller's identity when ``owner`` is not explicitly set on creation.
etag	string	Optimistic concurrency control token. Server-generated from the entity's state and returned on every read. To use it as an if-match precondition on a mutation, echo the last-read value back via the dedicated ``etag`` field on the Update / Delete request; the server rejects the mutation if the stored etag differs.
owner	string	The owner of the MCP service. Write-only; read owner via effective_owner.
update_time	string (date-time)	When the MCP service was last modified.
updated_by	string	Identity of the last updater.

Methods

The following methods are available for this resource:

Name	Accessible by	Required Params	Optional Params	Description
list	select	deployment_name	include_browse, page_size, page_token, parent, view	Lists the MCP services in a Unity Catalog schema. Provide parent as
create	insert	parent, mcp_service_id, deployment_name, mcp_service		Creates an MCP service in a Unity Catalog schema. An MCP (Model Context Protocol) service is a

Parameters

Parameters can be passed in the WHERE clause of a query. Check the Methods section to see which parameters are required or optional for each operation.

Name	Datatype	Description
deployment_name	string	The Databricks Workspace Deployment Name (default: dbc-abcd0123-a1bc)
mcp_service_id	string	Leaf identifier for the MCP service (the unqualified name within the parent schema, e.g. "my_mcp_service").
parent	string	Resource name of the parent schema. Format: schemas/{catalog}.{schema}. Each {...} component is capped at 255 characters individually.
include_browse	boolean	Whether to include MCP services for which the principal can only access selective metadata.
page_size	integer	Maximum number of MCP services to return. Defaults to 100 when unset or 0; the maximum is 1000. Use next_page_token to retrieve additional pages.
page_token	string	Opaque pagination token from a previous request.
parent	string	Resource name of the parent schema to list within, as schemas/{catalog}.{schema}. Each {...} component is capped at 255 characters individually.
view	string	View selector controlling which fields are populated per row.

SELECT examples

list

Lists the MCP services in a Unity Catalog schema. Provide parent as

SELECT
name,
metastore_id,
browse_only,
comment,
config,
create_time,
created_by,
effective_owner,
etag,
owner,
update_time,
updated_by
FROM databricks_workspace.catalog.ai_gateway_mcp_services
WHERE deployment_name = '{{ deployment_name }}' -- required
AND include_browse = '{{ include_browse }}'
AND page_size = '{{ page_size }}'
AND page_token = '{{ page_token }}'
AND parent = '{{ parent }}'
AND view = '{{ view }}'
;

INSERT examples

create

Creates an MCP service in a Unity Catalog schema. An MCP (Model Context Protocol) service is a

INSERT INTO databricks_workspace.catalog.ai_gateway_mcp_services (
mcp_service,
parent,
mcp_service_id,
deployment_name
)
SELECT 
'{{ mcp_service }}' /* required */,
'{{ parent }}',
'{{ mcp_service_id }}',
'{{ deployment_name }}'
RETURNING
name,
metastore_id,
browse_only,
comment,
config,
create_time,
created_by,
effective_owner,
etag,
owner,
update_time,
updated_by
;

Manifest

# Description fields are for documentation purposes
- name: ai_gateway_mcp_services
props:
  - name: parent
    value: "{{ parent }}"
    description: Required parameter for the ai_gateway_mcp_services resource.
  - name: mcp_service_id
    value: "{{ mcp_service_id }}"
    description: Required parameter for the ai_gateway_mcp_services resource.
  - name: deployment_name
    value: "{{ deployment_name }}"
    description: Required parameter for the ai_gateway_mcp_services resource.
  - name: mcp_service
    description: |
      The MCP service to create. The server populates ``name`` from ``parent`` + ``mcp_service_id``; clients should leave it unset.
    value:
      browse_only: {{ browse_only }}
      comment: "{{ comment }}"
      config:
        include_tool_selectors:
          - "{{ include_tool_selectors }}"
        rate_limits:
          - key: "{{ key }}"
            renewal_period: "{{ renewal_period }}"
            principal: "{{ principal }}"
            request_tag_key: "{{ request_tag_key }}"
            request_tag_value: "{{ request_tag_value }}"
            requests: {{ requests }}
            tokens: {{ tokens }}
        source_connection:
          name: "{{ name }}"
          is_deleted: {{ is_deleted }}
      create_time: "{{ create_time }}"
      created_by: "{{ created_by }}"
      effective_owner: "{{ effective_owner }}"
      etag: "{{ etag }}"
      metastore_id: "{{ metastore_id }}"
      name: "{{ name }}"
      owner: "{{ owner }}"
      update_time: "{{ update_time }}"
      updated_by: "{{ updated_by }}"