@lumoauth/api-client 1.1.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 (95) hide show
  1. package/.openapi-generator/FILES +6 -0
  2. package/README.md +6 -2
  3. package/api/aauth-api.ts +5 -5
  4. package/api/admin-mcp-api.ts +5 -5
  5. package/api/agents-api.ts +5 -5
  6. package/api/mcp-api.ts +130 -0
  7. package/api/well-known-api.ts +10 -10
  8. package/dist/api/aauth-api.d.ts +5 -5
  9. package/dist/api/aauth-api.js +4 -4
  10. package/dist/api/admin-mcp-api.d.ts +5 -5
  11. package/dist/api/admin-mcp-api.js +4 -4
  12. package/dist/api/agents-api.d.ts +5 -5
  13. package/dist/api/agents-api.js +4 -4
  14. package/dist/api/mcp-api.d.ts +73 -0
  15. package/dist/api/mcp-api.js +82 -0
  16. package/dist/api/well-known-api.d.ts +10 -10
  17. package/dist/api/well-known-api.js +8 -8
  18. package/dist/esm/api/aauth-api.d.ts +5 -5
  19. package/dist/esm/api/aauth-api.js +4 -4
  20. package/dist/esm/api/admin-mcp-api.d.ts +5 -5
  21. package/dist/esm/api/admin-mcp-api.js +4 -4
  22. package/dist/esm/api/agents-api.d.ts +5 -5
  23. package/dist/esm/api/agents-api.js +4 -4
  24. package/dist/esm/api/mcp-api.d.ts +73 -0
  25. package/dist/esm/api/mcp-api.js +83 -1
  26. package/dist/esm/api/well-known-api.d.ts +10 -10
  27. package/dist/esm/api/well-known-api.js +8 -8
  28. package/dist/esm/models/admin-agents-generate-token-request.d.ts +7 -1
  29. package/dist/esm/models/admin-agents-generate-token-response-data.d.ts +12 -0
  30. package/dist/esm/models/attest-response.d.ts +2 -1
  31. package/dist/esm/models/attest-response.js +1 -0
  32. package/dist/esm/models/authorize-mcp-request.d.ts +1 -1
  33. package/dist/esm/models/get-protected-resource-metadata-root-response1-resources-item.d.ts +1 -1
  34. package/dist/esm/models/index.d.ts +3 -0
  35. package/dist/esm/models/index.js +3 -0
  36. package/dist/esm/models/mcp-server-tool-authorize-request-subject.d.ts +38 -0
  37. package/dist/esm/models/mcp-server-tool-authorize-request-subject.js +22 -0
  38. package/dist/esm/models/mcp-server-tool-authorize-request.d.ts +31 -0
  39. package/dist/esm/models/mcp-server-tool-authorize-request.js +14 -0
  40. package/dist/esm/models/mcp-server-tool-authorize-response.d.ts +36 -0
  41. package/dist/esm/models/mcp-server-tool-authorize-response.js +14 -0
  42. package/dist/esm/models/mcp-server.d.ts +18 -0
  43. package/dist/esm/models/open-id-configuration.d.ts +1 -1
  44. package/dist/esm/models/protected-resource-metadata.d.ts +1 -1
  45. package/dist/esm/models/single-server-metadata.d.ts +1 -1
  46. package/dist/models/admin-agents-generate-token-request.d.ts +7 -1
  47. package/dist/models/admin-agents-generate-token-response-data.d.ts +12 -0
  48. package/dist/models/attest-response.d.ts +2 -1
  49. package/dist/models/attest-response.js +1 -0
  50. package/dist/models/authorize-mcp-request.d.ts +1 -1
  51. package/dist/models/get-protected-resource-metadata-root-response1-resources-item.d.ts +1 -1
  52. package/dist/models/index.d.ts +3 -0
  53. package/dist/models/index.js +3 -0
  54. package/dist/models/mcp-server-tool-authorize-request-subject.d.ts +38 -0
  55. package/dist/models/mcp-server-tool-authorize-request-subject.js +25 -0
  56. package/dist/models/mcp-server-tool-authorize-request.d.ts +31 -0
  57. package/dist/models/mcp-server-tool-authorize-request.js +15 -0
  58. package/dist/models/mcp-server-tool-authorize-response.d.ts +36 -0
  59. package/dist/models/mcp-server-tool-authorize-response.js +15 -0
  60. package/dist/models/mcp-server.d.ts +18 -0
  61. package/dist/models/open-id-configuration.d.ts +1 -1
  62. package/dist/models/protected-resource-metadata.d.ts +1 -1
  63. package/dist/models/single-server-metadata.d.ts +1 -1
  64. package/docs/AAuthApi.md +1 -1
  65. package/docs/AdminAgentsApi.md +1 -1
  66. package/docs/AdminAgentsGenerateTokenRequest.md +3 -1
  67. package/docs/AdminAgentsGenerateTokenResponseData.md +4 -0
  68. package/docs/AdminMcpApi.md +1 -1
  69. package/docs/AgentsApi.md +4 -3
  70. package/docs/AuthorizeMcpRequest.md +1 -1
  71. package/docs/GetProtectedResourceMetadataRoot200Response.md +1 -1
  72. package/docs/GetProtectedResourceMetadataRootResponse1ResourcesItem.md +1 -1
  73. package/docs/McpApi.md +64 -0
  74. package/docs/McpServer.md +6 -0
  75. package/docs/McpServerToolAuthorizeRequest.md +22 -0
  76. package/docs/McpServerToolAuthorizeRequestSubject.md +22 -0
  77. package/docs/McpServerToolAuthorizeResponse.md +24 -0
  78. package/docs/OpenIdConfiguration.md +1 -1
  79. package/docs/ProtectedResourceMetadata.md +1 -1
  80. package/docs/SingleServerMetadata.md +1 -1
  81. package/docs/WellKnownApi.md +2 -2
  82. package/models/admin-agents-generate-token-request.ts +7 -1
  83. package/models/admin-agents-generate-token-response-data.ts +12 -0
  84. package/models/attest-response.ts +2 -1
  85. package/models/authorize-mcp-request.ts +1 -1
  86. package/models/get-protected-resource-metadata-root-response1-resources-item.ts +1 -1
  87. package/models/index.ts +3 -0
  88. package/models/mcp-server-tool-authorize-request-subject.ts +46 -0
  89. package/models/mcp-server-tool-authorize-request.ts +39 -0
  90. package/models/mcp-server-tool-authorize-response.ts +42 -0
  91. package/models/mcp-server.ts +18 -0
  92. package/models/open-id-configuration.ts +1 -1
  93. package/models/protected-resource-metadata.ts +1 -1
  94. package/models/single-server-metadata.ts +1 -1
  95. package/package.json +1 -1
