@lumoauth/api-client 1.0.0 → 1.2.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (151) hide show
  1. package/.openapi-generator/FILES +16 -0
  2. package/.openapi-generator-ignore +1 -1
  3. package/README.md +12 -2
  4. package/api/aauth-api.ts +5 -5
  5. package/api/admin-mcp-api.ts +5 -5
  6. package/api/admin-oauth-clients-api.ts +118 -0
  7. package/api/agents-api.ts +5 -5
  8. package/api/authorization-api.ts +5 -26
  9. package/api/mcp-api.ts +130 -0
  10. package/api/well-known-api.ts +10 -10
  11. package/dist/api/aauth-api.d.ts +5 -5
  12. package/dist/api/aauth-api.js +4 -4
  13. package/dist/api/admin-mcp-api.d.ts +5 -5
  14. package/dist/api/admin-mcp-api.js +4 -4
  15. package/dist/api/admin-oauth-clients-api.d.ts +65 -0
  16. package/dist/api/admin-oauth-clients-api.js +77 -0
  17. package/dist/api/agents-api.d.ts +5 -5
  18. package/dist/api/agents-api.js +4 -4
  19. package/dist/api/authorization-api.d.ts +5 -5
  20. package/dist/api/authorization-api.js +4 -18
  21. package/dist/api/mcp-api.d.ts +73 -0
  22. package/dist/api/mcp-api.js +82 -0
  23. package/dist/api/well-known-api.d.ts +10 -10
  24. package/dist/api/well-known-api.js +8 -8
  25. package/dist/esm/api/aauth-api.d.ts +5 -5
  26. package/dist/esm/api/aauth-api.js +4 -4
  27. package/dist/esm/api/admin-mcp-api.d.ts +5 -5
  28. package/dist/esm/api/admin-mcp-api.js +4 -4
  29. package/dist/esm/api/admin-oauth-clients-api.d.ts +65 -0
  30. package/dist/esm/api/admin-oauth-clients-api.js +78 -1
  31. package/dist/esm/api/agents-api.d.ts +5 -5
  32. package/dist/esm/api/agents-api.js +4 -4
  33. package/dist/esm/api/authorization-api.d.ts +5 -5
  34. package/dist/esm/api/authorization-api.js +4 -18
  35. package/dist/esm/api/mcp-api.d.ts +73 -0
  36. package/dist/esm/api/mcp-api.js +83 -1
  37. package/dist/esm/api/well-known-api.d.ts +10 -10
  38. package/dist/esm/api/well-known-api.js +8 -8
  39. package/dist/esm/models/admin-agents-generate-token-request.d.ts +7 -1
  40. package/dist/esm/models/admin-agents-generate-token-response-data.d.ts +12 -0
  41. package/dist/esm/models/admin-clients-cimd-check-request.d.ts +30 -0
  42. package/dist/esm/models/admin-clients-cimd-check-request.js +14 -0
  43. package/dist/esm/models/admin-clients-cimd-check-response.d.ts +25 -0
  44. package/dist/esm/models/admin-clients-cimd-check-response.js +14 -0
  45. package/dist/esm/models/attest-response.d.ts +2 -1
  46. package/dist/esm/models/attest-response.js +1 -0
  47. package/dist/esm/models/authentication-settings.d.ts +1 -1
  48. package/dist/esm/models/authorization-server-metadata.d.ts +1 -1
  49. package/dist/esm/models/authorize-mcp-request.d.ts +1 -1
  50. package/dist/esm/models/cimd-check-result-effective.d.ts +112 -0
  51. package/dist/esm/models/cimd-check-result-effective.js +31 -0
  52. package/dist/esm/models/cimd-check-result-shadow-client.d.ts +30 -0
  53. package/dist/esm/models/cimd-check-result-shadow-client.js +14 -0
  54. package/dist/esm/models/cimd-check-result.d.ts +76 -0
  55. package/dist/esm/models/cimd-check-result.js +14 -0
  56. package/dist/esm/models/get-protected-resource-metadata-root-response1-resources-item.d.ts +1 -1
  57. package/dist/esm/models/index.d.ts +8 -0
  58. package/dist/esm/models/index.js +8 -0
  59. package/dist/esm/models/mcp-server-tool-authorize-request-subject.d.ts +38 -0
  60. package/dist/esm/models/mcp-server-tool-authorize-request-subject.js +22 -0
  61. package/dist/esm/models/mcp-server-tool-authorize-request.d.ts +31 -0
  62. package/dist/esm/models/mcp-server-tool-authorize-request.js +14 -0
  63. package/dist/esm/models/mcp-server-tool-authorize-response.d.ts +36 -0
  64. package/dist/esm/models/mcp-server-tool-authorize-response.js +14 -0
  65. package/dist/esm/models/mcp-server.d.ts +18 -0
  66. package/dist/esm/models/open-id-configuration.d.ts +2 -2
  67. package/dist/esm/models/protected-resource-metadata.d.ts +1 -1
  68. package/dist/esm/models/push-enrollment-started.d.ts +7 -1
  69. package/dist/esm/models/single-server-metadata.d.ts +1 -1
  70. package/dist/models/admin-agents-generate-token-request.d.ts +7 -1
  71. package/dist/models/admin-agents-generate-token-response-data.d.ts +12 -0
  72. package/dist/models/admin-clients-cimd-check-request.d.ts +30 -0
  73. package/dist/models/admin-clients-cimd-check-request.js +15 -0
  74. package/dist/models/admin-clients-cimd-check-response.d.ts +25 -0
  75. package/dist/models/admin-clients-cimd-check-response.js +15 -0
  76. package/dist/models/attest-response.d.ts +2 -1
  77. package/dist/models/attest-response.js +1 -0
  78. package/dist/models/authentication-settings.d.ts +1 -1
  79. package/dist/models/authorization-server-metadata.d.ts +1 -1
  80. package/dist/models/authorize-mcp-request.d.ts +1 -1
  81. package/dist/models/cimd-check-result-effective.d.ts +112 -0
  82. package/dist/models/cimd-check-result-effective.js +34 -0
  83. package/dist/models/cimd-check-result-shadow-client.d.ts +30 -0
  84. package/dist/models/cimd-check-result-shadow-client.js +15 -0
  85. package/dist/models/cimd-check-result.d.ts +76 -0
  86. package/dist/models/cimd-check-result.js +15 -0
  87. package/dist/models/get-protected-resource-metadata-root-response1-resources-item.d.ts +1 -1
  88. package/dist/models/index.d.ts +8 -0
  89. package/dist/models/index.js +8 -0
  90. package/dist/models/mcp-server-tool-authorize-request-subject.d.ts +38 -0
  91. package/dist/models/mcp-server-tool-authorize-request-subject.js +25 -0
  92. package/dist/models/mcp-server-tool-authorize-request.d.ts +31 -0
  93. package/dist/models/mcp-server-tool-authorize-request.js +15 -0
  94. package/dist/models/mcp-server-tool-authorize-response.d.ts +36 -0
  95. package/dist/models/mcp-server-tool-authorize-response.js +15 -0
  96. package/dist/models/mcp-server.d.ts +18 -0
  97. package/dist/models/open-id-configuration.d.ts +2 -2
  98. package/dist/models/protected-resource-metadata.d.ts +1 -1
  99. package/dist/models/push-enrollment-started.d.ts +7 -1
  100. package/dist/models/single-server-metadata.d.ts +1 -1
  101. package/docs/AAuthApi.md +1 -1
  102. package/docs/AdminAgentsApi.md +1 -1
  103. package/docs/AdminAgentsGenerateTokenRequest.md +3 -1
  104. package/docs/AdminAgentsGenerateTokenResponseData.md +4 -0
  105. package/docs/AdminClientsCimdCheckRequest.md +22 -0
  106. package/docs/AdminClientsCimdCheckResponse.md +20 -0
  107. package/docs/AdminMcpApi.md +1 -1
  108. package/docs/AdminOAuthClientsApi.md +57 -0
  109. package/docs/AgentsApi.md +4 -3
  110. package/docs/AuthenticationSettings.md +1 -1
  111. package/docs/AuthorizationApi.md +8 -8
  112. package/docs/AuthorizationServerMetadata.md +1 -1
  113. package/docs/AuthorizeMcpRequest.md +1 -1
  114. package/docs/CimdCheckResult.md +37 -0
  115. package/docs/CimdCheckResultEffective.md +45 -0
  116. package/docs/CimdCheckResultShadowClient.md +23 -0
  117. package/docs/EnrollAuthenticator201Response.md +3 -1
  118. package/docs/GetProtectedResourceMetadataRoot200Response.md +1 -1
  119. package/docs/GetProtectedResourceMetadataRootResponse1ResourcesItem.md +1 -1
  120. package/docs/McpApi.md +64 -0
  121. package/docs/McpServer.md +6 -0
  122. package/docs/McpServerToolAuthorizeRequest.md +22 -0
  123. package/docs/McpServerToolAuthorizeRequestSubject.md +22 -0
  124. package/docs/McpServerToolAuthorizeResponse.md +24 -0
  125. package/docs/OpenIdConfiguration.md +2 -2
  126. package/docs/ProtectedResourceMetadata.md +1 -1
  127. package/docs/PushEnrollmentStarted.md +3 -1
  128. package/docs/SingleServerMetadata.md +1 -1
  129. package/docs/WellKnownApi.md +4 -4
  130. package/models/admin-agents-generate-token-request.ts +7 -1
  131. package/models/admin-agents-generate-token-response-data.ts +12 -0
  132. package/models/admin-clients-cimd-check-request.ts +36 -0
  133. package/models/admin-clients-cimd-check-response.ts +33 -0
  134. package/models/attest-response.ts +2 -1
  135. package/models/authentication-settings.ts +1 -1
  136. package/models/authorization-server-metadata.ts +1 -1
  137. package/models/authorize-mcp-request.ts +1 -1
  138. package/models/cimd-check-result-effective.ts +120 -0
  139. package/models/cimd-check-result-shadow-client.ts +36 -0
  140. package/models/cimd-check-result.ts +84 -0
  141. package/models/get-protected-resource-metadata-root-response1-resources-item.ts +1 -1
  142. package/models/index.ts +8 -0
  143. package/models/mcp-server-tool-authorize-request-subject.ts +46 -0
  144. package/models/mcp-server-tool-authorize-request.ts +39 -0
  145. package/models/mcp-server-tool-authorize-response.ts +42 -0
  146. package/models/mcp-server.ts +18 -0
  147. package/models/open-id-configuration.ts +2 -2
  148. package/models/protected-resource-metadata.ts +1 -1
  149. package/models/push-enrollment-started.ts +7 -1
  150. package/models/single-server-metadata.ts +1 -1
  151. package/package.json +1 -1
