# List

Launch stage: Beta

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

Lists the MCP services in a Unity Catalog schema. Provide `parent` as
 `schemas/{catalog}.{schema}`. Results are paginated; pass the returned
 `next_page_token` to fetch subsequent pages.

 Requires `USE_CATALOG` on the parent catalog and `USE_SCHEMA` on the
 parent schema. Only MCP services the caller can access (as owner or
 through `EXECUTE`, `READ_METADATA`, or `MANAGE`) are returned.

API scopes: unity-catalog

## Query parameters

- `parent` (string, optional)
  Name of the parent schema to list within, as
   `schemas/{catalog}.{schema}`. Each `{...}` component is capped at 255
   characters individually.
- `page_size` (int32, optional)
  Maximum number of MCP services to return. Defaults to 100 when unset or 0;
   the maximum is 100. Use `page_token` to retrieve additional pages.
  Constraints: `<= 100`
- `page_token` (string, optional)
  Opaque pagination token from a previous request.
- `view` (string, optional)
  View selector controlling which fields are populated per row. `FULL`
   returns the full representation of the service; `BASIC` returns a more
   compact version. Defaults to `BASIC` when unset.
  Possible values: `VIEW_UNSPECIFIED`, `FULL`, `BASIC`

## Returns

Returns a list of McpService objects.

## Response

```json
{
  "mcp_services": [
    {
      "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": {},
      "etag": "string"
    }
  ],
  "next_page_token": "string"
}
```