Class: AIGatewayMcpIntegrationsClient

Defined in: src/ai-gateway/mcp-integrations-client.ts:41

Client for AI Gateway MCP server integrations (admin plane).

Constructors

Constructor

new AIGatewayMcpIntegrationsClient(opts): AIGatewayMcpIntegrationsClient;

Defined in: src/ai-gateway/mcp-integrations-client.ts:46

Parameters

Parameter	Type
`opts`	`AIGatewaySubClientOptions`

Returns

AIGatewayMcpIntegrationsClient

Methods

getWorkspaces()

getWorkspaces(mcpIntegrationId, opts?): Promise<
  | {
[key: string]: unknown;
  data?: {
   [key: string]: unknown;
     id?: string;
     enabled?: boolean;
     status?: string;
     created_at?: string;
     last_updated_at?: string;
  }[];
  global_workspace_access?:   | {
   [key: string]: unknown;
   }
     | null;
  total?: number;
}
  | {
[key: string]: unknown;
  workspaces?: {
   [key: string]: unknown;
     id?: string;
     enabled?: boolean;
     status?: string;
     created_at?: string;
     last_updated_at?: string;
  }[];
  global_workspace_access?:   | {
   [key: string]: unknown;
   }
     | null;
}>;

Defined in: src/ai-gateway/mcp-integrations-client.ts:53

List MCP integration workspace access; version selects the upstream envelope.

Parameters

Parameter	Type
`mcpIntegrationId`	`string`
`opts`	{ `version?`: `string`; }
`opts.version?`	`string`

Returns

Promise< | { [key: string]: unknown; data?: { [key: string]: unknown; id?: string; enabled?: boolean; status?: string; created_at?: string; last_updated_at?: string; }[]; global_workspace_access?: | { [key: string]: unknown; } | null; total?: number; } | { [key: string]: unknown; workspaces?: { [key: string]: unknown; id?: string; enabled?: boolean; status?: string; created_at?: string; last_updated_at?: string; }[]; global_workspace_access?: | { [key: string]: unknown; } | null; }>

Example

`await gw.mcpIntegrations.getWorkspaces(id, { version: '2' });`

list()

list(): Promise<objectOutputType<{
  object: ZodString;
  total: ZodNumber;
  success: ZodOptional<ZodBoolean>;
  has_more: ZodOptional<ZodBoolean>;
  data: ZodArray<ZodObject<{
     slug: ZodOptional<ZodString>;
     workspace_id: ZodOptional<ZodNullable<ZodString>>;
     description: ZodOptional<ZodNullable<ZodString>>;
     workspaces_count: ZodOptional<ZodNullable<ZodNumber>>;
     secret_mappings: ZodOptional<ZodNullable<ZodArray<ZodType<{
      [key: ...]: ...;
        target_field: ...;
        secret_reference_id: ...;
        secret_key?: ...;
        value_format?: ...;
      }, ZodTypeDef, {
      [key: ...]: ...;
        target_field: ...;
        secret_reference_id: ...;
        secret_key?: ...;
        value_format?: ...;
     }>, "many">>>;
     id: ZodString;
     organisation_id: ZodString;
     name: ZodString;
     owner_id: ZodString;
     status: ZodString;
     type: ZodString;
     url: ZodString;
     auth_type: ZodString;
     transport: ZodString;
     configurations: ZodString;
     created_at: ZodString;
     last_updated_at: ZodString;
   }, "passthrough", ZodTypeAny, objectOutputType<{
     slug: ZodOptional<ZodString>;
     workspace_id: ZodOptional<ZodNullable<ZodString>>;
     description: ZodOptional<ZodNullable<ZodString>>;
     workspaces_count: ZodOptional<ZodNullable<ZodNumber>>;
     secret_mappings: ZodOptional<ZodNullable<ZodArray<ZodType<..., ..., ...>, "many">>>;
     id: ZodString;
     organisation_id: ZodString;
     name: ZodString;
     owner_id: ZodString;
     status: ZodString;
     type: ZodString;
     url: ZodString;
     auth_type: ZodString;
     transport: ZodString;
     configurations: ZodString;
     created_at: ZodString;
     last_updated_at: ZodString;
   }, ZodTypeAny, "passthrough">, objectInputType<{
     slug: ZodOptional<ZodString>;
     workspace_id: ZodOptional<ZodNullable<ZodString>>;
     description: ZodOptional<ZodNullable<ZodString>>;
     workspaces_count: ZodOptional<ZodNullable<ZodNumber>>;
     secret_mappings: ZodOptional<ZodNullable<ZodArray<ZodType<..., ..., ...>, "many">>>;
     id: ZodString;
     organisation_id: ZodString;
     name: ZodString;
     owner_id: ZodString;
     status: ZodString;
     type: ZodString;
     url: ZodString;
     auth_type: ZodString;
     transport: ZodString;
     configurations: ZodString;
     created_at: ZodString;
     last_updated_at: ZodString;
  }, ZodTypeAny, "passthrough">>, "many">;
}, ZodTypeAny, "passthrough">>;

