# The McpService object

A Unity Catalog securable that registers an MCP server through a Unity
 Catalog connection and exposes its tools for discovery, authorization, and
 invocation.

## Attributes

- `name` (string, ID, Immutable)
  Resource name of the MCP service.
   Format: `mcp-services/{catalog}.{schema}.{mcp_service}`.
   Each `{...}` component is capped at 255 characters individually.
    The server derives the name on Create from
   `parent` and `mcp_service_id`; it is required and immutable on Update,
   Get, and Delete.
- `effective_owner` (string, Output only)
  Username, group name, or service principal application ID of the MCP service owner.
- `metastore_id` (string, Output only)
  Unique identifier of the metastore that contains the MCP service.
- `create_time` (string, Output only)
  Time the MCP service was created.
- `created_by` (string, Output only)
  Username or service principal application ID of the principal that created the MCP service.
- `update_time` (string, Output only)
  Time the MCP service was last modified.
- `updated_by` (string, Output only)
  Username or service principal application ID of the principal that last updated the MCP
   service.
- `comment` (string)
  User-provided description.
  Constraints: `<= 65536 characters`
- `config` (object)
  Connection, tool selectors, and rate limits. Required on Create. On Update,
   provide this field when `update_mask` contains `config` or one of its
   subpaths.
  - `source_connection` (object)
    Unity Catalog connection referencing the MCP server. Required on Create.
    - `name` (string)
      Resource name of the Unity Catalog connection used to access the MCP
       server, in the form `connections/{catalog}.{schema}.{connection}`.
    - `is_deleted` (boolean, Output only)
      Whether the referenced connection has been deleted. The MCP service keeps
       the reference so callers can identify the broken dependency; tool
       invocation fails until the source connection is updated.
    - `options` (object, Beta, Output only)
      Options needed to build the U2M authorize request, returned as a flat map. When set, it
       includes: `authorization_endpoint` (OAuth authorize URL), `token_endpoint` (token-exchange
       URL), `oauth_scope` (space-separated scopes to request), `client_id` (OAuth client id), and
       `oauth_provider` (the OAuth provider).
  - `include_tool_selectors` (array of string)
    Tool names or prefix patterns to expose from the MCP server. Use exact
     tool names or prefix patterns such as `read_*`. An empty list exposes all
     tools. At most 1,024 selectors are allowed, and each selector can contain
     at most 256 characters.
  - `rate_limits` (array of object)
    Rate limits for tool invocations. Supported scopes are user, group, service
     principal, the service as a whole, and each user by default. Request and
     token limits are supported. Empty when no rate limit is configured.
    - `key` (string)
      Scope of the rate limit. Depending on this value, the limit applies to a
       principal, the service as a whole, or each user by default.
      Possible values:
      - `RATE_LIMIT_KEY_USER`
      - `RATE_LIMIT_KEY_USER_GROUP`
      - `RATE_LIMIT_KEY_SERVICE_PRINCIPAL`
      - `RATE_LIMIT_KEY_SERVICE`
      - `RATE_LIMIT_KEY_USER_DEFAULT`
    - `renewal_period` (string)
      Interval after which the request and token counters reset.
      Possible values:
      - `RATE_LIMIT_RENEWAL_PERIOD_MINUTE`
      - `RATE_LIMIT_RENEWAL_PERIOD_HOUR`
    - `principal` (string)
      Principal this limit applies to: user email, group name, or service
       principal application ID. Required when `key` applies to a user, group, or
       service principal; otherwise it must be unset.
    - `requests` (int64)
      Maximum requests allowed in one renewal period. Leave unset for no request
       limit. Set to `0` to deny all requests.
    - `tokens` (int64)
      Maximum tokens allowed in one renewal period. Leave unset for no token
       limit. Set to `0` to deny all requests.
- `etag` (string, Output only)
  Optimistic concurrency token returned on every read. To make an Update or
   Delete conditional, pass the last-read value in that request's `etag`
   field. In REST responses, this value is a base64 string; URL-encode it when
   setting the `etag` query parameter.

## Example

### MCP service backed by a Unity Catalog connection

```json
{
  "name": "mcp-services/main.default.github",
  "effective_owner": "ava.alvarez@example.com",
  "metastore_id": "b2a1c3d4-5e6f-4a7b-8c9d-0e1f2a3b4c5d",
  "create_time": "2026-11-13T09:15:30Z",
  "created_by": "ava.alvarez@example.com",
  "update_time": "2026-11-13T09:15:30Z",
  "updated_by": "ava.alvarez@example.com",
  "comment": "GitHub MCP server for the engineering assistant",
  "config": {
    "source_connection": {
      "name": "connections/main.default.github_mcp",
      "is_deleted": false
    },
    "include_tool_selectors": [
      "get_*",
      "list_*",
      "search_*"
    ],
    "rate_limits": [
      {
        "key": "RATE_LIMIT_KEY_USER_DEFAULT",
        "renewal_period": "RATE_LIMIT_RENEWAL_PERIOD_MINUTE",
        "requests": 60
      },
      {
        "key": "RATE_LIMIT_KEY_SERVICE",
        "renewal_period": "RATE_LIMIT_RENEWAL_PERIOD_HOUR",
        "requests": 10000
      }
    ]
  },
  "etag": "MTc5NDU2MTMzMDAwMA=="
}
```


