# Get MCP service user credential status

Launch stage: Beta

`GET /api/2.1/unity-catalog/{name=mcp-services/*}/user-credentials`

Returns the caller's per-user OAuth login state for an MCP service. Read
 `provisioning_info.state`: `ACTIVE` means the caller is logged in and the credential is
 usable; any other state (for example a failed or still-provisioning login) means the login has
 not completed and the caller should log in again. If the caller has no credential yet, the RPC
 returns `NOT_FOUND`.

 You must be the owner of the MCP service or have `EXECUTE` on it, plus `USE_CATALOG` on the
 parent catalog and `USE_SCHEMA` on the parent schema.

API scopes: unity-catalog

## Path parameters

- `name` (string, required)
  Resource name of the MCP service.
   Format: `mcp-services/{catalog}.{schema}.{mcp_service}`.

## Returns

- `options` (object, optional, Output only)
  Token-expiry info for the credential, returned as a flat map: `access_token_expiration` (always
   set) and `refresh_token_expiration` (set when the credential has a refresh token). Both values
   are timestamps.
- `provisioning_info` (object, optional, Output only)
  Provisioning state of the credential. `ACTIVE` means the caller is logged in and the credential
   is usable; any other state means the login has not completed.
  - `state` (string, optional)
    The provisioning state of the resource.
    Possible values:
    - `STATE_UNSPECIFIED`
    - `PROVISIONING`
    - `ACTIVE`
    - `FAILED`
    - `DELETING`
    - `UPDATING`
    - `DEGRADED`

## Response

```json
{
  "options": {},
  "provisioning_info": {
    "state": "PROVISIONING"
  }
}
```