Defined in: src/ai-gateway/mcp-integrations-client.ts:86

List organisation MCP integrations.

Returns

Promise<objectOutputType<{ object: ZodString; total: ZodNumber; success: ZodOptional<ZodBoolean>; has_more: ZodOptional<ZodBoolean>; data: ZodArray<ZodObject<{ slug: ZodOptional<ZodString>; workspace_id: ZodOptional<ZodNullable<ZodString>>; description: ZodOptional<ZodNullable<ZodString>>; workspaces_count: ZodOptional<ZodNullable<ZodNumber>>; secret_mappings: ZodOptional<ZodNullable<ZodArray<ZodType<{ [key: ...]: ...; target_field: ...; secret_reference_id: ...; secret_key?: ...; value_format?: ...; }, ZodTypeDef, { [key: ...]: ...; target_field: ...; secret_reference_id: ...; secret_key?: ...; value_format?: ...; }>, "many">>>; id: ZodString; organisation_id: ZodString; name: ZodString; owner_id: ZodString; status: ZodString; type: ZodString; url: ZodString; auth_type: ZodString; transport: ZodString; configurations: ZodString; created_at: ZodString; last_updated_at: ZodString; }, "passthrough", ZodTypeAny, objectOutputType<{ slug: ZodOptional<ZodString>; workspace_id: ZodOptional<ZodNullable<ZodString>>; description: ZodOptional<ZodNullable<ZodString>>; workspaces_count: ZodOptional<ZodNullable<ZodNumber>>; secret_mappings: ZodOptional<ZodNullable<ZodArray<ZodType<..., ..., ...>, "many">>>; id: ZodString; organisation_id: ZodString; name: ZodString; owner_id: ZodString; status: ZodString; type: ZodString; url: ZodString; auth_type: ZodString; transport: ZodString; configurations: ZodString; created_at: ZodString; last_updated_at: ZodString; }, ZodTypeAny, "passthrough">, objectInputType<{ slug: ZodOptional<ZodString>; workspace_id: ZodOptional<ZodNullable<ZodString>>; description: ZodOptional<ZodNullable<ZodString>>; workspaces_count: ZodOptional<ZodNullable<ZodNumber>>; secret_mappings: ZodOptional<ZodNullable<ZodArray<ZodType<..., ..., ...>, "many">>>; id: ZodString; organisation_id: ZodString; name: ZodString; owner_id: ZodString; status: ZodString; type: ZodString; url: ZodString; auth_type: ZodString; transport: ZodString; configurations: ZodString; created_at: ZodString; last_updated_at: ZodString; }, ZodTypeAny, "passthrough">>, "many">; }, ZodTypeAny, "passthrough">>

All MCP server integrations defined on the organisation.

Example

import { AIGatewayClient } from '@cdot65/prisma-airs-sdk';
const gw = new AIGatewayClient();

const mcp = await gw.mcpIntegrations.list();
// mcp.data[0] => { name: 'Context 7', url: 'https://mcp.context7.com/mcp', transport: 'http', ... }

get()

get(mcpIntegrationId): Promise<objectOutputType<{
  id: ZodString;
  name: ZodString;
  description: ZodNullable<ZodString>;
  owner_id: ZodString;
  status: ZodString;
  created_at: ZodString;
  last_updated_at: ZodString;
  configurations: ZodType<{
   [key: string]: unknown;
     custom_headers?: {
      [key: string]: unknown;
     };
     passthrough_header?: {
      [key: string]: unknown;
     };
   }, ZodTypeDef, {
   [key: string]: unknown;
     custom_headers?: {
      [key: string]: unknown;
     };
     passthrough_header?: {
      [key: string]: unknown;
     };
  }>;
  global_workspace_access: ZodNullable<ZodObject<{
     enabled: ZodBoolean;
   }, "passthrough", ZodTypeAny, objectOutputType<{
     enabled: ZodBoolean;
   }, ZodTypeAny, "passthrough">, objectInputType<{
     enabled: ZodBoolean;
  }, ZodTypeAny, "passthrough">>>;
  workspace_id: ZodNullable<ZodString>;
  slug: ZodString;
  url: ZodString;
  auth_type: ZodString;
  transport: ZodString;
  type: ZodString;
  secret_mappings: ZodNullable<ZodArray<ZodType<{
   [key: string]: unknown;
     target_field: string;
     secret_reference_id: string;
     secret_key?: string | null;
     value_format?: string | null;
   }, ZodTypeDef, {
   [key: string]: unknown;
     target_field: string;
     secret_reference_id: string;
     secret_key?: string | null;
     value_format?: string | null;
  }>, "many">>;
  object: ZodString;
}, ZodTypeAny, "passthrough">>;

Defined in: src/ai-gateway/mcp-integrations-client.ts:109

Fetch one MCP integration. Verified live 2026-08-29.

Parameters

Parameter	Type	Description
`mcpIntegrationId`	`string`	MCP integration UUID.

Returns

