Discovery
Discover the authorization server
Return authorization-server endpoint URLs, grants, S256 PKCE, client authentication methods, supported scopes and optional agent-registration metadata.
/.well-known/oauth-authorization-server- Authentication
- No access token required
- Required scopes
- See authentication requirements
- Idempotency key
- Not required
How to use this endpoint
Read current values: enabling public MCP clients adds the none authentication method and permits their direct authorization flow; confidential external API clients still require pushed authorization.
curl --request GET '<origin from OAuth metadata>/.well-known/oauth-authorization-server'Use the exact endpoint URL from your environment's metadata. Confidential client examples use client_secret_basic; public MCP clients use client_id without a secret.
Request fields
0 fieldsNo request fields are required.
curl --request GET '<origin from OAuth metadata>/.well-known/oauth-authorization-server'Use the exact endpoint URL from your environment's metadata. Confidential client examples use client_secret_basic; public MCP clients use client_id without a secret.
Successful outcomes: ok.
{
"issuer": "https://<issuer>",
"authorization_endpoint": "https://<issuer>/oauth/authorize",
"pushed_authorization_request_endpoint": "https://<issuer>/oauth/par",
"token_endpoint": "https://<issuer>/oauth/token",
"revocation_endpoint": "https://<issuer>/oauth/revoke",
"jwks_uri": "https://<issuer>/oauth/jwks.json",
"response_types_supported": [
"code"
],
"grant_types_supported": [
"authorization_code",
"refresh_token",
"client_credentials"
],
"code_challenge_methods_supported": [
"S256"
],
"token_endpoint_auth_methods_supported": [
"client_secret_basic",
"private_key_jwt"
],
"require_pushed_authorization_requests": true
}Confidential external API configuration; optional MCP metadata varies with availability.
Errors to handle
Use the returned status and code to decide what to correct or retry.
- 503
temporarily_unavailable