Update CIMD config

Add MCP server to your AI tool

Allow AI tools and LLMs to interact with the API documentation portal through MCP.

MCP server URL


        
          
            https://openapi.logto.io/mcp

Standard setup for AI tools providing an mcp.json file

{
  "Logto API references MCP server": {
    "url": "https://openapi.logto.io/mcp"
  }
}

PATCH /api/configs/cimd

O auth2

Update the tenant-level OAuth Client ID Metadata Document (CIMD) configuration. Enabling requires the OIDC provider SSRF protection to be active.

application/json

Body Required

enabled boolean

Whether CIMD is enabled for the tenant.
addConsentPromptForOfflineAccess boolean

Experimental. When enabled, Logto adds consent to the prompt parameter of CIMD authorization requests that include the offline_access scope without it, so the client can receive a refresh token. Requests with prompt=none are not changed. Defaults to false.

Responses

200 application/json

The updated CIMD configuration.
Hide response attributes Show response attributes object
- enabled boolean Required
- addConsentPromptForOfflineAccess boolean
  
  Experimental. When enabled, Logto adds consent to the prompt parameter of CIMD authorization requests that include the offline_access scope without it, so the client can receive a refresh token. Requests with prompt=none are not changed. Defaults to false.
400

Bad Request
401

Unauthorized
403

Forbidden
422

The OIDC provider SSRF protection is disabled, so CIMD cannot be enabled.

PATCH /api/configs/cimd

curl \
 --request PATCH 'https://[tenant_id].logto.app/api/configs/cimd' \
 --header "Authorization: Bearer $ACCESS_TOKEN" \
 --header "Content-Type: application/json" \
 --data '{
  "enabled": true,
  "addConsentPromptForOfflineAccess": true
}'

Request examples

{
  "enabled": true,
  "addConsentPromptForOfflineAccess": true
}

Response examples (200)

{
  "enabled": true,
  "addConsentPromptForOfflineAccess": true
}