Promise<objectOutputType<{ id: ZodString; name: ZodString; description: ZodNullable<ZodString>; owner_id: ZodString; status: ZodString; created_at: ZodString; last_updated_at: ZodString; configurations: ZodType<{ [key: string]: unknown; custom_headers?: { [key: string]: unknown; }; passthrough_header?: { [key: string]: unknown; }; }, ZodTypeDef, { [key: string]: unknown; custom_headers?: { [key: string]: unknown; }; passthrough_header?: { [key: string]: unknown; }; }>; global_workspace_access: ZodNullable<ZodObject<{ enabled: ZodBoolean; }, "passthrough", ZodTypeAny, objectOutputType<{ enabled: ZodBoolean; }, ZodTypeAny, "passthrough">, objectInputType<{ enabled: ZodBoolean; }, ZodTypeAny, "passthrough">>>; workspace_id: ZodNullable<ZodString>; slug: ZodString; url: ZodString; auth_type: ZodString; transport: ZodString; type: ZodString; secret_mappings: ZodNullable<ZodArray<ZodType<{ [key: string]: unknown; target_field: string; secret_reference_id: string; secret_key?: string | null; value_format?: string | null; }, ZodTypeDef, { [key: string]: unknown; target_field: string; secret_reference_id: string; secret_key?: string | null; value_format?: string | null; }>, "many">>; object: ZodString; }, ZodTypeAny, "passthrough">>

Integration detail; unlike list rows, configurations is an object.

Example

import { AIGatewayClient } from '@cdot65/prisma-airs-sdk';
const gw = new AIGatewayClient();
const integration = await gw.mcpIntegrations.get('2a6f4e2e-6f5a-4a1f-9d0e-9b2b6f6c3a11');
console.log(integration.url);

getCapabilities()

