{"token_count": 942}

# MCP OAuth Client Secret Reference

**Kind**: `mcp_oauth_client_secret`<br />**Version**: `v1`

The MCP OAuth client secret resource holds the client secret of an OAuth client that you pre-registered with an MCP server's OAuth provider, along with the token URL and the MCP server it can be used for.

`tctl get` leaves out `spec.client_secret` unless you pass `--with-secrets`, which requires the `read` verb on `mcp_oauth_client_secret`.

The resource never expires, so `metadata.expires` must not be set.

Example definition:

```
kind: mcp_oauth_client_secret
version: v1
metadata:
  name: example-client-secret
spec:
  # client_id is the OAuth client the secret belongs to.
  client_id: "example-client-id"
  # client_secret is the OAuth client secret.
  client_secret: "************************************"
  # token_url is the only URL the client secret is sent to.
  token_url: https://auth.example.com/oauth/token
  # mcp_server_uri is the uri of the MCP server app the secret can be used for.
  mcp_server_uri: mcp+https://mcp.example.com/mcp


```

## Top-level fields

Example:

```
kind: "string"
sub_kind: "string"
version: "string"
metadata: # [...]
spec: # [...]
scope: "string"

```

| Field Name | Description                                                                                                        | Type                                                          |
| ---------- | ------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------- |
| kind       | The resource kind. Must be "mcp\_oauth\_client\_secret".                                                           | string                                                        |
| metadata   | The resource metadata.                                                                                             | [Metadata](#metadata)                                         |
| scope      | The scope of the secret. If unset, the secret is unscoped. The scope of a secret cannot be changed after creation. | string                                                        |
| spec       | Holds the client secret and where it can be used.                                                                  | [MCP OAuth Client Secret Spec](#mcp-oauth-client-secret-spec) |
| sub\_kind  | An optional resource sub kind. Must be empty.                                                                      | string                                                        |
| version    | The resource version. Must be "v1".                                                                                | string                                                        |

## MCP OAuth Client Secret Spec

Holds the client secret and where it can be used.

Example:

```
client_id: "string"
client_secret: "string"
token_url: "string"
mcp_server_uri: "string"

```

| Field Name       | Description                                                                                                 | Type   |
| ---------------- | ----------------------------------------------------------------------------------------------------------- | ------ |
| client\_id       | The OAuth client the secret belongs to. It must match the client\_id of any app that references the secret. | string |
| client\_secret   | The OAuth client secret.                                                                                    | string |
| mcp\_server\_uri | The app uri the secret may be used for.                                                                     | string |
| token\_url       | The only URL Auth sends the client secret to.                                                               | string |

## Metadata

Resource metadata.

Example:

```
name: "string"
namespace: "string"
description: "string"
labels: 
  "string": "string"
  "string": "string"
  "string": "string"
expires: # See description
revision: "string"

```

| Field Name  | Description                                                                                                                                                                                  | Type               |
| ----------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------ |
| description | Description is object description.                                                                                                                                                           | string             |
| expires     | Expires is a global expiry time header can be set on any resource in the system.                                                                                                             |                    |
| labels      | Labels is a set of labels.                                                                                                                                                                   | map\[string]string |
| name        | Name is an object name.                                                                                                                                                                      | string             |
| namespace   | Namespace is object namespace. The field should be called "namespace" when it returns in Teleport 2.4.                                                                                       | string             |
| revision    | Revision is an opaque identifier which tracks the versions of a resource over time. Clients should ignore and not alter its value but must return the revision in any updates of a resource. | string             |
