Skip to main content

MCP OAuth Client Secret Reference

Report an Issue

Kind: mcp_oauth_client_secret
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 NameDescriptionType
kindThe resource kind. Must be "mcp_oauth_client_secret".string
metadataThe resource metadata.Metadata
scopeThe scope of the secret. If unset, the secret is unscoped. The scope of a secret cannot be changed after creation.string
specHolds the client secret and where it can be used.MCP OAuth Client Secret Spec
sub_kindAn optional resource sub kind. Must be empty.string
versionThe 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 NameDescriptionType
client_idThe OAuth client the secret belongs to. It must match the client_id of any app that references the secret.string
client_secretThe OAuth client secret.string
mcp_server_uriThe app uri the secret may be used for.string
token_urlThe 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 NameDescriptionType
descriptionDescription is object description.string
expiresExpires is a global expiry time header can be set on any resource in the system.
labelsLabels is a set of labels.map[string]string
nameName is an object name.string
namespaceNamespace is object namespace. The field should be called "namespace" when it returns in Teleport 2.4.string
revisionRevision 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