getCapabilities(mcpIntegrationId): Promise<objectOutputType<{
  object: ZodString;
  counts: ZodObject<{
     tools: ZodOptional<ZodObject<{
        total: ZodNumber;
        enabled: ZodNumber;
      }, "passthrough", ZodTypeAny, objectOutputType<{
        total: ZodNumber;
        enabled: ZodNumber;
      }, ZodTypeAny, "passthrough">, objectInputType<{
        total: ZodNumber;
        enabled: ZodNumber;
     }, ZodTypeAny, "passthrough">>>;
     prompts: ZodOptional<ZodObject<{
        total: ZodNumber;
        enabled: ZodNumber;
      }, "passthrough", ZodTypeAny, objectOutputType<{
        total: ZodNumber;
        enabled: ZodNumber;
      }, ZodTypeAny, "passthrough">, objectInputType<{
        total: ZodNumber;
        enabled: ZodNumber;
     }, ZodTypeAny, "passthrough">>>;
     resources: ZodOptional<ZodObject<{
        total: ZodNumber;
        enabled: ZodNumber;
      }, "passthrough", ZodTypeAny, objectOutputType<{
        total: ZodNumber;
        enabled: ZodNumber;
      }, ZodTypeAny, "passthrough">, objectInputType<{
        total: ZodNumber;
        enabled: ZodNumber;
     }, ZodTypeAny, "passthrough">>>;
     resource_templates: ZodOptional<ZodObject<{
        total: ZodNumber;
        enabled: ZodNumber;
      }, "passthrough", ZodTypeAny, objectOutputType<{
        total: ZodNumber;
        enabled: ZodNumber;
      }, ZodTypeAny, "passthrough">, objectInputType<{
        total: ZodNumber;
        enabled: ZodNumber;
     }, ZodTypeAny, "passthrough">>>;
   }, "passthrough", ZodTypeAny, objectOutputType<{
     tools: ZodOptional<ZodObject<{
        total: ZodNumber;
        enabled: ZodNumber;
      }, "passthrough", ZodTypeAny, objectOutputType<{
        total: ZodNumber;
        enabled: ZodNumber;
      }, ZodTypeAny, "passthrough">, objectInputType<{
        total: ZodNumber;
        enabled: ZodNumber;
     }, ZodTypeAny, "passthrough">>>;
     prompts: ZodOptional<ZodObject<{
        total: ZodNumber;
        enabled: ZodNumber;
      }, "passthrough", ZodTypeAny, objectOutputType<{
        total: ZodNumber;
        enabled: ZodNumber;
      }, ZodTypeAny, "passthrough">, objectInputType<{
        total: ZodNumber;
        enabled: ZodNumber;
     }, ZodTypeAny, "passthrough">>>;
     resources: ZodOptional<ZodObject<{
        total: ZodNumber;
        enabled: ZodNumber;
      }, "passthrough", ZodTypeAny, objectOutputType<{
        total: ZodNumber;
        enabled: ZodNumber;
      }, ZodTypeAny, "passthrough">, objectInputType<{
        total: ZodNumber;
        enabled: ZodNumber;
     }, ZodTypeAny, "passthrough">>>;
     resource_templates: ZodOptional<ZodObject<{
        total: ZodNumber;
        enabled: ZodNumber;
      }, "passthrough", ZodTypeAny, objectOutputType<{
        total: ZodNumber;
        enabled: ZodNumber;
      }, ZodTypeAny, "passthrough">, objectInputType<{
        total: ZodNumber;
        enabled: ZodNumber;
     }, ZodTypeAny, "passthrough">>>;
   }, ZodTypeAny, "passthrough">, objectInputType<{
     tools: ZodOptional<ZodObject<{
        total: ZodNumber;
        enabled: ZodNumber;
      }, "passthrough", ZodTypeAny, objectOutputType<{
        total: ZodNumber;
        enabled: ZodNumber;
      }, ZodTypeAny, "passthrough">, objectInputType<{
        total: ZodNumber;
        enabled: ZodNumber;
     }, ZodTypeAny, "passthrough">>>;
     prompts: ZodOptional<ZodObject<{
        total: ZodNumber;
        enabled: ZodNumber;
      }, "passthrough", ZodTypeAny, objectOutputType<{
        total: ZodNumber;
        enabled: ZodNumber;
      }, ZodTypeAny, "passthrough">, objectInputType<{
        total: ZodNumber;
        enabled: ZodNumber;
     }, ZodTypeAny, "passthrough">>>;
     resources: ZodOptional<ZodObject<{
        total: ZodNumber;
        enabled: ZodNumber;
      }, "passthrough", ZodTypeAny, objectOutputType<{
        total: ZodNumber;
        enabled: ZodNumber;
      }, ZodTypeAny, "passthrough">, objectInputType<{
        total: ZodNumber;
        enabled: ZodNumber;
     }, ZodTypeAny, "passthrough">>>;
     resource_templates: ZodOptional<ZodObject<{
        total: ZodNumber;
        enabled: ZodNumber;
      }, "passthrough", ZodTypeAny, objectOutputType<{
        total: ZodNumber;
        enabled: ZodNumber;
      }, ZodTypeAny, "passthrough">, objectInputType<{
        total: ZodNumber;
        enabled: ZodNumber;
     }, ZodTypeAny, "passthrough">>>;
  }, ZodTypeAny, "passthrough">>;
  total: ZodNumber;
  has_more: ZodBoolean;
  data: ZodArray<ZodObject<{
     name: ZodString;
     type: ZodString;
     title: ZodNullable<ZodString>;
     description: ZodNullable<ZodString>;
     icons: ZodNullable<ZodArray<ZodUnknown, "many">>;
     enabled: ZodBoolean;
     created_at: ZodString;
     last_updated_at: ZodString;
     input_schema: ZodNullable<ZodRecord<ZodString, ZodUnknown>>;
     output_schema: ZodNullable<ZodRecord<ZodString, ZodUnknown>>;
     execution: ZodNullable<ZodRecord<ZodString, ZodUnknown>>;
     arguments: ZodOptional<ZodNullable<ZodArray<ZodUnknown, "many">>>;
     uri: ZodOptional<ZodNullable<ZodString>>;
     uri_template: ZodOptional<ZodNullable<ZodString>>;
     mime_type: ZodOptional<ZodNullable<ZodString>>;
     size: ZodOptional<ZodNullable<ZodNumber>>;
     annotations: ZodNullable<ZodRecord<ZodString, ZodUnknown>>;
     object: ZodString;
   }, "passthrough", ZodTypeAny, objectOutputType<{
     name: ZodString;
     type: ZodString;
     title: ZodNullable<ZodString>;
     description: ZodNullable<ZodString>;
     icons: ZodNullable<ZodArray<ZodUnknown, "many">>;
     enabled: ZodBoolean;
     created_at: ZodString;
     last_updated_at: ZodString;
     input_schema: ZodNullable<ZodRecord<ZodString, ZodUnknown>>;
     output_schema: ZodNullable<ZodRecord<ZodString, ZodUnknown>>;
     execution: ZodNullable<ZodRecord<ZodString, ZodUnknown>>;
     arguments: ZodOptional<ZodNullable<ZodArray<ZodUnknown, "many">>>;
     uri: ZodOptional<ZodNullable<ZodString>>;
     uri_template: ZodOptional<ZodNullable<ZodString>>;
     mime_type: ZodOptional<ZodNullable<ZodString>>;
     size: ZodOptional<ZodNullable<ZodNumber>>;
     annotations: ZodNullable<ZodRecord<ZodString, ZodUnknown>>;
     object: ZodString;
   }, ZodTypeAny, "passthrough">, objectInputType<{
     name: ZodString;
     type: ZodString;
     title: ZodNullable<ZodString>;
     description: ZodNullable<ZodString>;
     icons: ZodNullable<ZodArray<ZodUnknown, "many">>;
     enabled: ZodBoolean;
     created_at: ZodString;
     last_updated_at: ZodString;
     input_schema: ZodNullable<ZodRecord<ZodString, ZodUnknown>>;
     output_schema: ZodNullable<ZodRecord<ZodString, ZodUnknown>>;
     execution: ZodNullable<ZodRecord<ZodString, ZodUnknown>>;
     arguments: ZodOptional<ZodNullable<ZodArray<ZodUnknown, "many">>>;
     uri: ZodOptional<ZodNullable<ZodString>>;
     uri_template: ZodOptional<ZodNullable<ZodString>>;
     mime_type: ZodOptional<ZodNullable<ZodString>>;
     size: ZodOptional<ZodNullable<ZodNumber>>;
     annotations: ZodNullable<ZodRecord<ZodString, ZodUnknown>>;
     object: ZodString;
  }, ZodTypeAny, "passthrough">>, "many">;
}, ZodTypeAny, "passthrough">>;

