Update MCP Server | API Reference | Descope Documentation

Authorization

Descope Project ID and Management Key

AuthorizationBearer <token>

Project ID:Management Key as bearer token.

In: header

Request Body

application/json

server?object

Keep this message synchronized with the matching one in ProjectService

Update an MCP Server, using a valid management key.

curl -X POST "https://api.descope.com/v1/mgmt/mcp/server/update" \
  -H "Content-Type: application/json" \
  -d '{}'

curl -X POST "https://api.descope.com/v1/mgmt/mcp/server/update" \  -H "Content-Type: application/json" \  -d '{}'

ResponseOK

{
  "server": {
    "id": "string",
    "name": "string",
    "description": "string",
    "dynamicRegistration": {
      "enabled": true,
      "disableApprovedScopesAsDefault": true,
      "flowId": "string"
    },
    "audienceWhitelist": [
      "string"
    ],
    "approvedScopes": {
      "permissionsScopes": [
        {
          "name": "string",
          "description": "string",
          "optional": true,
          "values": [
            "string"
          ]
        }
      ],
      "attributesScopes": [
        {
          "name": "string",
          "description": "string",
          "optional": true,
          "values": [
            "string"
          ]
        }
      ],
      "connectionsScopes": [
        {
          "name": "string",
          "description": "string",
          "optional": true,
          "values": [
            "string"
          ]
        }
      ]
    },
    "approvedCallbackUrls": [
      "string"
    ],
    "loginPageURL": "string",
    "sessionSettings": {
      "enabled": true,
      "refreshTokenExpiration": 0,
      "refreshTokenExpirationUnit": "string",
      "sessionTokenExpiration": 0,
      "sessionTokenExpirationUnit": "string",
      "userTemplateId": "string",
      "keyTemplateId": "string",
      "keySessionTokenExpiration": 0,
      "keySessionTokenExpirationUnit": "string"
    },
    "tags": [
      "string"
    ],
    "logo": "string",
    "cimdSettings": {
      "enabled": true,
      "domainPolicies": {
        "policies": [
          {
            "domainPattern": "string",
            "enabled": true
          }
        ]
      }
    },
    "skipConsentScreen": true,
    "forceAddAllAuthorizationInfo": true
  }
}

{  "server": {    "id": "string",    "name": "string",    "description": "string",    "dynamicRegistration": {      "enabled": true,      "disableApprovedScopesAsDefault": true,      "flowId": "string"    },    "audienceWhitelist": [      "string"    ],    "approvedScopes": {      "permissionsScopes": [        {          "name": "string",          "description": "string",          "optional": true,          "values": [            "string"          ]        }      ],      "attributesScopes": [        {          "name": "string",          "description": "string",          "optional": true,          "values": [            "string"          ]        }      ],      "connectionsScopes": [        {          "name": "string",          "description": "string",          "optional": true,          "values": [            "string"          ]        }      ]    },    "approvedCallbackUrls": [      "string"    ],    "loginPageURL": "string",    "sessionSettings": {      "enabled": true,      "refreshTokenExpiration": 0,      "refreshTokenExpirationUnit": "string",      "sessionTokenExpiration": 0,      "sessionTokenExpirationUnit": "string",      "userTemplateId": "string",      "keyTemplateId": "string",      "keySessionTokenExpiration": 0,      "keySessionTokenExpirationUnit": "string"    },    "tags": [      "string"    ],    "logo": "string",    "cimdSettings": {      "enabled": true,      "domainPolicies": {        "policies": [          {            "domainPattern": "string",            "enabled": true          }        ]      }    },    "skipConsentScreen": true,    "forceAddAllAuthorizationInfo": true  }}

TypeScript

export interface Response {
/**
 * Keep this message synchronized with the matching one in ProjectService
 */
server?: {
id?: string
name?: string
description?: string
dynamicRegistration?: McpServerDynamicClientRegistration
audienceWhitelist?: string[]
approvedScopes?: {
permissionsScopes?: {
name?: string
description?: string
optional?: boolean
values?: string[]
}[]
attributesScopes?: {
name?: string
description?: string
optional?: boolean
values?: string[]
}[]
connectionsScopes?: Projectv1[]
}
approvedCallbackUrls?: string[]
loginPageURL?: string
sessionSettings?: {
enabled?: boolean
refreshTokenExpiration?: number
refreshTokenExpirationUnit?: string
sessionTokenExpiration?: number
sessionTokenExpirationUnit?: string
userTemplateId?: string
keyTemplateId?: string
keySessionTokenExpiration?: number
keySessionTokenExpirationUnit?: string
}
tags?: string[]
logo?: string
cimdSettings?: CIMDSettings
skipConsentScreen?: boolean
forceAddAllAuthorizationInfo?: boolean
}
}
/**
 * Keep this message synchronized with the matching one in ProjectService
 */
export interface McpServerDynamicClientRegistration {
enabled?: boolean
disableApprovedScopesAsDefault?: boolean
flowId?: string
}
/**
 * Keep this message synchronized with the matching one in ManagementService
 */
export interface Projectv1 {
name?: string
description?: string
optional?: boolean
values?: string[]
}
export interface CIMDSettings {
enabled?: boolean
domainPolicies?: CIMDDomainPolicies
}
export interface CIMDDomainPolicies {
policies?: CIMDDomainPolicy[]
}
export interface CIMDDomainPolicy {
domainPattern?: string
enabled?: boolean
}

export interface Response {/** * Keep this message synchronized with the matching one in ProjectService */server?: {id?: stringname?: stringdescription?: stringdynamicRegistration?: McpServerDynamicClientRegistrationaudienceWhitelist?: string[]approvedScopes?: {permissionsScopes?: {name?: stringdescription?: stringoptional?: booleanvalues?: string[]}[]attributesScopes?: {name?: stringdescription?: stringoptional?: booleanvalues?: string[]}[]connectionsScopes?: Projectv1[]}approvedCallbackUrls?: string[]loginPageURL?: stringsessionSettings?: {enabled?: booleanrefreshTokenExpiration?: numberrefreshTokenExpirationUnit?: stringsessionTokenExpiration?: numbersessionTokenExpirationUnit?: stringuserTemplateId?: stringkeyTemplateId?: stringkeySessionTokenExpiration?: numberkeySessionTokenExpirationUnit?: string}tags?: string[]logo?: stringcimdSettings?: CIMDSettingsskipConsentScreen?: booleanforceAddAllAuthorizationInfo?: boolean}}/** * Keep this message synchronized with the matching one in ProjectService */export interface McpServerDynamicClientRegistration {enabled?: booleandisableApprovedScopesAsDefault?: booleanflowId?: string}/** * Keep this message synchronized with the matching one in ManagementService */export interface Projectv1 {name?: stringdescription?: stringoptional?: booleanvalues?: string[]}export interface CIMDSettings {enabled?: booleandomainPolicies?: CIMDDomainPolicies}export interface CIMDDomainPolicies {policies?: CIMDDomainPolicy[]}export interface CIMDDomainPolicy {domainPattern?: stringenabled?: boolean}

Was this helpful?

Ask AI about this page