@@ -36,7 +36,7 @@ const base_1 = require("../base");
36
36
  const WellKnownApiAxiosParamCreator = function (configuration) {
37
37
  return {
38
38
  /**
39
- * 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.
39
+ * 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.
40
40
  * @summary OAuth 2.0 authorization server metadata (RFC 8414)
41
41
  * @param {string} orgId
42
42
  * @param {*} [options] Override http request option.
@@ -94,7 +94,7 @@ const WellKnownApiAxiosParamCreator = function (configuration) {
94
94
  };
95
95
  }),
96
96
  /**
97
- * 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.
97
+ * 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.
98
98
  * @summary OpenID Provider configuration (OIDC Discovery 1.0)
99
99
  * @param {string} orgId
100
100
  * @param {*} [options] Override http request option.
@@ -162,7 +162,7 @@ const WellKnownApiFp = function (configuration) {
162
162
  const localVarAxiosParamCreator = (0, exports.WellKnownApiAxiosParamCreator)(configuration);
163
163
  return {
164
164
  /**
165
- * 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.
165
+ * 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.
166
166
  * @summary OAuth 2.0 authorization server metadata (RFC 8414)
167
167
  * @param {string} orgId
168
168
  * @param {*} [options] Override http request option.
@@ -194,7 +194,7 @@ const WellKnownApiFp = function (configuration) {
194
194
  });
195
195
  },
196
196
  /**
197
- * 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.
197
+ * 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.
198
198
  * @summary OpenID Provider configuration (OIDC Discovery 1.0)
199
199
  * @param {string} orgId
200
200
  * @param {*} [options] Override http request option.
@@ -236,7 +236,7 @@ const WellKnownApiFactory = function (configuration, basePath, axios) {
236
236
  const localVarFp = (0, exports.WellKnownApiFp)(configuration);
237
237
  return {
238
238
  /**
239
- * 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.
239
+ * 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.
240
240
  * @summary OAuth 2.0 authorization server metadata (RFC 8414)
241
241
  * @param {WellKnownApiGetAuthorizationServerMetadataRequest} requestParameters Request parameters.
242
242
  * @param {*} [options] Override http request option.
@@ -256,7 +256,7 @@ const WellKnownApiFactory = function (configuration, basePath, axios) {
256
256
  return localVarFp.getJwks(requestParameters.orgId, options).then((request) => request(axios, basePath));
257
257
  },
258
258
  /**
259
- * 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.
259
+ * 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.
260
260
  * @summary OpenID Provider configuration (OIDC Discovery 1.0)
261
261
  * @param {WellKnownApiGetOpenidConfigurationRequest} requestParameters Request parameters.
262
262
  * @param {*} [options] Override http request option.
@@ -286,7 +286,7 @@ exports.WellKnownApiFactory = WellKnownApiFactory;
286
286
  */
287
287
  class WellKnownApi extends base_1.BaseAPI {
288
288
  /**
289
- * 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.
289
+ * 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.
290
290
  * @summary OAuth 2.0 authorization server metadata (RFC 8414)
291
291
  * @param {WellKnownApiGetAuthorizationServerMetadataRequest} requestParameters Request parameters.
292
292
  * @param {*} [options] Override http request option.
@@ -308,7 +308,7 @@ class WellKnownApi extends base_1.BaseAPI {
308
308
  return (0, exports.WellKnownApiFp)(this.configuration).getJwks(requestParameters.orgId, options).then((request) => request(this.axios, this.basePath));
309
309
  }
310
310
  /**
311
- * 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.
311
+ * 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.
312
312
  * @summary OpenID Provider configuration (OIDC Discovery 1.0)
313
313
  * @param {WellKnownApiGetOpenidConfigurationRequest} requestParameters Request parameters.
314
314
  * @param {*} [options] Override http request option.
@@ -110,7 +110,7 @@ export declare const AAuthApiAxiosParamCreator: (configuration?: Configuration)
110
110
  */
111
111
  getResourceMetadataById: (orgId: string, resourceId: string, options?: RawAxiosRequestConfig) => Promise<RequestArgs>;
112
112
  /**
113
- * Per Section 9: The agent token endpoint is the auth server\'s endpoint agents use to request auth tokens. Required HTTP signature covering: @method, @target-uri, content-type, content-digest, authorization
113
+ * Per Section 9: The agent token endpoint is the auth server\'s endpoint agents use to request auth tokens. Required HTTP signature covering: @method, @authority, @path, signature-key (plus @query when the URL has one), content-digest, content-type, authorization
114
114
  * @summary Agent Token Endpoint
115
115
  * @param {string} orgId
116
116
  * @param {IssueAgentTokenRequest} issueAgentTokenRequest
@@ -254,7 +254,7 @@ export declare const AAuthApiFp: (configuration?: Configuration) => {
254
254
  */
255
255
  getResourceMetadataById(orgId: string, resourceId: string, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<object>>;
256
256
  /**
257
- * Per Section 9: The agent token endpoint is the auth server\'s endpoint agents use to request auth tokens. Required HTTP signature covering: @method, @target-uri, content-type, content-digest, authorization
257
+ * Per Section 9: The agent token endpoint is the auth server\'s endpoint agents use to request auth tokens. Required HTTP signature covering: @method, @authority, @path, signature-key (plus @query when the URL has one), content-digest, content-type, authorization
258
258
  * @summary Agent Token Endpoint
259
259
  * @param {string} orgId
260
260
  * @param {IssueAgentTokenRequest} issueAgentTokenRequest
@@ -394,7 +394,7 @@ export declare const AAuthApiFactory: (configuration?: Configuration, basePath?:
394
394
  */
395
395
  getResourceMetadataById(requestParameters: AAuthApiGetResourceMetadataByIdRequest, options?: RawAxiosRequestConfig): AxiosPromise<object>;
396
396
  /**
397
- * Per Section 9: The agent token endpoint is the auth server\'s endpoint agents use to request auth tokens. Required HTTP signature covering: @method, @target-uri, content-type, content-digest, authorization
397
+ * Per Section 9: The agent token endpoint is the auth server\'s endpoint agents use to request auth tokens. Required HTTP signature covering: @method, @authority, @path, signature-key (plus @query when the URL has one), content-digest, content-type, authorization
398
398
  * @summary Agent Token Endpoint
399
399
  * @param {AAuthApiIssueAgentTokenRequest} requestParameters Request parameters.
400
400
  * @param {*} [options] Override http request option.
@@ -537,7 +537,7 @@ export interface AAuthApiInterface {
537
537
  */
538
538
  getResourceMetadataById(requestParameters: AAuthApiGetResourceMetadataByIdRequest, options?: RawAxiosRequestConfig): AxiosPromise<object>;
539
539
  /**
540
- * Per Section 9: The agent token endpoint is the auth server\'s endpoint agents use to request auth tokens. Required HTTP signature covering: @method, @target-uri, content-type, content-digest, authorization
540
+ * Per Section 9: The agent token endpoint is the auth server\'s endpoint agents use to request auth tokens. Required HTTP signature covering: @method, @authority, @path, signature-key (plus @query when the URL has one), content-digest, content-type, authorization
541
541
  * @summary Agent Token Endpoint
542
542
  * @param {AAuthApiIssueAgentTokenRequest} requestParameters Request parameters.
543
543
  * @param {*} [options] Override http request option.
@@ -962,7 +962,7 @@ export declare class AAuthApi extends BaseAPI implements AAuthApiInterface {
962
962
  */
963
963
  getResourceMetadataById(requestParameters: AAuthApiGetResourceMetadataByIdRequest, options?: RawAxiosRequestConfig): Promise<import("axios").AxiosResponse<object, any, {}>>;
964
964
  /**
965
- * Per Section 9: The agent token endpoint is the auth server\'s endpoint agents use to request auth tokens. Required HTTP signature covering: @method, @target-uri, content-type, content-digest, authorization
965
+ * Per Section 9: The agent token endpoint is the auth server\'s endpoint agents use to request auth tokens. Required HTTP signature covering: @method, @authority, @path, signature-key (plus @query when the URL has one), content-digest, content-type, authorization
966
966
  * @summary Agent Token Endpoint
967
967
  * @param {AAuthApiIssueAgentTokenRequest} requestParameters Request parameters.
968
968
  * @param {*} [options] Override http request option.
@@ -313,7 +313,7 @@ export const AAuthApiAxiosParamCreator = function (configuration) {
313
313
  };
314
314
  }),
315
315
  /**
316
- * Per Section 9: The agent token endpoint is the auth server\'s endpoint agents use to request auth tokens. Required HTTP signature covering: @method, @target-uri, content-type, content-digest, authorization
316
+ * Per Section 9: The agent token endpoint is the auth server\'s endpoint agents use to request auth tokens. Required HTTP signature covering: @method, @authority, @path, signature-key (plus @query when the URL has one), content-digest, content-type, authorization
317
317
  * @summary Agent Token Endpoint
318
318
  * @param {string} orgId
319
319
  * @param {IssueAgentTokenRequest} issueAgentTokenRequest
@@ -728,7 +728,7 @@ export const AAuthApiFp = function (configuration) {
728
728
  });
729
729
  },
730
730
  /**
731
- * Per Section 9: The agent token endpoint is the auth server\'s endpoint agents use to request auth tokens. Required HTTP signature covering: @method, @target-uri, content-type, content-digest, authorization
731
+ * Per Section 9: The agent token endpoint is the auth server\'s endpoint agents use to request auth tokens. Required HTTP signature covering: @method, @authority, @path, signature-key (plus @query when the URL has one), content-digest, content-type, authorization
732
732
  * @summary Agent Token Endpoint
733
733
  * @param {string} orgId
734
734
  * @param {IssueAgentTokenRequest} issueAgentTokenRequest
@@ -945,7 +945,7 @@ export const AAuthApiFactory = function (configuration, basePath, axios) {
945
945
  return localVarFp.getResourceMetadataById(requestParameters.orgId, requestParameters.resourceId, options).then((request) => request(axios, basePath));
946
946
  },
947
947
  /**
948
- * Per Section 9: The agent token endpoint is the auth server\'s endpoint agents use to request auth tokens. Required HTTP signature covering: @method, @target-uri, content-type, content-digest, authorization
948
+ * Per Section 9: The agent token endpoint is the auth server\'s endpoint agents use to request auth tokens. Required HTTP signature covering: @method, @authority, @path, signature-key (plus @query when the URL has one), content-digest, content-type, authorization
949
949
  * @summary Agent Token Endpoint
950
950
  * @param {AAuthApiIssueAgentTokenRequest} requestParameters Request parameters.
951
951
  * @param {*} [options] Override http request option.
@@ -1122,7 +1122,7 @@ export class AAuthApi extends BaseAPI {
1122
1122
  return AAuthApiFp(this.configuration).getResourceMetadataById(requestParameters.orgId, requestParameters.resourceId, options).then((request) => request(this.axios, this.basePath));
1123
1123
  }
1124
1124
  /**
1125
- * Per Section 9: The agent token endpoint is the auth server\'s endpoint agents use to request auth tokens. Required HTTP signature covering: @method, @target-uri, content-type, content-digest, authorization
1125
+ * Per Section 9: The agent token endpoint is the auth server\'s endpoint agents use to request auth tokens. Required HTTP signature covering: @method, @authority, @path, signature-key (plus @query when the URL has one), content-digest, content-type, authorization
1126
1126
  * @summary Agent Token Endpoint
1127
1127
  * @param {AAuthApiIssueAgentTokenRequest} requestParameters Request parameters.
1128
1128
  * @param {*} [options] Override http request option.
@@ -22,7 +22,7 @@ import type { MessageResponse } from '../models';
22
22
  */
23
23
  export declare const AdminMcpApiAxiosParamCreator: (configuration?: Configuration) => {
24
24
  /**
25
- * Body: name (required) — display name resource_uri (required) — RFC 8707 canonical URI; must be http(s)://, no fragment endpoint_url (optional) — actual MCP endpoint description (optional) scopes_supported (optional) — array OR space/comma-separated string transport (optional) — defaults to \"http_streamable\" auth_mode (optional) — defaults to \"oauth\" token_lifetime (optional, default 3600) — clamped to [60, 86400] allowed_client_ids (optional) — array of this organization\'s OAuth client ids; unknown ids are a 422 (never persisted as policy) require_pkce (optional, default true) require_resource_param (optional, default true) require_dpop (optional, default false) — RFC 9449 sender-constrained tokens only
25
+ * Body: name (required) — display name resource_uri (required) — RFC 8707 canonical URI: https:// (http:// only for loopback), no fragment, no user info, not a LumoAuth host, unique per organization after normalisation (same rules as the portal) endpoint_url (optional) — actual MCP endpoint description (optional) scopes_supported (optional) — array OR space/comma-separated string; omnibus scopes, offline_access and admin/scim scopes are refused (422) basic_scopes (optional) — subset of scopes_supported advertised in the 401 challenge and Protected Resource Metadata; no wildcards transport (optional) — defaults to \"http_streamable\" (\"http_sse\" is deprecated in MCP 2026-07-28) auth_mode (optional) — defaults to \"oauth\" token_lifetime (optional, default 3600) — 60..86400, else 422 tool_authorizer_client_ids (optional) — the MCP server\'s own OAuth clients that may call the per-tool authorization endpoint allowed_client_ids (optional) — array of this organization\'s OAuth client ids; unknown ids are a 422 (never persisted as policy) require_pkce (optional, default true) require_resource_param (optional, default true) require_dpop (optional, default false) — RFC 9449 sender-constrained tokens only
26
26
  * @summary Register an MCP server
27
27
  * @param {string} orgId
28
28
  * @param {*} [options] Override http request option.
@@ -62,7 +62,7 @@ export declare const AdminMcpApiAxiosParamCreator: (configuration?: Configuratio
62
62
  */
63
63
  export declare const AdminMcpApiFp: (configuration?: Configuration) => {
64
64
  /**
65
- * Body: name (required) — display name resource_uri (required) — RFC 8707 canonical URI; must be http(s)://, no fragment endpoint_url (optional) — actual MCP endpoint description (optional) scopes_supported (optional) — array OR space/comma-separated string transport (optional) — defaults to \"http_streamable\" auth_mode (optional) — defaults to \"oauth\" token_lifetime (optional, default 3600) — clamped to [60, 86400] allowed_client_ids (optional) — array of this organization\'s OAuth client ids; unknown ids are a 422 (never persisted as policy) require_pkce (optional, default true) require_resource_param (optional, default true) require_dpop (optional, default false) — RFC 9449 sender-constrained tokens only
65
+ * Body: name (required) — display name resource_uri (required) — RFC 8707 canonical URI: https:// (http:// only for loopback), no fragment, no user info, not a LumoAuth host, unique per organization after normalisation (same rules as the portal) endpoint_url (optional) — actual MCP endpoint description (optional) scopes_supported (optional) — array OR space/comma-separated string; omnibus scopes, offline_access and admin/scim scopes are refused (422) basic_scopes (optional) — subset of scopes_supported advertised in the 401 challenge and Protected Resource Metadata; no wildcards transport (optional) — defaults to \"http_streamable\" (\"http_sse\" is deprecated in MCP 2026-07-28) auth_mode (optional) — defaults to \"oauth\" token_lifetime (optional, default 3600) — 60..86400, else 422 tool_authorizer_client_ids (optional) — the MCP server\'s own OAuth clients that may call the per-tool authorization endpoint allowed_client_ids (optional) — array of this organization\'s OAuth client ids; unknown ids are a 422 (never persisted as policy) require_pkce (optional, default true) require_resource_param (optional, default true) require_dpop (optional, default false) — RFC 9449 sender-constrained tokens only
66
66
  * @summary Register an MCP server
67
67
  * @param {string} orgId
68
68
  * @param {*} [options] Override http request option.
@@ -102,7 +102,7 @@ export declare const AdminMcpApiFp: (configuration?: Configuration) => {
102
102
  */
103
103
  export declare const AdminMcpApiFactory: (configuration?: Configuration, basePath?: string, axios?: AxiosInstance) => {
104
104
  /**
105
- * Body: name (required) — display name resource_uri (required) — RFC 8707 canonical URI; must be http(s)://, no fragment endpoint_url (optional) — actual MCP endpoint description (optional) scopes_supported (optional) — array OR space/comma-separated string transport (optional) — defaults to \"http_streamable\" auth_mode (optional) — defaults to \"oauth\" token_lifetime (optional, default 3600) — clamped to [60, 86400] allowed_client_ids (optional) — array of this organization\'s OAuth client ids; unknown ids are a 422 (never persisted as policy) require_pkce (optional, default true) require_resource_param (optional, default true) require_dpop (optional, default false) — RFC 9449 sender-constrained tokens only
105
+ * Body: name (required) — display name resource_uri (required) — RFC 8707 canonical URI: https:// (http:// only for loopback), no fragment, no user info, not a LumoAuth host, unique per organization after normalisation (same rules as the portal) endpoint_url (optional) — actual MCP endpoint description (optional) scopes_supported (optional) — array OR space/comma-separated string; omnibus scopes, offline_access and admin/scim scopes are refused (422) basic_scopes (optional) — subset of scopes_supported advertised in the 401 challenge and Protected Resource Metadata; no wildcards transport (optional) — defaults to \"http_streamable\" (\"http_sse\" is deprecated in MCP 2026-07-28) auth_mode (optional) — defaults to \"oauth\" token_lifetime (optional, default 3600) — 60..86400, else 422 tool_authorizer_client_ids (optional) — the MCP server\'s own OAuth clients that may call the per-tool authorization endpoint allowed_client_ids (optional) — array of this organization\'s OAuth client ids; unknown ids are a 422 (never persisted as policy) require_pkce (optional, default true) require_resource_param (optional, default true) require_dpop (optional, default false) — RFC 9449 sender-constrained tokens only
106
106
  * @summary Register an MCP server
107
107
  * @param {AdminMcpApiAdminMcpServersCreateRequest} requestParameters Request parameters.
108
108
  * @param {*} [options] Override http request option.
@@ -141,7 +141,7 @@ export declare const AdminMcpApiFactory: (configuration?: Configuration, basePat
141
141
  */
142
142
  export interface AdminMcpApiInterface {
143
143
  /**
144
- * Body: name (required) — display name resource_uri (required) — RFC 8707 canonical URI; must be http(s)://, no fragment endpoint_url (optional) — actual MCP endpoint description (optional) scopes_supported (optional) — array OR space/comma-separated string transport (optional) — defaults to \"http_streamable\" auth_mode (optional) — defaults to \"oauth\" token_lifetime (optional, default 3600) — clamped to [60, 86400] allowed_client_ids (optional) — array of this organization\'s OAuth client ids; unknown ids are a 422 (never persisted as policy) require_pkce (optional, default true) require_resource_param (optional, default true) require_dpop (optional, default false) — RFC 9449 sender-constrained tokens only
144
+ * Body: name (required) — display name resource_uri (required) — RFC 8707 canonical URI: https:// (http:// only for loopback), no fragment, no user info, not a LumoAuth host, unique per organization after normalisation (same rules as the portal) endpoint_url (optional) — actual MCP endpoint description (optional) scopes_supported (optional) — array OR space/comma-separated string; omnibus scopes, offline_access and admin/scim scopes are refused (422) basic_scopes (optional) — subset of scopes_supported advertised in the 401 challenge and Protected Resource Metadata; no wildcards transport (optional) — defaults to \"http_streamable\" (\"http_sse\" is deprecated in MCP 2026-07-28) auth_mode (optional) — defaults to \"oauth\" token_lifetime (optional, default 3600) — 60..86400, else 422 tool_authorizer_client_ids (optional) — the MCP server\'s own OAuth clients that may call the per-tool authorization endpoint allowed_client_ids (optional) — array of this organization\'s OAuth client ids; unknown ids are a 422 (never persisted as policy) require_pkce (optional, default true) require_resource_param (optional, default true) require_dpop (optional, default false) — RFC 9449 sender-constrained tokens only
145
145
  * @summary Register an MCP server
146
146
  * @param {AdminMcpApiAdminMcpServersCreateRequest} requestParameters Request parameters.
147
147
  * @param {*} [options] Override http request option.
@@ -249,7 +249,7 @@ export interface AdminMcpApiAdminMcpServersListRequest {
249
249
  */
250
250
  export declare class AdminMcpApi extends BaseAPI implements AdminMcpApiInterface {
251
251
  /**
252
- * Body: name (required) — display name resource_uri (required) — RFC 8707 canonical URI; must be http(s)://, no fragment endpoint_url (optional) — actual MCP endpoint description (optional) scopes_supported (optional) — array OR space/comma-separated string transport (optional) — defaults to \"http_streamable\" auth_mode (optional) — defaults to \"oauth\" token_lifetime (optional, default 3600) — clamped to [60, 86400] allowed_client_ids (optional) — array of this organization\'s OAuth client ids; unknown ids are a 422 (never persisted as policy) require_pkce (optional, default true) require_resource_param (optional, default true) require_dpop (optional, default false) — RFC 9449 sender-constrained tokens only
252
+ * Body: name (required) — display name resource_uri (required) — RFC 8707 canonical URI: https:// (http:// only for loopback), no fragment, no user info, not a LumoAuth host, unique per organization after normalisation (same rules as the portal) endpoint_url (optional) — actual MCP endpoint description (optional) scopes_supported (optional) — array OR space/comma-separated string; omnibus scopes, offline_access and admin/scim scopes are refused (422) basic_scopes (optional) — subset of scopes_supported advertised in the 401 challenge and Protected Resource Metadata; no wildcards transport (optional) — defaults to \"http_streamable\" (\"http_sse\" is deprecated in MCP 2026-07-28) auth_mode (optional) — defaults to \"oauth\" token_lifetime (optional, default 3600) — 60..86400, else 422 tool_authorizer_client_ids (optional) — the MCP server\'s own OAuth clients that may call the per-tool authorization endpoint allowed_client_ids (optional) — array of this organization\'s OAuth client ids; unknown ids are a 422 (never persisted as policy) require_pkce (optional, default true) require_resource_param (optional, default true) require_dpop (optional, default false) — RFC 9449 sender-constrained tokens only
253
253
  * @summary Register an MCP server
254
254
  * @param {AdminMcpApiAdminMcpServersCreateRequest} requestParameters Request parameters.
255
255
  * @param {*} [options] Override http request option.
@@ -33,7 +33,7 @@ import { BASE_PATH, BaseAPI, operationServerMap } from '../base';
33
33
  export const AdminMcpApiAxiosParamCreator = function (configuration) {
34
34
  return {
35
35
  /**
36
- * Body: name (required) — display name resource_uri (required) — RFC 8707 canonical URI; must be http(s)://, no fragment endpoint_url (optional) — actual MCP endpoint description (optional) scopes_supported (optional) — array OR space/comma-separated string transport (optional) — defaults to \"http_streamable\" auth_mode (optional) — defaults to \"oauth\" token_lifetime (optional, default 3600) — clamped to [60, 86400] allowed_client_ids (optional) — array of this organization\'s OAuth client ids; unknown ids are a 422 (never persisted as policy) require_pkce (optional, default true) require_resource_param (optional, default true) require_dpop (optional, default false) — RFC 9449 sender-constrained tokens only
36
+ * Body: name (required) — display name resource_uri (required) — RFC 8707 canonical URI: https:// (http:// only for loopback), no fragment, no user info, not a LumoAuth host, unique per organization after normalisation (same rules as the portal) endpoint_url (optional) — actual MCP endpoint description (optional) scopes_supported (optional) — array OR space/comma-separated string; omnibus scopes, offline_access and admin/scim scopes are refused (422) basic_scopes (optional) — subset of scopes_supported advertised in the 401 challenge and Protected Resource Metadata; no wildcards transport (optional) — defaults to \"http_streamable\" (\"http_sse\" is deprecated in MCP 2026-07-28) auth_mode (optional) — defaults to \"oauth\" token_lifetime (optional, default 3600) — 60..86400, else 422 tool_authorizer_client_ids (optional) — the MCP server\'s own OAuth clients that may call the per-tool authorization endpoint allowed_client_ids (optional) — array of this organization\'s OAuth client ids; unknown ids are a 422 (never persisted as policy) require_pkce (optional, default true) require_resource_param (optional, default true) require_dpop (optional, default false) — RFC 9449 sender-constrained tokens only
37
37
  * @summary Register an MCP server
38
38
  * @param {string} orgId
39
39
  * @param {*} [options] Override http request option.
@@ -186,7 +186,7 @@ export const AdminMcpApiFp = function (configuration) {
186
186
  const localVarAxiosParamCreator = AdminMcpApiAxiosParamCreator(configuration);
187
187
  return {
188
188
  /**
189
- * Body: name (required) — display name resource_uri (required) — RFC 8707 canonical URI; must be http(s)://, no fragment endpoint_url (optional) — actual MCP endpoint description (optional) scopes_supported (optional) — array OR space/comma-separated string transport (optional) — defaults to \"http_streamable\" auth_mode (optional) — defaults to \"oauth\" token_lifetime (optional, default 3600) — clamped to [60, 86400] allowed_client_ids (optional) — array of this organization\'s OAuth client ids; unknown ids are a 422 (never persisted as policy) require_pkce (optional, default true) require_resource_param (optional, default true) require_dpop (optional, default false) — RFC 9449 sender-constrained tokens only
189
+ * Body: name (required) — display name resource_uri (required) — RFC 8707 canonical URI: https:// (http:// only for loopback), no fragment, no user info, not a LumoAuth host, unique per organization after normalisation (same rules as the portal) endpoint_url (optional) — actual MCP endpoint description (optional) scopes_supported (optional) — array OR space/comma-separated string; omnibus scopes, offline_access and admin/scim scopes are refused (422) basic_scopes (optional) — subset of scopes_supported advertised in the 401 challenge and Protected Resource Metadata; no wildcards transport (optional) — defaults to \"http_streamable\" (\"http_sse\" is deprecated in MCP 2026-07-28) auth_mode (optional) — defaults to \"oauth\" token_lifetime (optional, default 3600) — 60..86400, else 422 tool_authorizer_client_ids (optional) — the MCP server\'s own OAuth clients that may call the per-tool authorization endpoint allowed_client_ids (optional) — array of this organization\'s OAuth client ids; unknown ids are a 422 (never persisted as policy) require_pkce (optional, default true) require_resource_param (optional, default true) require_dpop (optional, default false) — RFC 9449 sender-constrained tokens only
190
190
  * @summary Register an MCP server
191
191
  * @param {string} orgId
192
192
  * @param {*} [options] Override http request option.
@@ -261,7 +261,7 @@ export const AdminMcpApiFactory = function (configuration, basePath, axios) {
261
261
  const localVarFp = AdminMcpApiFp(configuration);
262
262
  return {
263
263
  /**
264
- * Body: name (required) — display name resource_uri (required) — RFC 8707 canonical URI; must be http(s)://, no fragment endpoint_url (optional) — actual MCP endpoint description (optional) scopes_supported (optional) — array OR space/comma-separated string transport (optional) — defaults to \"http_streamable\" auth_mode (optional) — defaults to \"oauth\" token_lifetime (optional, default 3600) — clamped to [60, 86400] allowed_client_ids (optional) — array of this organization\'s OAuth client ids; unknown ids are a 422 (never persisted as policy) require_pkce (optional, default true) require_resource_param (optional, default true) require_dpop (optional, default false) — RFC 9449 sender-constrained tokens only
264
+ * Body: name (required) — display name resource_uri (required) — RFC 8707 canonical URI: https:// (http:// only for loopback), no fragment, no user info, not a LumoAuth host, unique per organization after normalisation (same rules as the portal) endpoint_url (optional) — actual MCP endpoint description (optional) scopes_supported (optional) — array OR space/comma-separated string; omnibus scopes, offline_access and admin/scim scopes are refused (422) basic_scopes (optional) — subset of scopes_supported advertised in the 401 challenge and Protected Resource Metadata; no wildcards transport (optional) — defaults to \"http_streamable\" (\"http_sse\" is deprecated in MCP 2026-07-28) auth_mode (optional) — defaults to \"oauth\" token_lifetime (optional, default 3600) — 60..86400, else 422 tool_authorizer_client_ids (optional) — the MCP server\'s own OAuth clients that may call the per-tool authorization endpoint allowed_client_ids (optional) — array of this organization\'s OAuth client ids; unknown ids are a 422 (never persisted as policy) require_pkce (optional, default true) require_resource_param (optional, default true) require_dpop (optional, default false) — RFC 9449 sender-constrained tokens only
265
265
  * @summary Register an MCP server
266
266
  * @param {AdminMcpApiAdminMcpServersCreateRequest} requestParameters Request parameters.
267
267
  * @param {*} [options] Override http request option.
@@ -310,7 +310,7 @@ export const AdminMcpApiFactory = function (configuration, basePath, axios) {
310
310
  */
311
311
  export class AdminMcpApi extends BaseAPI {
312
312
  /**
313
- * Body: name (required) — display name resource_uri (required) — RFC 8707 canonical URI; must be http(s)://, no fragment endpoint_url (optional) — actual MCP endpoint description (optional) scopes_supported (optional) — array OR space/comma-separated string transport (optional) — defaults to \"http_streamable\" auth_mode (optional) — defaults to \"oauth\" token_lifetime (optional, default 3600) — clamped to [60, 86400] allowed_client_ids (optional) — array of this organization\'s OAuth client ids; unknown ids are a 422 (never persisted as policy) require_pkce (optional, default true) require_resource_param (optional, default true) require_dpop (optional, default false) — RFC 9449 sender-constrained tokens only
313
+ * Body: name (required) — display name resource_uri (required) — RFC 8707 canonical URI: https:// (http:// only for loopback), no fragment, no user info, not a LumoAuth host, unique per organization after normalisation (same rules as the portal) endpoint_url (optional) — actual MCP endpoint description (optional) scopes_supported (optional) — array OR space/comma-separated string; omnibus scopes, offline_access and admin/scim scopes are refused (422) basic_scopes (optional) — subset of scopes_supported advertised in the 401 challenge and Protected Resource Metadata; no wildcards transport (optional) — defaults to \"http_streamable\" (\"http_sse\" is deprecated in MCP 2026-07-28) auth_mode (optional) — defaults to \"oauth\" token_lifetime (optional, default 3600) — 60..86400, else 422 tool_authorizer_client_ids (optional) — the MCP server\'s own OAuth clients that may call the per-tool authorization endpoint allowed_client_ids (optional) — array of this organization\'s OAuth client ids; unknown ids are a 422 (never persisted as policy) require_pkce (optional, default true) require_resource_param (optional, default true) require_dpop (optional, default false) — RFC 9449 sender-constrained tokens only
314
314
  * @summary Register an MCP server
315
315
  * @param {AdminMcpApiAdminMcpServersCreateRequest} requestParameters Request parameters.
316
316
  * @param {*} [options] Override http request option.
@@ -50,7 +50,7 @@ export declare const AgentsApiAxiosParamCreator: (configuration?: Configuration)
50
50
  */
51
51
  attest: (orgId: string, agentId: string, attestRequest: AttestRequest, options?: RawAxiosRequestConfig) => Promise<RequestArgs>;
52
52
  /**
53
- * The real request-path caller of {@see \\McpToolAuthorizationService::canInvoke()} — the piece that connects MCP authorization to agent identity. An MCP gateway/server asks \"may THIS agent invoke <server>/<tool>?\" and gets a Zanzibar-backed allow/deny (tool-level or server-wide grant). Denials and grants are both audited, closing the MCP-authorization audit blind spot. POST /orgs/{orgId}/api/v1/agents/me/mcp/authorize Body: { \"server_id\": \"invoices\", \"tool\": \"send_payment_reminder\" }
53
+ * An AGENT asks about itself: \"may I invoke <server>/<tool>?\" — with its own credential, before it calls the tool. Zanzibar-backed allow/deny (tool-level or server-wide grant), audited either way. An MCP SERVER must not use this endpoint: it would have to forward the agent\'s token (MCP 2026-07-28 forbids token passthrough). Servers call POST /orgs/{orgId}/api/v1/mcp/servers/{serverId}/tools/authorize with their own client-credentials token instead ({@see \\McpAuthorizationController::authorizeTool()}). POST /orgs/{orgId}/api/v1/agents/me/mcp/authorize Body: { \"server_id\": \"mcp_0123…\", \"tool\": \"send_payment_reminder\" }
54
54
  * @summary Per-MCP-tool authorization for the authenticated agent (dx B3).
55
55
  * @param {string} orgId
56
56
  * @param {AuthorizeMcpRequest} authorizeMcpRequest
@@ -136,7 +136,7 @@ export declare const AgentsApiFp: (configuration?: Configuration) => {
136
136
  */
137
137
  attest(orgId: string, agentId: string, attestRequest: AttestRequest, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<AttestResponse>>;
138
138
  /**
139
- * The real request-path caller of {@see \\McpToolAuthorizationService::canInvoke()} — the piece that connects MCP authorization to agent identity. An MCP gateway/server asks \"may THIS agent invoke <server>/<tool>?\" and gets a Zanzibar-backed allow/deny (tool-level or server-wide grant). Denials and grants are both audited, closing the MCP-authorization audit blind spot. POST /orgs/{orgId}/api/v1/agents/me/mcp/authorize Body: { \"server_id\": \"invoices\", \"tool\": \"send_payment_reminder\" }
139
+ * An AGENT asks about itself: \"may I invoke <server>/<tool>?\" — with its own credential, before it calls the tool. Zanzibar-backed allow/deny (tool-level or server-wide grant), audited either way. An MCP SERVER must not use this endpoint: it would have to forward the agent\'s token (MCP 2026-07-28 forbids token passthrough). Servers call POST /orgs/{orgId}/api/v1/mcp/servers/{serverId}/tools/authorize with their own client-credentials token instead ({@see \\McpAuthorizationController::authorizeTool()}). POST /orgs/{orgId}/api/v1/agents/me/mcp/authorize Body: { \"server_id\": \"mcp_0123…\", \"tool\": \"send_payment_reminder\" }
140
140
  * @summary Per-MCP-tool authorization for the authenticated agent (dx B3).
141
141
  * @param {string} orgId
142
142
  * @param {AuthorizeMcpRequest} authorizeMcpRequest
@@ -219,7 +219,7 @@ export declare const AgentsApiFactory: (configuration?: Configuration, basePath?
219
219
  */
220
220
  attest(requestParameters: AgentsApiAttestRequest, options?: RawAxiosRequestConfig): AxiosPromise<AttestResponse>;
221
221
  /**
222
- * The real request-path caller of {@see \\McpToolAuthorizationService::canInvoke()} — the piece that connects MCP authorization to agent identity. An MCP gateway/server asks \"may THIS agent invoke <server>/<tool>?\" and gets a Zanzibar-backed allow/deny (tool-level or server-wide grant). Denials and grants are both audited, closing the MCP-authorization audit blind spot. POST /orgs/{orgId}/api/v1/agents/me/mcp/authorize Body: { \"server_id\": \"invoices\", \"tool\": \"send_payment_reminder\" }
222
+ * An AGENT asks about itself: \"may I invoke <server>/<tool>?\" — with its own credential, before it calls the tool. Zanzibar-backed allow/deny (tool-level or server-wide grant), audited either way. An MCP SERVER must not use this endpoint: it would have to forward the agent\'s token (MCP 2026-07-28 forbids token passthrough). Servers call POST /orgs/{orgId}/api/v1/mcp/servers/{serverId}/tools/authorize with their own client-credentials token instead ({@see \\McpAuthorizationController::authorizeTool()}). POST /orgs/{orgId}/api/v1/agents/me/mcp/authorize Body: { \"server_id\": \"mcp_0123…\", \"tool\": \"send_payment_reminder\" }
223
223
  * @summary Per-MCP-tool authorization for the authenticated agent (dx B3).
224
224
  * @param {AgentsApiAuthorizeMcpRequest} requestParameters Request parameters.
225
225
  * @param {*} [options] Override http request option.
@@ -298,7 +298,7 @@ export interface AgentsApiInterface {
298
298
  */
299
299
  attest(requestParameters: AgentsApiAttestRequest, options?: RawAxiosRequestConfig): AxiosPromise<AttestResponse>;
300
300
  /**
301
- * The real request-path caller of {@see \\McpToolAuthorizationService::canInvoke()} — the piece that connects MCP authorization to agent identity. An MCP gateway/server asks \"may THIS agent invoke <server>/<tool>?\" and gets a Zanzibar-backed allow/deny (tool-level or server-wide grant). Denials and grants are both audited, closing the MCP-authorization audit blind spot. POST /orgs/{orgId}/api/v1/agents/me/mcp/authorize Body: { \"server_id\": \"invoices\", \"tool\": \"send_payment_reminder\" }
301
+ * An AGENT asks about itself: \"may I invoke <server>/<tool>?\" — with its own credential, before it calls the tool. Zanzibar-backed allow/deny (tool-level or server-wide grant), audited either way. An MCP SERVER must not use this endpoint: it would have to forward the agent\'s token (MCP 2026-07-28 forbids token passthrough). Servers call POST /orgs/{orgId}/api/v1/mcp/servers/{serverId}/tools/authorize with their own client-credentials token instead ({@see \\McpAuthorizationController::authorizeTool()}). POST /orgs/{orgId}/api/v1/agents/me/mcp/authorize Body: { \"server_id\": \"mcp_0123…\", \"tool\": \"send_payment_reminder\" }
302
302
  * @summary Per-MCP-tool authorization for the authenticated agent (dx B3).
303
303
  * @param {AgentsApiAuthorizeMcpRequest} requestParameters Request parameters.
304
304
  * @param {*} [options] Override http request option.
@@ -552,7 +552,7 @@ export declare class AgentsApi extends BaseAPI implements AgentsApiInterface {
552
552
  */
553
553
  attest(requestParameters: AgentsApiAttestRequest, options?: RawAxiosRequestConfig): Promise<import("axios").AxiosResponse<AttestResponse, any, {}>>;
554
554
  /**
555
- * The real request-path caller of {@see \\McpToolAuthorizationService::canInvoke()} — the piece that connects MCP authorization to agent identity. An MCP gateway/server asks \"may THIS agent invoke <server>/<tool>?\" and gets a Zanzibar-backed allow/deny (tool-level or server-wide grant). Denials and grants are both audited, closing the MCP-authorization audit blind spot. POST /orgs/{orgId}/api/v1/agents/me/mcp/authorize Body: { \"server_id\": \"invoices\", \"tool\": \"send_payment_reminder\" }
555
+ * An AGENT asks about itself: \"may I invoke <server>/<tool>?\" — with its own credential, before it calls the tool. Zanzibar-backed allow/deny (tool-level or server-wide grant), audited either way. An MCP SERVER must not use this endpoint: it would have to forward the agent\'s token (MCP 2026-07-28 forbids token passthrough). Servers call POST /orgs/{orgId}/api/v1/mcp/servers/{serverId}/tools/authorize with their own client-credentials token instead ({@see \\McpAuthorizationController::authorizeTool()}). POST /orgs/{orgId}/api/v1/agents/me/mcp/authorize Body: { \"server_id\": \"mcp_0123…\", \"tool\": \"send_payment_reminder\" }
556
556
  * @summary Per-MCP-tool authorization for the authenticated agent (dx B3).
557
557
  * @param {AgentsApiAuthorizeMcpRequest} requestParameters Request parameters.
558
558
  * @param {*} [options] Override http request option.
@@ -115,7 +115,7 @@ export const AgentsApiAxiosParamCreator = function (configuration) {
115
115
  };
116
116
  }),
117
117
  /**
118
- * The real request-path caller of {@see \\McpToolAuthorizationService::canInvoke()} — the piece that connects MCP authorization to agent identity. An MCP gateway/server asks \"may THIS agent invoke <server>/<tool>?\" and gets a Zanzibar-backed allow/deny (tool-level or server-wide grant). Denials and grants are both audited, closing the MCP-authorization audit blind spot. POST /orgs/{orgId}/api/v1/agents/me/mcp/authorize Body: { \"server_id\": \"invoices\", \"tool\": \"send_payment_reminder\" }
118
+ * An AGENT asks about itself: \"may I invoke <server>/<tool>?\" — with its own credential, before it calls the tool. Zanzibar-backed allow/deny (tool-level or server-wide grant), audited either way. An MCP SERVER must not use this endpoint: it would have to forward the agent\'s token (MCP 2026-07-28 forbids token passthrough). Servers call POST /orgs/{orgId}/api/v1/mcp/servers/{serverId}/tools/authorize with their own client-credentials token instead ({@see \\McpAuthorizationController::authorizeTool()}). POST /orgs/{orgId}/api/v1/agents/me/mcp/authorize Body: { \"server_id\": \"mcp_0123…\", \"tool\": \"send_payment_reminder\" }
119
119
  * @summary Per-MCP-tool authorization for the authenticated agent (dx B3).
120
120
  * @param {string} orgId
121
121
  * @param {AuthorizeMcpRequest} authorizeMcpRequest
@@ -413,7 +413,7 @@ export const AgentsApiFp = function (configuration) {
413
413
  });
414
414
  },
415
415
  /**
416
- * The real request-path caller of {@see \\McpToolAuthorizationService::canInvoke()} — the piece that connects MCP authorization to agent identity. An MCP gateway/server asks \"may THIS agent invoke <server>/<tool>?\" and gets a Zanzibar-backed allow/deny (tool-level or server-wide grant). Denials and grants are both audited, closing the MCP-authorization audit blind spot. POST /orgs/{orgId}/api/v1/agents/me/mcp/authorize Body: { \"server_id\": \"invoices\", \"tool\": \"send_payment_reminder\" }
416
+ * An AGENT asks about itself: \"may I invoke <server>/<tool>?\" — with its own credential, before it calls the tool. Zanzibar-backed allow/deny (tool-level or server-wide grant), audited either way. An MCP SERVER must not use this endpoint: it would have to forward the agent\'s token (MCP 2026-07-28 forbids token passthrough). Servers call POST /orgs/{orgId}/api/v1/mcp/servers/{serverId}/tools/authorize with their own client-credentials token instead ({@see \\McpAuthorizationController::authorizeTool()}). POST /orgs/{orgId}/api/v1/agents/me/mcp/authorize Body: { \"server_id\": \"mcp_0123…\", \"tool\": \"send_payment_reminder\" }
417
417
  * @summary Per-MCP-tool authorization for the authenticated agent (dx B3).
418
418
  * @param {string} orgId
419
419
  * @param {AuthorizeMcpRequest} authorizeMcpRequest
@@ -557,7 +557,7 @@ export const AgentsApiFactory = function (configuration, basePath, axios) {
557
557
  return localVarFp.attest(requestParameters.orgId, requestParameters.agentId, requestParameters.attestRequest, options).then((request) => request(axios, basePath));
558
558
  },
559
559
  /**
560
- * The real request-path caller of {@see \\McpToolAuthorizationService::canInvoke()} — the piece that connects MCP authorization to agent identity. An MCP gateway/server asks \"may THIS agent invoke <server>/<tool>?\" and gets a Zanzibar-backed allow/deny (tool-level or server-wide grant). Denials and grants are both audited, closing the MCP-authorization audit blind spot. POST /orgs/{orgId}/api/v1/agents/me/mcp/authorize Body: { \"server_id\": \"invoices\", \"tool\": \"send_payment_reminder\" }
560
+ * An AGENT asks about itself: \"may I invoke <server>/<tool>?\" — with its own credential, before it calls the tool. Zanzibar-backed allow/deny (tool-level or server-wide grant), audited either way. An MCP SERVER must not use this endpoint: it would have to forward the agent\'s token (MCP 2026-07-28 forbids token passthrough). Servers call POST /orgs/{orgId}/api/v1/mcp/servers/{serverId}/tools/authorize with their own client-credentials token instead ({@see \\McpAuthorizationController::authorizeTool()}). POST /orgs/{orgId}/api/v1/agents/me/mcp/authorize Body: { \"server_id\": \"mcp_0123…\", \"tool\": \"send_payment_reminder\" }
561
561
  * @summary Per-MCP-tool authorization for the authenticated agent (dx B3).
562
562
  * @param {AgentsApiAuthorizeMcpRequest} requestParameters Request parameters.
563
563
  * @param {*} [options] Override http request option.
@@ -656,7 +656,7 @@ export class AgentsApi extends BaseAPI {
656
656
  return AgentsApiFp(this.configuration).attest(requestParameters.orgId, requestParameters.agentId, requestParameters.attestRequest, options).then((request) => request(this.axios, this.basePath));
657
657
  }
658
658
  /**
659
- * The real request-path caller of {@see \\McpToolAuthorizationService::canInvoke()} — the piece that connects MCP authorization to agent identity. An MCP gateway/server asks \"may THIS agent invoke <server>/<tool>?\" and gets a Zanzibar-backed allow/deny (tool-level or server-wide grant). Denials and grants are both audited, closing the MCP-authorization audit blind spot. POST /orgs/{orgId}/api/v1/agents/me/mcp/authorize Body: { \"server_id\": \"invoices\", \"tool\": \"send_payment_reminder\" }
659
+ * An AGENT asks about itself: \"may I invoke <server>/<tool>?\" — with its own credential, before it calls the tool. Zanzibar-backed allow/deny (tool-level or server-wide grant), audited either way. An MCP SERVER must not use this endpoint: it would have to forward the agent\'s token (MCP 2026-07-28 forbids token passthrough). Servers call POST /orgs/{orgId}/api/v1/mcp/servers/{serverId}/tools/authorize with their own client-credentials token instead ({@see \\McpAuthorizationController::authorizeTool()}). POST /orgs/{orgId}/api/v1/agents/me/mcp/authorize Body: { \"server_id\": \"mcp_0123…\", \"tool\": \"send_payment_reminder\" }
660
660
  * @summary Per-MCP-tool authorization for the authenticated agent (dx B3).
661
661
  * @param {AgentsApiAuthorizeMcpRequest} requestParameters Request parameters.
662
662
  * @param {*} [options] Override http request option.
@@ -16,6 +16,8 @@ import type { GetProtectedResourceMetadataRoot200Response } from '../models';
16
16
  import type { GetServerChallengeResponse } from '../models';
17
17
  import type { GetServerResponse } from '../models';
18
18
  import type { ListServersResponse } from '../models';
19
+ import type { McpServerToolAuthorizeRequest } from '../models';
20
+ import type { McpServerToolAuthorizeResponse } from '../models';
19
21
  import type { ProtectedResourceMetadata } from '../models';
20
22
  /**
21
23
  * McpApi - axios parameter creator
@@ -65,6 +67,16 @@ export declare const McpApiAxiosParamCreator: (configuration?: Configuration) =>
65
67
  * @throws {RequiredError}
66
68
  */
67
69
  listServers: (orgId: string, options?: RawAxiosRequestConfig) => Promise<RequestArgs>;
70
+ /**
71
+ * 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.
72
+ * @summary Per-tool authorization for an MCP server (server credential)
73
+ * @param {string} orgId
74
+ * @param {string} serverId
75
+ * @param {McpServerToolAuthorizeRequest} mcpServerToolAuthorizeRequest
76
+ * @param {*} [options] Override http request option.
77
+ * @throws {RequiredError}
78
+ */
79
+ mcpServerToolAuthorize: (orgId: string, serverId: string, mcpServerToolAuthorizeRequest: McpServerToolAuthorizeRequest, options?: RawAxiosRequestConfig) => Promise<RequestArgs>;
68
80
  /**
69
81
  * Identical to GET; the HTTP method is only recorded in the audit trail.
70
82
  * @summary Simulated MCP server authorization challenge (POST)
@@ -123,6 +135,16 @@ export declare const McpApiFp: (configuration?: Configuration) => {
123
135
  * @throws {RequiredError}
124
136
  */
125
137
  listServers(orgId: string, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<ListServersResponse>>;
138
+ /**
139
+ * 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.
140
+ * @summary Per-tool authorization for an MCP server (server credential)
141
+ * @param {string} orgId
142
+ * @param {string} serverId
143
+ * @param {McpServerToolAuthorizeRequest} mcpServerToolAuthorizeRequest
144
+ * @param {*} [options] Override http request option.
145
+ * @throws {RequiredError}
146
+ */
147
+ mcpServerToolAuthorize(orgId: string, serverId: string, mcpServerToolAuthorizeRequest: McpServerToolAuthorizeRequest, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<McpServerToolAuthorizeResponse>>;
126
148
  /**
127
149
  * Identical to GET; the HTTP method is only recorded in the audit trail.
128
150
  * @summary Simulated MCP server authorization challenge (POST)
@@ -178,6 +200,14 @@ export declare const McpApiFactory: (configuration?: Configuration, basePath?: s
178
200
  * @throws {RequiredError}
179
201
  */
180
202
  listServers(requestParameters: McpApiListServersRequest, options?: RawAxiosRequestConfig): AxiosPromise<ListServersResponse>;
203
+ /**
204
+ * 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.
205
+ * @summary Per-tool authorization for an MCP server (server credential)
206
+ * @param {McpApiMcpServerToolAuthorizeRequest} requestParameters Request parameters.
207
+ * @param {*} [options] Override http request option.
208
+ * @throws {RequiredError}
209
+ */
210
+ mcpServerToolAuthorize(requestParameters: McpApiMcpServerToolAuthorizeRequest, options?: RawAxiosRequestConfig): AxiosPromise<McpServerToolAuthorizeResponse>;
181
211
  /**
182
212
  * Identical to GET; the HTTP method is only recorded in the audit trail.
183
213
  * @summary Simulated MCP server authorization challenge (POST)
@@ -238,6 +268,15 @@ export interface McpApiInterface {
238
268
  * @memberof McpApiInterface
239
269
  */
240
270
  listServers(requestParameters: McpApiListServersRequest, options?: RawAxiosRequestConfig): AxiosPromise<ListServersResponse>;
271
+ /**
272
+ * 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.
273
+ * @summary Per-tool authorization for an MCP server (server credential)
274
+ * @param {McpApiMcpServerToolAuthorizeRequest} requestParameters Request parameters.
275
+ * @param {*} [options] Override http request option.
276
+ * @throws {RequiredError}
277
+ * @memberof McpApiInterface
278
+ */
279
+ mcpServerToolAuthorize(requestParameters: McpApiMcpServerToolAuthorizeRequest, options?: RawAxiosRequestConfig): AxiosPromise<McpServerToolAuthorizeResponse>;
241
280
  /**
242
281
  * Identical to GET; the HTTP method is only recorded in the audit trail.
243
282
  * @summary Simulated MCP server authorization challenge (POST)
@@ -331,6 +370,31 @@ export interface McpApiListServersRequest {
331
370
  */
332
371
  readonly orgId: string;
333
372
  }
373
+ /**
374
+ * Request parameters for mcpServerToolAuthorize operation in McpApi.
375
+ * @export
376
+ * @interface McpApiMcpServerToolAuthorizeRequest
377
+ */
378
+ export interface McpApiMcpServerToolAuthorizeRequest {
379
+ /**
380
+ *
381
+ * @type {string}
382
+ * @memberof McpApiMcpServerToolAuthorize
383
+ */
384
+ readonly orgId: string;
385
+ /**
386
+ *
387
+ * @type {string}
388
+ * @memberof McpApiMcpServerToolAuthorize
389
+ */
390
+ readonly serverId: string;
391
+ /**
392
+ *
393
+ * @type {McpServerToolAuthorizeRequest}
394
+ * @memberof McpApiMcpServerToolAuthorize
395
+ */
396
+ readonly mcpServerToolAuthorizeRequest: McpServerToolAuthorizeRequest;
397
+ }
334
398
  /**
335
399
  * Request parameters for postServerChallenge operation in McpApi.
336
400
  * @export
@@ -402,6 +466,15 @@ export declare class McpApi extends BaseAPI implements McpApiInterface {
402
466
  * @memberof McpApi
403
467
  */
404
468
  listServers(requestParameters: McpApiListServersRequest, options?: RawAxiosRequestConfig): Promise<import("axios").AxiosResponse<ListServersResponse, any, {}>>;
469
+ /**
470
+ * 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.
471
+ * @summary Per-tool authorization for an MCP server (server credential)
472
+ * @param {McpApiMcpServerToolAuthorizeRequest} requestParameters Request parameters.
473
+ * @param {*} [options] Override http request option.
474
+ * @throws {RequiredError}
475
+ * @memberof McpApi
476
+ */
477
+ mcpServerToolAuthorize(requestParameters: McpApiMcpServerToolAuthorizeRequest, options?: RawAxiosRequestConfig): Promise<import("axios").AxiosResponse<McpServerToolAuthorizeResponse, any, {}>>;
405
478
  /**
406
479
  * Identical to GET; the HTTP method is only recorded in the audit trail.
407
480
  * @summary Simulated MCP server authorization challenge (POST)