Defined in: src/ai-gateway/mcp-integrations-client.ts:133

List capabilities discovered from an MCP integration. Verified live 2026-08-29.

Parameters

Parameter	Type	Description
`mcpIntegrationId`	`string`	MCP integration UUID.

Returns

Promise<objectOutputType<{ object: ZodString; counts: ZodObject<{ tools: ZodOptional<ZodObject<{ total: ZodNumber; enabled: ZodNumber; }, "passthrough", ZodTypeAny, objectOutputType<{ total: ZodNumber; enabled: ZodNumber; }, ZodTypeAny, "passthrough">, objectInputType<{ total: ZodNumber; enabled: ZodNumber; }, ZodTypeAny, "passthrough">>>; prompts: ZodOptional<ZodObject<{ total: ZodNumber; enabled: ZodNumber; }, "passthrough", ZodTypeAny, objectOutputType<{ total: ZodNumber; enabled: ZodNumber; }, ZodTypeAny, "passthrough">, objectInputType<{ total: ZodNumber; enabled: ZodNumber; }, ZodTypeAny, "passthrough">>>; resources: ZodOptional<ZodObject<{ total: ZodNumber; enabled: ZodNumber; }, "passthrough", ZodTypeAny, objectOutputType<{ total: ZodNumber; enabled: ZodNumber; }, ZodTypeAny, "passthrough">, objectInputType<{ total: ZodNumber; enabled: ZodNumber; }, ZodTypeAny, "passthrough">>>; resource_templates: ZodOptional<ZodObject<{ total: ZodNumber; enabled: ZodNumber; }, "passthrough", ZodTypeAny, objectOutputType<{ total: ZodNumber; enabled: ZodNumber; }, ZodTypeAny, "passthrough">, objectInputType<{ total: ZodNumber; enabled: ZodNumber; }, ZodTypeAny, "passthrough">>>; }, "passthrough", ZodTypeAny, objectOutputType<{ tools: ZodOptional<ZodObject<{ total: ZodNumber; enabled: ZodNumber; }, "passthrough", ZodTypeAny, objectOutputType<{ total: ZodNumber; enabled: ZodNumber; }, ZodTypeAny, "passthrough">, objectInputType<{ total: ZodNumber; enabled: ZodNumber; }, ZodTypeAny, "passthrough">>>; prompts: ZodOptional<ZodObject<{ total: ZodNumber; enabled: ZodNumber; }, "passthrough", ZodTypeAny, objectOutputType<{ total: ZodNumber; enabled: ZodNumber; }, ZodTypeAny, "passthrough">, objectInputType<{ total: ZodNumber; enabled: ZodNumber; }, ZodTypeAny, "passthrough">>>; resources: ZodOptional<ZodObject<{ total: ZodNumber; enabled: ZodNumber; }, "passthrough", ZodTypeAny, objectOutputType<{ total: ZodNumber; enabled: ZodNumber; }, ZodTypeAny, "passthrough">, objectInputType<{ total: ZodNumber; enabled: ZodNumber; }, ZodTypeAny, "passthrough">>>; resource_templates: ZodOptional<ZodObject<{ total: ZodNumber; enabled: ZodNumber; }, "passthrough", ZodTypeAny, objectOutputType<{ total: ZodNumber; enabled: ZodNumber; }, ZodTypeAny, "passthrough">, objectInputType<{ total: ZodNumber; enabled: ZodNumber; }, ZodTypeAny, "passthrough">>>; }, ZodTypeAny, "passthrough">, objectInputType<{ tools: ZodOptional<ZodObject<{ total: ZodNumber; enabled: ZodNumber; }, "passthrough", ZodTypeAny, objectOutputType<{ total: ZodNumber; enabled: ZodNumber; }, ZodTypeAny, "passthrough">, objectInputType<{ total: ZodNumber; enabled: ZodNumber; }, ZodTypeAny, "passthrough">>>; prompts: ZodOptional<ZodObject<{ total: ZodNumber; enabled: ZodNumber; }, "passthrough", ZodTypeAny, objectOutputType<{ total: ZodNumber; enabled: ZodNumber; }, ZodTypeAny, "passthrough">, objectInputType<{ total: ZodNumber; enabled: ZodNumber; }, ZodTypeAny, "passthrough">>>; resources: ZodOptional<ZodObject<{ total: ZodNumber; enabled: ZodNumber; }, "passthrough", ZodTypeAny, objectOutputType<{ total: ZodNumber; enabled: ZodNumber; }, ZodTypeAny, "passthrough">, objectInputType<{ total: ZodNumber; enabled: ZodNumber; }, ZodTypeAny, "passthrough">>>; resource_templates: ZodOptional<ZodObject<{ total: ZodNumber; enabled: ZodNumber; }, "passthrough", ZodTypeAny, objectOutputType<{ total: ZodNumber; enabled: ZodNumber; }, ZodTypeAny, "passthrough">, objectInputType<{ total: ZodNumber; enabled: ZodNumber; }, ZodTypeAny, "passthrough">>>; }, ZodTypeAny, "passthrough">>; total: ZodNumber; has_more: ZodBoolean; data: ZodArray<ZodObject<{ name: ZodString; type: ZodString; title: ZodNullable<ZodString>; description: ZodNullable<ZodString>; icons: ZodNullable<ZodArray<ZodUnknown, "many">>; enabled: ZodBoolean; created_at: ZodString; last_updated_at: ZodString; input_schema: ZodNullable<ZodRecord<ZodString, ZodUnknown>>; output_schema: ZodNullable<ZodRecord<ZodString, ZodUnknown>>; execution: ZodNullable<ZodRecord<ZodString, ZodUnknown>>; arguments: ZodOptional<ZodNullable<ZodArray<ZodUnknown, "many">>>; uri: ZodOptional<ZodNullable<ZodString>>; uri_template: ZodOptional<ZodNullable<ZodString>>; mime_type: ZodOptional<ZodNullable<ZodString>>; size: ZodOptional<ZodNullable<ZodNumber>>; annotations: ZodNullable<ZodRecord<ZodString, ZodUnknown>>; object: ZodString; }, "passthrough", ZodTypeAny, objectOutputType<{ name: ZodString; type: ZodString; title: ZodNullable<ZodString>; description: ZodNullable<ZodString>; icons: ZodNullable<ZodArray<ZodUnknown, "many">>; enabled: ZodBoolean; created_at: ZodString; last_updated_at: ZodString; input_schema: ZodNullable<ZodRecord<ZodString, ZodUnknown>>; output_schema: ZodNullable<ZodRecord<ZodString, ZodUnknown>>; execution: ZodNullable<ZodRecord<ZodString, ZodUnknown>>; arguments: ZodOptional<ZodNullable<ZodArray<ZodUnknown, "many">>>; uri: ZodOptional<ZodNullable<ZodString>>; uri_template: ZodOptional<ZodNullable<ZodString>>; mime_type: ZodOptional<ZodNullable<ZodString>>; size: ZodOptional<ZodNullable<ZodNumber>>; annotations: ZodNullable<ZodRecord<ZodString, ZodUnknown>>; object: ZodString; }, ZodTypeAny, "passthrough">, objectInputType<{ name: ZodString; type: ZodString; title: ZodNullable<ZodString>; description: ZodNullable<ZodString>; icons: ZodNullable<ZodArray<ZodUnknown, "many">>; enabled: ZodBoolean; created_at: ZodString; last_updated_at: ZodString; input_schema: ZodNullable<ZodRecord<ZodString, ZodUnknown>>; output_schema: ZodNullable<ZodRecord<ZodString, ZodUnknown>>; execution: ZodNullable<ZodRecord<ZodString, ZodUnknown>>; arguments: ZodOptional<ZodNullable<ZodArray<ZodUnknown, "many">>>; uri: ZodOptional<ZodNullable<ZodString>>; uri_template: ZodOptional<ZodNullable<ZodString>>; mime_type: ZodOptional<ZodNullable<ZodString>>; size: ZodOptional<ZodNullable<ZodNumber>>; annotations: ZodNullable<ZodRecord<ZodString, ZodUnknown>>; object: ZodString; }, ZodTypeAny, "passthrough">>, "many">; }, ZodTypeAny, "passthrough">>

