# Create

Launch stage: Beta

`POST /api/2.1/unity-catalog/mcp-services`

Creates an MCP service in a Unity Catalog schema. An MCP (Model Context
 Protocol) service is a governed securable that registers an MCP server and
 exposes its tools for discovery, access control, and invocation. The
 caller supplies the leaf name in `mcp_service_id`.

 You must be the owner of the parent schema or have the `CREATE_SERVICE`
 and `USE_SCHEMA` privileges on the parent schema and `USE_CATALOG` on the
 parent catalog. You also need `USE_CONNECTION` on the connection the MCP
 service references.

API scopes: unity-catalog

## Query parameters

- `parent` (string, optional)
  Name of the parent schema.
   Format: `schemas/{catalog}.{schema}`.
   Each `{...}` component is capped at 255 characters individually.
- `mcp_service_id` (string, optional)
  Name for the MCP service, e.g. "my_mcp_service".

## Request body

- `mcp_service` (object, optional)
  The MCP service to create. The server populates `name` from `parent` +
   `mcp_service_id`; clients should leave it unset.
  - `name` (string, optional)
    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.
  - `owner` (string, optional)
    The owner of the MCP service. Write-only; read owner via effective_owner.
  - `effective_owner` (string, optional)
    The resolved owner of the MCP service. Falls back to the caller's identity
     when `owner` is not explicitly set on creation.
  - `metastore_id` (string, optional)
    Metastore hosting the MCP service.
  - `create_time` (string, optional)
    When the MCP service was created.
  - `created_by` (string, optional)
    Creator identity.
  - `update_time` (string, optional)
    When the MCP service was last modified.
  - `updated_by` (string, optional)
    Identity of the last updater.
  - `comment` (string, optional)
    User-provided description.
    Constraints: `<= 65536 characters`
  - `config` (object, optional)
    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`.
    - `source_connection` (object, required)
      UC Connection referencing the MCP server.
      - `name` (string, optional)
        Name of the UC connection that hosts the MCP server, as
         `connections/{catalog}.{schema}.{connection}`.
      - `is_deleted` (boolean, optional)
    - `include_tool_selectors` (array of string, optional)
      Glob or exact-match patterns selecting which tools from the MCP server
       to expose. Prefix match for patterns with `*`, exact match otherwise.
       An empty list means all tools are included. Per-element max 256 chars.
    - `rate_limits` (array of object, optional)
      Per-principal rate limits applied to tool invocations routed through this
       MCP service. Repeated to support per-USER / USER_GROUP / SERVICE_PRINCIPAL
       / SERVICE / USER_DEFAULT scopes simultaneously, mirroring the
       `ModelServiceConfig.rate_limits` shape. Empty when no rate limit is
       configured.
      - `key` (string, optional)
        Scope key. Determines whether `principal` is required.
        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`, `RATE_LIMIT_KEY_REQUEST_TAG`
      - `renewal_period` (string, optional)
        Renewal period.
        Possible values: `RATE_LIMIT_RENEWAL_PERIOD_MINUTE`, `RATE_LIMIT_RENEWAL_PERIOD_HOUR`
      - `principal` (string, optional)
        Principal this limit applies to: user email, group name, or service
         principal application ID. Required unless `key` is
         `RATE_LIMIT_KEY_SERVICE`, `RATE_LIMIT_KEY_USER_DEFAULT`, or
         `RATE_LIMIT_KEY_REQUEST_TAG` (which must not set a principal).
      - `requests` (int64, optional)
        Max requests allowed within a renewal period. Leave unset for no request limit.
      - `tokens` (int64, optional)
        Max tokens allowed within a renewal period. Leave unset for no token limit.
      - `request_tag_key` (string, optional)
        Request tag key this limit applies to. Required when `key` is
         `RATE_LIMIT_KEY_REQUEST_TAG`, forbidden otherwise.
      - `request_tag_value` (string, optional)
        Request tag value this limit applies to. Only valid when `key` is
         `RATE_LIMIT_KEY_REQUEST_TAG`. Leave unset to apply the limit to every
         value of `request_tag_key` (an any-value default); a set value is a
         specific override for that value.
  - `etag` (string, optional)
    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.

## Returns

Returns the McpService object.

## Response

```json
{
  "name": "string",
  "owner": "string",
  "effective_owner": "string",
  "metastore_id": "string",
  "create_time": "string",
  "created_by": "string",
  "update_time": "string",
  "updated_by": "string",
  "comment": "string",
  "config": {
    "source_connection": {},
    "include_tool_selectors": [
      "string"
    ],
    "rate_limits": [
      {}
    ]
  },
  "etag": "string"
}
```