@@ -26,7 +26,7 @@ Name | Type | Description | Notes
26
26
  **session_timeout** | **number** | Seconds. | [optional] [default to undefined]
27
27
  **encrypt_client_secrets** | **boolean** | | [optional] [default to undefined]
28
28
  **dynamic_client_registration_enabled** | **boolean** | | [optional] [default to undefined]
29
- **cimd_enabled** | **boolean** | | [optional] [default to undefined]
29
+ **cimd_enabled** | **boolean** | Accept Client ID Metadata Documents (an https URL as client_id). On by default on every plan; set false to opt the organization out. | [optional] [default to true]
30
30
  **cimd_allowed_domains** | **Array<string>** | | [optional] [default to undefined]
31
31
  **cimd_localhost_redirect_policy** | **string** | | [optional] [default to undefined]
32
32
  **xaa_idp_enabled** | **boolean** | | [optional] [default to undefined]
@@ -59,7 +59,7 @@ const { status, data } = await apiInstance.checkAbac(
59
59
 
60
60
  ### Authorization
61
61
 
62
- [ApiKeyAuth](../README.md#ApiKeyAuth), [BearerAuth](../README.md#BearerAuth)
62
+ [BearerAuth](../README.md#BearerAuth)
63
63
 
64
64
  ### HTTP request headers
65
65
 
@@ -110,7 +110,7 @@ const { status, data } = await apiInstance.checkAbacBulk(
110
110
 
111
111
  ### Authorization
112
112
 
113
- [ApiKeyAuth](../README.md#ApiKeyAuth), [BearerAuth](../README.md#BearerAuth)
113
+ [BearerAuth](../README.md#BearerAuth)
114
114
 
115
115
  ### HTTP request headers
116
116
 
@@ -630,7 +630,7 @@ const { status, data } = await apiInstance.getMyAttributes(
630
630
 
631
631
  ### Authorization
632
632
 
633
- [ApiKeyAuth](../README.md#ApiKeyAuth), [BearerAuth](../README.md#BearerAuth)
633
+ [BearerAuth](../README.md#BearerAuth)
634
634
 
635
635
  ### HTTP request headers
636
636
 
@@ -687,7 +687,7 @@ const { status, data } = await apiInstance.getResourceAttributes(
687
687
 
688
688
  ### Authorization
689
689
 
690
- [ApiKeyAuth](../README.md#ApiKeyAuth), [BearerAuth](../README.md#BearerAuth)
690
+ [BearerAuth](../README.md#BearerAuth)
691
691
 
692
692
  ### HTTP request headers
693
693
 
@@ -741,7 +741,7 @@ const { status, data } = await apiInstance.listAttributeDefinitions(
741
741
 
742
742
  ### Authorization
743
743
 
744
- [ApiKeyAuth](../README.md#ApiKeyAuth), [BearerAuth](../README.md#BearerAuth)
744
+ [BearerAuth](../README.md#BearerAuth)
745
745
 
746
746
  ### HTTP request headers
747
747
 
@@ -759,7 +759,7 @@ const { status, data } = await apiInstance.listAttributeDefinitions(
759
759
  # **listPermissions**
760
760
  > ListPermissionsResponse listPermissions()
761
761
 
762
- GET /api/v1/authz/permissions
762
+ GET /api/v1/authz/permissions Inventory endpoint: a bearer access token needs the `authz:read` scope (the check endpoints stay open to any authenticated token).
763
763
 
764
764
  ### Example
765
765
 
@@ -845,7 +845,7 @@ const { status, data } = await apiInstance.setResourceAttribute(
845
845
 
846
846
  ### Authorization
847
847
 
848
- [ApiKeyAuth](../README.md#ApiKeyAuth), [BearerAuth](../README.md#BearerAuth)
848
+ [BearerAuth](../README.md#BearerAuth)
849
849
 
850
850
  ### HTTP request headers
851
851
 
@@ -902,7 +902,7 @@ const { status, data } = await apiInstance.setUserAttribute(
902
902
 
903
903
  ### Authorization
904
904
 
905
- [ApiKeyAuth](../README.md#ApiKeyAuth), [BearerAuth](../README.md#BearerAuth)
905
+ [BearerAuth](../README.md#BearerAuth)
906
906
 
907
907
  ### HTTP request headers
908
908
 
@@ -39,7 +39,7 @@ Name | Type | Description | Notes
39
39
  **backchannel_token_delivery_modes_supported** | **Array<string>** | | [optional] [default to undefined]
40
40
  **backchannel_user_code_parameter_supported** | **boolean** | | [optional] [default to undefined]
41
41
  **entity_profiles_supported** | **Array<string>** | | [optional] [default to undefined]
42
- **client_id_metadata_document_supported** | **boolean** | Only when CIMD is enabled for the organization. | [optional] [default to undefined]
42
+ **client_id_metadata_document_supported** | **boolean** | Present (true) unless the organization switched Client ID Metadata Documents off. | [optional] [default to undefined]
43
43
  **authorization_grant_profiles_supported** | **Array<string>** | Only when the organization accepts ID-JAGs. | [optional] [default to undefined]
44
44
  **op_policy_uri** | **string** | Only when configured. | [optional] [default to undefined]
45
45
  **op_tos_uri** | **string** | Only when configured. | [optional] [default to undefined]
@@ -5,7 +5,7 @@
5
5
 
6
6
  Name | Type | Description | Notes
7
7
  ------------ | ------------- | ------------- | -------------
8
- **server_id** | **string** | | [optional] [default to undefined]
8
+ **server_id** | **string** | Id of an active MCP server registered in this organization. | [optional] [default to undefined]
9
9
  **tool** | **string** | | [optional] [default to undefined]
10
10
 
11
11
  ## Example
@@ -0,0 +1,37 @@
1
+ # CimdCheckResult
2
+
3
+ Result of POST /admin/clients/cimd/check — how the authorization server sees a Client ID Metadata Document.
4
+
5
+ ## Properties
6
+
7
+ Name | Type | Description | Notes
8
+ ------------ | ------------- | ------------- | -------------
9
+ **ok** | **boolean** | true when the document is valid and would be accepted (subject to `enabled`). | [optional] [default to undefined]
10
+ **client_id** | **string** | | [optional] [default to undefined]
11
+ **enabled** | **boolean** | Whether CIMD is currently on for this organization (switch + plan). | [optional] [default to undefined]
12
+ **reason** | **string** | Stable failure code when ok is false (client_id_mismatch, invalid_redirect_uri, domain_not_allowed, http_status_404, …). | [optional] [default to undefined]
13
+ **message** | **string** | Developer-facing explanation of `reason`. | [optional] [default to undefined]
14
+ **warnings** | **Array<string>** | | [optional] [default to undefined]
15
+ **document** | **{ [key: string]: any; }** | The metadata document as fetched. | [optional] [default to undefined]
16
+ **effective** | [**CimdCheckResultEffective**](CimdCheckResultEffective.md) | | [optional] [default to undefined]
17
+ **shadow_client** | [**CimdCheckResultShadowClient**](CimdCheckResultShadowClient.md) | | [optional] [default to undefined]
18
+
19
+ ## Example
20
+
21
+ ```typescript
22
+ import { CimdCheckResult } from '@lumoauth/api-client';
23
+
24
+ const instance: CimdCheckResult = {
25
+ ok,
26
+ client_id,
27
+ enabled,
28
+ reason,
29
+ message,
30
+ warnings,
31
+ document,
32
+ effective,
33
+ shadow_client,
34
+ };
35
+ ```
36
+
37
+ [[Back to Model list]](../README.md#documentation-for-models) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to README]](../README.md)
@@ -0,0 +1,45 @@
1
+ # CimdCheckResultEffective
2
+
3
+ The client LumoAuth derives from the document after organization policy.
4
+
5
+ ## Properties
6
+
7
+ Name | Type | Description | Notes
8
+ ------------ | ------------- | ------------- | -------------
9
+ **client_name** | **string** | | [optional] [default to undefined]
10
+ **application_type** | **string** | | [optional] [default to undefined]
11
+ **token_endpoint_auth_method** | **string** | | [optional] [default to undefined]
12
+ **public_client** | **boolean** | | [optional] [default to undefined]
13
+ **pkce_required** | **boolean** | | [optional] [default to undefined]
14
+ **redirect_uris** | **Array<string>** | | [optional] [default to undefined]
15
+ **dropped_redirect_uris** | **Array<string>** | Loopback URIs removed by the organization\'s localhost policy. | [optional] [default to undefined]
16
+ **grant_types** | **Array<string>** | | [optional] [default to undefined]
17
+ **scopes** | **Array<string>** | | [optional] [default to undefined]
18
+ **dropped_scopes** | **Array<string>** | Scopes the document asked for that are neither identity scopes nor on the organization\'s cimd_allowed_scopes list. | [optional] [default to undefined]
19
+ **logo_uri** | **string** | | [optional] [default to undefined]
20
+ **client_uri** | **string** | | [optional] [default to undefined]
21
+ **has_loopback_redirect** | **boolean** | | [optional] [default to undefined]
22
+
23
+ ## Example
24
+
25
+ ```typescript
26
+ import { CimdCheckResultEffective } from '@lumoauth/api-client';
27
+
28
+ const instance: CimdCheckResultEffective = {
29
+ client_name,
30
+ application_type,
31
+ token_endpoint_auth_method,
32
+ public_client,
33
+ pkce_required,
34
+ redirect_uris,
35
+ dropped_redirect_uris,
36
+ grant_types,
37
+ scopes,
38
+ dropped_scopes,
39
+ logo_uri,
40
+ client_uri,
41
+ has_loopback_redirect,
42
+ };
43
+ ```
44
+
45
+ [[Back to Model list]](../README.md#documentation-for-models) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to README]](../README.md)
@@ -0,0 +1,23 @@
1
+ # CimdCheckResultShadowClient
2
+
3
+ Present when this organization has already resolved the client at least once.
4
+
5
+ ## Properties
6
+
7
+ Name | Type | Description | Notes
8
+ ------------ | ------------- | ------------- | -------------
9
+ **id** | **number** | | [optional] [default to undefined]
10
+ **last_fetched_at** | **string** | | [optional] [default to undefined]
11
+
12
+ ## Example
13
+
14
+ ```typescript
15
+ import { CimdCheckResultShadowClient } from '@lumoauth/api-client';
16
+
17
+ const instance: CimdCheckResultShadowClient = {
18
+ id,
19
+ last_fetched_at,
20
+ };
21
+ ```
22
+
23
+ [[Back to Model list]](../README.md#documentation-for-models) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to README]](../README.md)
@@ -15,7 +15,8 @@ Name | Type | Description | Notes
15
15
  **masked_phone** | **string** | | [optional] [default to undefined]
16
16
  **resend_after** | **number** | Seconds until a new code may be requested | [optional] [default to undefined]
17
17
  **masked_email** | **string** | | [optional] [default to undefined]
18
- **deep_link** | **string** | | [optional] [default to undefined]
18
+ **deep_link** | **string** | https://<server>/push-auth/enroll?d=… — an Android App Link / iOS Universal Link that opens the authenticator app on a phone (falls back to a help page without it). | [optional] [default to undefined]
19
+ **deep_link_android** | **string** | Same link as an intent:// URL pinned to the Android app package, for pages served from this host (Chrome keeps same-site App Links in the browser). Null when the deployment has not configured the package. | [optional] [default to undefined]
19
20
  **activation_code** | **string** | | [optional] [default to undefined]
20
21
  **public_key** | **object** | WebAuthn PublicKeyCredentialCreationOptions | [optional] [default to undefined]
21
22
 
@@ -36,6 +37,7 @@ const instance: EnrollAuthenticator201Response = {
36
37
  resend_after,
37
38
  masked_email,
38
39
  deep_link,
40
+ deep_link_android,
39
41
  activation_code,
40
42
  public_key,
41
43
  };
@@ -6,7 +6,7 @@
6
6
  Name | Type | Description | Notes
7
7
  ------------ | ------------- | ------------- | -------------
8
8
  **resource** | **string** | | [default to undefined]
9
- **authorization_servers** | **Array<string>** | | [default to undefined]
9
+ **authorization_servers** | **Array<string>** | The organization\'s issuer identifier (RFC 8414). | [default to undefined]
10
10
  **bearer_methods_supported** | **Array<string>** | | [default to undefined]
11
11
  **scopes_supported** | **Array<string>** | | [optional] [default to undefined]
12
12
  **dpop_bound_access_tokens_required** | **boolean** | | [optional] [default to undefined]
@@ -7,7 +7,7 @@ Name | Type | Description | Notes
7
7
  ------------ | ------------- | ------------- | -------------
8
8
  **resource** | **string** | | [default to undefined]
9
9
  **resource_metadata_url** | **string** | Per-server protected resource metadata URL. | [default to undefined]
10
- **authorization_servers** | **Array<string>** | | [default to undefined]
10
+ **authorization_servers** | **Array<string>** | The organization\'s issuer identifier (RFC 8414). | [default to undefined]
11
11
 
12
12
  ## Example
13
13
 
package/docs/McpApi.md CHANGED
@@ -9,6 +9,7 @@ All URIs are relative to *https://app.lumoauth.dev*
9
9
  |[**getServer**](#getserver) | **GET** /orgs/{orgId}/api/v1/mcp/servers/{serverId} | REST API: Get a specific MCP server.|
10
10
  |[**getServerChallenge**](#getserverchallenge) | **GET** /orgs/{orgId}/api/v1/mcp/{serverId}/challenge | Simulated MCP server authorization challenge|
11
11
  |[**listServers**](#listservers) | **GET** /orgs/{orgId}/api/v1/mcp/servers | REST API: List MCP servers for a tenant.|
12
+ |[**mcpServerToolAuthorize**](#mcpservertoolauthorize) | **POST** /orgs/{orgId}/api/v1/mcp/servers/{serverId}/tools/authorize | Per-tool authorization for an MCP server (server credential)|
12
13
  |[**postServerChallenge**](#postserverchallenge) | **POST** /orgs/{orgId}/api/v1/mcp/{serverId}/challenge | Simulated MCP server authorization challenge (POST)|
13
14
 
14
15
  # **getProtectedResourceMetadata**
@@ -286,6 +287,69 @@ const { status, data } = await apiInstance.listServers(
286
287
 
287
288
  [[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
288
289
 
290
+ # **mcpServerToolAuthorize**
291
+ > McpServerToolAuthorizeResponse mcpServerToolAuthorize(mcpServerToolAuthorizeRequest)
292
+
293
+ Called by the MCP server with its own client-credentials access token (scope mcp:authorize; the client must be listed in the server\'s tool_authorizer_client_ids). The body names the caller the server already verified. The server never forwards the caller\'s token.
294
+
295
+ ### Example
296
+
297
+ ```typescript
298
+ import {
299
+ McpApi,
300
+ Configuration,
301
+ McpServerToolAuthorizeRequest
302
+ } from '@lumoauth/api-client';
303
+
304
+ const configuration = new Configuration();
305
+ const apiInstance = new McpApi(configuration);
306
+
307
+ let orgId: string; // (default to undefined)
308
+ let serverId: string; // (default to undefined)
309
+ let mcpServerToolAuthorizeRequest: McpServerToolAuthorizeRequest; //
310
+
311
+ const { status, data } = await apiInstance.mcpServerToolAuthorize(
312
+ orgId,
313
+ serverId,
314
+ mcpServerToolAuthorizeRequest
315
+ );
316
+ ```
317
+
318
+ ### Parameters
319
+
320
+ |Name | Type | Description | Notes|
321
+ |------------- | ------------- | ------------- | -------------|
322
+ | **mcpServerToolAuthorizeRequest** | **McpServerToolAuthorizeRequest**| | |
323
+ | **orgId** | [**string**] | | defaults to undefined|
324
+ | **serverId** | [**string**] | | defaults to undefined|
325
+
326
+
327
+ ### Return type
328
+
329
+ **McpServerToolAuthorizeResponse**
330
+
331
+ ### Authorization
332
+
333
+ [ApiKeyAuth](../README.md#ApiKeyAuth), [BearerAuth](../README.md#BearerAuth)
334
+
335
+ ### HTTP request headers
336
+
337
+ - **Content-Type**: application/json
338
+ - **Accept**: application/json
339
+
340
+
341
+ ### HTTP response details
342
+ | Status code | Description | Response headers |
343
+ |-------------|-------------|------------------|
344
+ |**200** | Allowed. | - |
345
+ |**400** | invalid_request — malformed subject or tool. | - |
346
+ |**401** | invalid_token — no valid client-credentials token of this organization. | - |
347
+ |**403** | Denied (allowed=false), or insufficient_scope / not an authorizer client of this server. | - |
348
+ |**404** | not_found — unknown organization, or unknown / inactive MCP server. | - |
349
+ |**429** | too_many_requests (Retry-After header). | - |
350
+
351
+ [[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
352
+
289
353
  # **postServerChallenge**
290
354
  > GetServerChallengeResponse postServerChallenge()
291
355
 
package/docs/McpServer.md CHANGED
@@ -12,11 +12,14 @@ Name | Type | Description | Notes
12
12
  **resource_uri** | **string** | | [optional] [default to undefined]
13
13
  **endpoint_url** | **string** | | [optional] [default to undefined]
14
14
  **transport** | **string** | | [optional] [default to undefined]
15
+ **transport_deprecated** | **boolean** | True for http_sse, deprecated in MCP 2026-07-28; migrate to http_streamable. | [optional] [default to undefined]
15
16
  **auth_mode** | **string** | | [optional] [default to undefined]
16
17
  **status** | **string** | | [optional] [default to undefined]
17
18
  **scopes_supported** | **Array<string>** | | [optional] [default to undefined]
18
19
  **scope_descriptions** | **{ [key: string]: string; }** | | [optional] [default to undefined]
20
+ **basic_scopes** | **Array<string>** | Subset of scopes_supported advertised in the 401 challenge and in protected resource metadata. Empty = the whole vocabulary. | [optional] [default to undefined]
19
21
  **allowed_client_ids** | **Array<string>** | | [optional] [default to undefined]
22
+ **tool_authorizer_client_ids** | **Array<string>** | The MCP server\'s own OAuth clients allowed to call the per-tool authorization endpoint. | [optional] [default to undefined]
20
23
  **require_pkce** | **boolean** | | [optional] [default to undefined]
21
24
  **require_resource_param** | **boolean** | | [optional] [default to undefined]
22
25
  **require_dpop** | **boolean** | | [optional] [default to undefined]
@@ -38,11 +41,14 @@ const instance: McpServer = {
38
41
  resource_uri,
39
42
  endpoint_url,
40
43
  transport,
44
+ transport_deprecated,
41
45
  auth_mode,
42
46
  status,
43
47
  scopes_supported,
44
48
  scope_descriptions,
49
+ basic_scopes,
45
50
  allowed_client_ids,
51
+ tool_authorizer_client_ids,
46
52
  require_pkce,
47
53
  require_resource_param,
48
54
  require_dpop,
@@ -0,0 +1,22 @@
1
+ # McpServerToolAuthorizeRequest
2
+
3
+
4
+ ## Properties
5
+
6
+ Name | Type | Description | Notes
7
+ ------------ | ------------- | ------------- | -------------
8
+ **subject** | [**McpServerToolAuthorizeRequestSubject**](McpServerToolAuthorizeRequestSubject.md) | | [default to undefined]
9
+ **tool** | **string** | | [default to undefined]
10
+
11
+ ## Example
12
+
13
+ ```typescript
14
+ import { McpServerToolAuthorizeRequest } from '@lumoauth/api-client';
15
+
16
+ const instance: McpServerToolAuthorizeRequest = {
17
+ subject,
18
+ tool,
19
+ };
20
+ ```
21
+
22
+ [[Back to Model list]](../README.md#documentation-for-models) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to README]](../README.md)
@@ -0,0 +1,22 @@
1
+ # McpServerToolAuthorizeRequestSubject
2
+
3
+
4
+ ## Properties
5
+
6
+ Name | Type | Description | Notes
7
+ ------------ | ------------- | ------------- | -------------
8
+ **type** | **string** | | [default to undefined]
9
+ **id** | **string** | User UUID, or agent id (agt_…). For an MCP token, the user id is `sub`; for an agent token `sub` is `agent_<id>`. | [default to undefined]
10
+
11
+ ## Example
12
+
13
+ ```typescript
14
+ import { McpServerToolAuthorizeRequestSubject } from '@lumoauth/api-client';
15
+
16
+ const instance: McpServerToolAuthorizeRequestSubject = {
17
+ type,
18
+ id,
19
+ };
20
+ ```
21
+
22
+ [[Back to Model list]](../README.md#documentation-for-models) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to README]](../README.md)
@@ -0,0 +1,24 @@
1
+ # McpServerToolAuthorizeResponse
2
+
3
+
4
+ ## Properties
5
+
6
+ Name | Type | Description | Notes
7
+ ------------ | ------------- | ------------- | -------------
8
+ **allowed** | **boolean** | | [optional] [default to undefined]
9
+ **subject** | **object** | | [optional] [default to undefined]
10
+ **resource** | **object** | | [optional] [default to undefined]
11
+
12
+ ## Example
13
+
14
+ ```typescript
15
+ import { McpServerToolAuthorizeResponse } from '@lumoauth/api-client';
16
+
17
+ const instance: McpServerToolAuthorizeResponse = {
18
+ allowed,
19
+ subject,
20
+ resource,
21
+ };
22
+ ```
23
+
24
+ [[Back to Model list]](../README.md#documentation-for-models) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to README]](../README.md)
@@ -30,7 +30,7 @@ Name | Type | Description | Notes
30
30
  **require_signed_request_object** | **boolean** | | [optional] [default to undefined]
31
31
  **request_object_signing_alg_values_supported** | **Array<string>** | | [optional] [default to undefined]
32
32
  **ui_locales_supported** | **Array<string>** | | [optional] [default to undefined]
33
- **acr_values_supported** | **Array<string>** | The four MFA tier ACR values, unless overridden in organization settings. | [optional] [default to undefined]
33
+ **acr_values_supported** | **Array<string>** | The four MFA tier ACR values plus the single-factor urn:lumoauth:acr:pwd (any signed-in session), unless overridden in organization settings. | [optional] [default to undefined]
34
34
  **code_challenge_methods_supported** | **Array<string>** | | [optional] [default to undefined]
35
35
  **authorization_response_iss_parameter_supported** | **boolean** | | [optional] [default to undefined]
36
36
  **pushed_authorization_request_endpoint** | **string** | | [optional] [default to undefined]
@@ -53,7 +53,7 @@ Name | Type | Description | Notes
53
53
  **backchannel_user_code_parameter_supported** | **boolean** | | [optional] [default to undefined]
54
54
  **service_documentation** | **string** | | [optional] [default to undefined]
55
55
  **entity_profiles_supported** | **Array<string>** | | [optional] [default to undefined]
56
- **client_id_metadata_document_supported** | **boolean** | Only when CIMD is enabled for the organization. | [optional] [default to undefined]
56
+ **client_id_metadata_document_supported** | **boolean** | Present (true) unless the organization switched Client ID Metadata Documents off. | [optional] [default to undefined]
57
57
  **authorization_grant_profiles_supported** | **Array<string>** | Only when the organization accepts ID-JAGs. | [optional] [default to undefined]
58
58
  **op_policy_uri** | **string** | Only when configured. | [optional] [default to undefined]
59
59
  **op_tos_uri** | **string** | Only when configured. | [optional] [default to undefined]
@@ -6,7 +6,7 @@
6
6
  Name | Type | Description | Notes
7
7
  ------------ | ------------- | ------------- | -------------
8
8
  **resource** | **string** | The MCP server\'s resource identifier. | [default to undefined]
9
- **authorization_servers** | **Array<string>** | This organization\'s authorization server metadata URL. | [default to undefined]
9
+ **authorization_servers** | **Array<string>** | The organization\'s issuer identifier (RFC 8414), the same value as `issuer` in its discovery documents. Clients read the authorization server metadata from {issuer}/.well-known/openid-configuration. | [default to undefined]
10
10
  **bearer_methods_supported** | **Array<string>** | | [default to undefined]
11
11
  **scopes_supported** | **Array<string>** | | [optional] [default to undefined]
12
12
  **dpop_bound_access_tokens_required** | **boolean** | Present (true) only when the server accepts DPoP-bound tokens exclusively. | [optional] [default to undefined]
@@ -8,7 +8,8 @@ Name | Type | Description | Notes
8
8
  **id** | **string** | | [optional] [default to undefined]
9
9
  **state** | **string** | | [optional] [default to undefined]
10
10
  **qr_data_uri** | **string** | | [optional] [default to undefined]
11
- **deep_link** | **string** | | [optional] [default to undefined]
11
+ **deep_link** | **string** | https://<server>/push-auth/enroll?d=… — an Android App Link / iOS Universal Link that opens the authenticator app on a phone (falls back to a help page without it). | [optional] [default to undefined]
12
+ **deep_link_android** | **string** | Same link as an intent:// URL pinned to the Android app package, for pages served from this host (Chrome keeps same-site App Links in the browser). Null when the deployment has not configured the package. | [optional] [default to undefined]
12
13
  **activation_code** | **string** | | [optional] [default to undefined]
13
14
  **expires_at** | **string** | | [optional] [default to undefined]
14
15
 
@@ -22,6 +23,7 @@ const instance: PushEnrollmentStarted = {
22
23
  state,
23
24
  qr_data_uri,
24
25
  deep_link,
26
+ deep_link_android,
25
27
  activation_code,
26
28
  expires_at,
27
29
  };
@@ -6,7 +6,7 @@
6
6
  Name | Type | Description | Notes
7
7
  ------------ | ------------- | ------------- | -------------
8
8
  **resource** | **string** | | [default to undefined]
9
- **authorization_servers** | **Array<string>** | | [default to undefined]
9
+ **authorization_servers** | **Array<string>** | The organization\'s issuer identifier (RFC 8414). | [default to undefined]
10
10
  **bearer_methods_supported** | **Array<string>** | | [default to undefined]
11
11
  **scopes_supported** | **Array<string>** | | [optional] [default to undefined]
12
12
  **dpop_bound_access_tokens_required** | **boolean** | | [optional] [default to undefined]
@@ -12,7 +12,7 @@ All URIs are relative to *https://app.lumoauth.dev*
12
12
  # **getAuthorizationServerMetadata**
13
13
  > AuthorizationServerMetadata getAuthorizationServerMetadata()
14
14
 
15
- Public, CORS-enabled and cacheable (Cache-Control: public, max-age=3600). Endpoint URLs are rewritten to the organization\'s custom domain when one is active.
15
+ Public, CORS-enabled and cacheable (Cache-Control: public, max-age=3600). Endpoint URLs are rewritten to the organization\'s custom domain when one is active. RFC 8414 clients read it from /.well-known/oauth-authorization-server/orgs/{orgId}/api/v1 (the issuer\'s path-inserted location) and, on a verified custom domain, from /.well-known/oauth-authorization-server.
16
16
 
17
17
  ### Example
18
18
 
@@ -56,7 +56,7 @@ No authorization required
56
56
  ### HTTP response details
57
57
  | Status code | Description | Response headers |
58
58
  |-------------|-------------|------------------|
59
- |**200** | Authorization server metadata. Conditional members: client_id_metadata_document_supported (CIMD opted in), authorization_grant_profiles_supported and the jwt-bearer grant (Cross App Access resource role), op_policy_uri / op_tos_uri (organization settings). | - |
59
+ |**200** | Authorization server metadata. Conditional members: client_id_metadata_document_supported (CIMD on, the default), authorization_grant_profiles_supported and the jwt-bearer grant (Cross App Access resource role), op_policy_uri / op_tos_uri (organization settings). | - |
60
60
  |**404** | invalid_tenant — unknown or inactive organization. | - |
61
61
 
62
62
  [[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
@@ -116,7 +116,7 @@ No authorization required
116
116
  # **getOpenidConfiguration**
117
117
  > OpenIdConfiguration getOpenidConfiguration()
118
118
 
119
- Public, CORS-enabled and cacheable (Cache-Control: public, max-age=3600). Endpoint URLs are rewritten to the organization\'s custom domain when one is active.
119
+ Public, CORS-enabled and cacheable (Cache-Control: public, max-age=3600). Endpoint URLs are rewritten to the organization\'s custom domain when one is active. The same document is served at the RFC 8414 location /.well-known/openid-configuration/orgs/{orgId}/api/v1 and, on a verified custom domain (whose issuer is the bare domain), at /.well-known/openid-configuration.
120
120
 
121
121
  ### Example
122
122
 
@@ -160,7 +160,7 @@ No authorization required
160
160
  ### HTTP response details
161
161
  | Status code | Description | Response headers |
162
162
  |-------------|-------------|------------------|
163
- |**200** | OpenID Provider metadata. Conditional members: client_id_metadata_document_supported (CIMD opted in), authorization_grant_profiles_supported and the jwt-bearer grant (Cross App Access resource role), op_policy_uri / op_tos_uri and a tenant acr_values_supported override (organization settings). | - |
163
+ |**200** | OpenID Provider metadata. Conditional members: client_id_metadata_document_supported (CIMD on, the default), authorization_grant_profiles_supported and the jwt-bearer grant (Cross App Access resource role), op_policy_uri / op_tos_uri and a tenant acr_values_supported override (organization settings). | - |
164
164
  |**404** | invalid_tenant — unknown or inactive organization. | - |
165
165
 
166
166
  [[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
@@ -21,7 +21,7 @@
21
21
  */
22
22
  export interface AdminAgentsGenerateTokenRequest {
23
23
  /**
24
- * Token lifetime in seconds. Default 3600, at most 2592000 (30 days).
24
+ * Token lifetime in seconds. Default 3600, minimum 60, at most 86400 (24 hours). Above 3600 only together with `resource`: a long-lived token is always bound to one MCP server, never to the organization API.
25
25
  * @type {number}
26
26
  * @memberof AdminAgentsGenerateTokenRequest
27
27
  */
@@ -32,5 +32,11 @@ export interface AdminAgentsGenerateTokenRequest {
32
32
  * @memberof AdminAgentsGenerateTokenRequest
33
33
  */
34
34
  'scopes'?: Array<string>;
35
+ /**
36
+ * Optional resource URI of an active MCP server of this organization. The token is then audience-bound to that server (and no longer works on the LumoAuth API) and lives at most the server\'s token lifetime. Servers that require DPoP are refused with 400.
37
+ * @type {string}
38
+ * @memberof AdminAgentsGenerateTokenRequest
39
+ */
40
+ 'resource'?: string;
35
41
  }
36
42
 
@@ -38,11 +38,23 @@ export interface AdminAgentsGenerateTokenResponseData {
38
38
  * @memberof AdminAgentsGenerateTokenResponseData
39
39
  */
40
40
  'expiresIn'?: number;
41
+ /**
42
+ * The token id. Written to the agent.token_issued audit event; the kill switch and a capability reduction deny-list it.
43
+ * @type {string}
44
+ * @memberof AdminAgentsGenerateTokenResponseData
45
+ */
46
+ 'jti'?: string;
41
47
  /**
42
48
  *
43
49
  * @type {Array<string>}
44
50
  * @memberof AdminAgentsGenerateTokenResponseData
45
51
  */
46
52
  'scopes'?: Array<string>;
53
+ /**
54
+ * The MCP server the token is bound to, when `resource` was sent.
55
+ * @type {string}
56
+ * @memberof AdminAgentsGenerateTokenResponseData
57
+ */
58
+ 'resource'?: string | null;
47
59
  }
48
60
 
@@ -0,0 +1,36 @@
1
+ /* tslint:disable */
2
+ /* eslint-disable */
3
+ /**
4
+ * LumoAuth API
5
+ * LumoAuth REST API — authentication, authorization, agent registry, MCP server authorization, and tenant administration. Multi-tenant: most paths are scoped under `/orgs/{orgId}/api/v1/...`.
6
+ *
7
+ * The version of the OpenAPI document: 1.0.0
8
+ * Contact: sdk@lumoauth.dev
9
+ *
10
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
11
+ * https://openapi-generator.tech
12
+ * Do not edit the class manually.
13
+ */
14
+
15
+
16
+
17
+ /**
18
+ *
19
+ * @export
20
+ * @interface AdminClientsCimdCheckRequest
21
+ */
22
+ export interface AdminClientsCimdCheckRequest {
23
+ /**
24
+ * The Client Identifier URL (https, with a path).
25
+ * @type {string}
26
+ * @memberof AdminClientsCimdCheckRequest
27
+ */
28
+ 'client_id': string;
29
+ /**
30
+ * Ignore the cached document and fetch it again.
31
+ * @type {boolean}
32
+ * @memberof AdminClientsCimdCheckRequest
33
+ */
34
+ 'refresh'?: boolean;
35
+ }
36
+
@@ -0,0 +1,33 @@
1
+ /* tslint:disable */
2
+ /* eslint-disable */
3
+ /**
4
+ * LumoAuth API
5
+ * LumoAuth REST API — authentication, authorization, agent registry, MCP server authorization, and tenant administration. Multi-tenant: most paths are scoped under `/orgs/{orgId}/api/v1/...`.
6
+ *
7
+ * The version of the OpenAPI document: 1.0.0
8
+ * Contact: sdk@lumoauth.dev
9
+ *
10
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
11
+ * https://openapi-generator.tech
12
+ * Do not edit the class manually.
13
+ */
14
+
15
+
16
+ // May contain unused imports in some cases
17
+ // @ts-ignore
18
+ import type { CimdCheckResult } from './cimd-check-result';
19
+
20
+ /**
21
+ *
22
+ * @export
23
+ * @interface AdminClientsCimdCheckResponse
24
+ */
25
+ export interface AdminClientsCimdCheckResponse {
26
+ /**
27
+ *
28
+ * @type {CimdCheckResult}
29
+ * @memberof AdminClientsCimdCheckResponse
30
+ */
31
+ 'data'?: CimdCheckResult;
32
+ }
33
+
@@ -60,7 +60,8 @@ export interface AttestResponse {
60
60
  * @enum {string}
61
61
  */
62
62
  export enum AttestResponseTokenType {
63
- BEARER = 'Bearer'
63
+ BEARER = 'Bearer',
64
+ DPO_P = 'DPoP'
64
65
  }
65
66
 
66
67