Tools, prompts, resources, and resource templates with enablement counts.

Example

import { AIGatewayClient } from '@cdot65/prisma-airs-sdk';
const gw = new AIGatewayClient();
const capabilities = await gw.mcpIntegrations.getCapabilities('2a6f4e2e-6f5a-4a1f-9d0e-9b2b6f6c3a11');
console.log(capabilities.data.map((capability) => capability.name));

getMetadata()

getMetadata(mcpIntegrationId): Promise<objectOutputType<{
  server_name: ZodString;
  server_version: ZodString;
  title: ZodNullable<ZodString>;
  description: ZodNullable<ZodString>;
  website_url: ZodNullable<ZodString>;
  icons: ZodNullable<ZodUnknown>;
  protocol_version: ZodNullable<ZodString>;
  capability_flags: ZodRecord<ZodString, ZodUnknown>;
  instructions: ZodNullable<ZodString>;
  sync_status: ZodString;
  last_synced_at: ZodNullable<ZodString>;
  sync_error: ZodNullable<ZodString>;
  object: ZodString;
}, ZodTypeAny, "passthrough">>;

Defined in: src/ai-gateway/mcp-integrations-client.ts:157

Fetch metadata discovered from an MCP server. Verified live 2026-08-29.

Parameters

Parameter	Type	Description
`mcpIntegrationId`	`string`	MCP integration UUID.

Returns

Promise<objectOutputType<{ server_name: ZodString; server_version: ZodString; title: ZodNullable<ZodString>; description: ZodNullable<ZodString>; website_url: ZodNullable<ZodString>; icons: ZodNullable<ZodUnknown>; protocol_version: ZodNullable<ZodString>; capability_flags: ZodRecord<ZodString, ZodUnknown>; instructions: ZodNullable<ZodString>; sync_status: ZodString; last_synced_at: ZodNullable<ZodString>; sync_error: ZodNullable<ZodString>; object: ZodString; }, ZodTypeAny, "passthrough">>

Server identity, protocol, capability flags, and sync state.

Example

import { AIGatewayClient } from '@cdot65/prisma-airs-sdk';
const gw = new AIGatewayClient();
const metadata = await gw.mcpIntegrations.getMetadata('2a6f4e2e-6f5a-4a1f-9d0e-9b2b6f6c3a11');
console.log(metadata.sync_status);

create()

create(body): Promise<objectOutputType<{
  id: ZodOptional<ZodString>;
  slug: ZodOptional<ZodString>;
  version_id: ZodOptional<ZodString>;
  success: ZodOptional<ZodBoolean>;
  data: ZodOptional<ZodUnion<[ZodObject<{
     id: ZodOptional<ZodString>;
     slug: ZodOptional<ZodString>;
     version_id: ZodOptional<ZodString>;
   }, "passthrough", ZodTypeAny, objectOutputType<{
     id: ZodOptional<ZodString>;
     slug: ZodOptional<ZodString>;
     version_id: ZodOptional<ZodString>;
   }, ZodTypeAny, "passthrough">, objectInputType<{
     id: ZodOptional<ZodString>;
     slug: ZodOptional<ZodString>;
     version_id: ZodOptional<ZodString>;
  }, ZodTypeAny, "passthrough">>, ZodString, ZodNumber]>>;
}, ZodTypeAny, "passthrough">>;

Defined in: src/ai-gateway/mcp-integrations-client.ts:188

Parameters

Parameter	Type	Description
`body`	{ `name`: `string`; `organisation_id`: `string`; `workspace_id?`: `string`; `slug`: `string`; `url`: `string`; `auth_type`: `GatewayOpenValue`<`"headers"` \| `"none"` \| `"oauth_auto"` \| `"oauth_client_credentials"`>; `transport`: `GatewayOpenValue`<`"http"` \| `"interactive"` \| `"sse"`>; `description?`: `string` \| `null`; `configurations?`: { [`key`: `string`]: `unknown`; `custom_headers?`: { [`key`: `string`]: `unknown`; }; `passthrough_header?`: { [`key`: `string`]: `unknown`; }; } & `GatewayJsonObject`; `secret_mappings?`: { `target_field`: `string`; `secret_reference_id`: `string`; `secret_key?`: `string` \| `null`; `value_format?`: `"string"` \| `"json"` \| `null`; }[]; }	Name, server URL, auth type, transport, and provider-specific configuration.
`body.name`	`string`	-
`body.organisation_id`	`string`	-
`body.workspace_id?`	`string`	-
`body.slug`	`string`	-
`body.url`	`string`	-
`body.auth_type`	`GatewayOpenValue`<`"headers"` \| `"none"` \| `"oauth_auto"` \| `"oauth_client_credentials"`>	-
`body.transport`	`GatewayOpenValue`<`"http"` \| `"interactive"` \| `"sse"`>	-
`body.description?`	`string` \| `null`	-
`body.configurations?`	{ [`key`: `string`]: `unknown`; `custom_headers?`: { [`key`: `string`]: `unknown`; }; `passthrough_header?`: { [`key`: `string`]: `unknown`; }; } & `GatewayJsonObject`	-
`body.secret_mappings?`	{ `target_field`: `string`; `secret_reference_id`: `string`; `secret_key?`: `string` \| `null`; `value_format?`: `"string"` \| `"json"` \| `null`; }[]	-

Returns

Promise<objectOutputType<{ id: ZodOptional<ZodString>; slug: ZodOptional<ZodString>; version_id: ZodOptional<ZodString>; success: ZodOptional<ZodBoolean>; data: ZodOptional<ZodUnion<[ZodObject<{ id: ZodOptional<ZodString>; slug: ZodOptional<ZodString>; version_id: ZodOptional<ZodString>; }, "passthrough", ZodTypeAny, objectOutputType<{ id: ZodOptional<ZodString>; slug: ZodOptional<ZodString>; version_id: ZodOptional<ZodString>; }, ZodTypeAny, "passthrough">, objectInputType<{ id: ZodOptional<ZodString>; slug: ZodOptional<ZodString>; version_id: ZodOptional<ZodString>; }, ZodTypeAny, "passthrough">>, ZodString, ZodNumber]>>; }, ZodTypeAny, "passthrough">>

The raw create response. Shape unverified against a live tenant — see the PRD.

Example

import { AIGatewayClient } from '@cdot65/prisma-airs-sdk';
const gw = new AIGatewayClient();

await gw.mcpIntegrations.create({
  name: 'Context 7',
  organisation_id: '1852583913',
  slug: 'context-7',
  url: 'https://mcp.context7.com/mcp',
  auth_type: 'none',
  transport: 'http',
});

update()

update(mcpIntegrationId, body): Promise<objectOutputType<{
  id: ZodOptional<ZodString>;
  slug: ZodOptional<ZodString>;
  version_id: ZodOptional<ZodString>;
  success: ZodOptional<ZodBoolean>;
  data: ZodOptional<ZodUnion<[ZodObject<{
     id: ZodOptional<ZodString>;
     slug: ZodOptional<ZodString>;
     version_id: ZodOptional<ZodString>;
   }, "passthrough", ZodTypeAny, objectOutputType<{
     id: ZodOptional<ZodString>;
     slug: ZodOptional<ZodString>;
     version_id: ZodOptional<ZodString>;
   }, ZodTypeAny, "passthrough">, objectInputType<{
     id: ZodOptional<ZodString>;
     slug: ZodOptional<ZodString>;
     version_id: ZodOptional<ZodString>;
  }, ZodTypeAny, "passthrough">>, ZodString, ZodNumber]>>;
}, ZodTypeAny, "passthrough">>;

Defined in: src/ai-gateway/mcp-integrations-client.ts:203

Update an MCP integration.

Parameters

Parameter	Type
`mcpIntegrationId`	`string`
`body`	{ [`key`: `string`]: `any`; }

Returns

Example

`await gw.mcpIntegrations.update(id, { name: 'Docs MCP' });`

delete()

delete(mcpIntegrationId): Promise<void>;

Defined in: src/ai-gateway/mcp-integrations-client.ts:222

Permanently delete an MCP integration.

Parameters

Parameter	Type
`mcpIntegrationId`	`string`

Returns

Promise<void>

Example

`await gw.mcpIntegrations.delete(id);`

setCapabilities()

setCapabilities(mcpIntegrationId, body): Promise<objectOutputType<{
  success: ZodBoolean;
}, ZodTypeAny, "passthrough">>;

Defined in: src/ai-gateway/mcp-integrations-client.ts:234

Bulk-update capability enablement values.

Parameters

Parameter	Type
`mcpIntegrationId`	`string`
`body`	{ `capabilities`: { `name`: `string`; `type`: `"prompt"` \| `"resource"` \| `"tool"`; `enabled`: `boolean`; }[]; }
`body.capabilities`	{ `name`: `string`; `type`: `"prompt"` \| `"resource"` \| `"tool"`; `enabled`: `boolean`; }[]

Returns

Promise<objectOutputType<{ success: ZodBoolean; }, ZodTypeAny, "passthrough">>

Example

`await gw.mcpIntegrations.setCapabilities(id, { capabilities: [{ name: 'lookup', type: 'tool', enabled: true }] });`

setWorkspaces()

setWorkspaces(mcpIntegrationId, body): Promise<{
}>;

Defined in: src/ai-gateway/mcp-integrations-client.ts:269

Bulk-update which workspaces may use this MCP integration.

Parameters

Parameter	Type	Description
`mcpIntegrationId`	`string`	MCP integration UUID.
`body`	{ [`key`: `string`]: `any`; }	Workspace bindings or global-access settings. Use the explicit override flag to request replacement behavior.

Returns

Promise<{ }>

An empty object. Verified live 2026-08-30.

Example

import { AIGatewayClient } from '@cdot65/prisma-airs-sdk';
const gw = new AIGatewayClient();

await gw.mcpIntegrations.setWorkspaces('f6692544-3265-49be-9711-bbdcebc079e4', {
  workspaces: [{ id: 'ws-development', enabled: true }],
  global_workspace_access: { enabled: false },
  override_existing_workspace_access: true,
});

Constructors​

Constructor​

Parameters​

Returns​

Methods​

getWorkspaces()​

Parameters​

Returns​

Example​

list()​

Returns​

Example​

get()​

Parameters​

Returns​

Example​

getCapabilities()​

Parameters​

Returns​

Example​

getMetadata()​

Parameters​

Returns​

Example​

create()​

Parameters​

Returns​

Example​

update()​

Parameters​

Returns​

Example​

delete()​

Parameters​

Returns​

Example​

setCapabilities()​

Parameters​

Returns​

Example​

setWorkspaces()​

Parameters​

Returns​

Example​

Constructors

Constructor

Parameters

Returns

Methods

getWorkspaces()

Parameters

Returns

Example

list()

Returns

Example

get()

Parameters

Returns

Example

getCapabilities()

Parameters

Returns

Example

getMetadata()

Parameters

Returns

Example

create()

Parameters

Returns

Example

update()

Parameters

Returns

Example

delete()

Parameters

Returns

Example

setCapabilities()

Parameters

Returns

Example

setWorkspaces()

Parameters

Returns

Example