import {z} from 'zod' export type GetApiV1AiGatewaysGatewayIdMcpServersMcpServerIdOrNameOptions = {baseUrl?: string | undefined, personalAccessToken?: string | undefined, fetch?: typeof fetch | undefined}; export const uUID = z.string(); export const createdAt = z.string(); export const updatedAt = z.string(); export const aIGatewayMCPServerRouteWithMatcher = z.object({headers: z.record(z.string(), z.unknown()).optional(), hosts: z.array(z.string()).optional(), https_redirect_status_code: z.number().int().gte(100).lte(599).optional(), methods: z.array(z.string()).optional(), paths: z.array(z.string()).optional(), preserve_host: z.boolean().optional(), protocols: z.array(z.string()).optional(), regex_priority: z.number().int().gte(-2147483648).lte(2147483647).optional(), request_buffering: z.boolean().optional(), response_buffering: z.boolean().optional(), strip_path: z.boolean().optional(), tags: z.array(z.string()).optional()}); export const aIGatewayUpstreamConfig = z.object({auth: z.object({type: z.literal("aws"), access_key_id: z.string().optional(), secret_access_key: z.string().optional(), session_token: z.string().optional(), region: z.string().optional(), assume_role_arn: z.string().optional(), role_session_name: z.string().optional(), sts_endpoint_url: z.string().optional()}).optional()}); export const aIGatewayMCPServerWithUpstreamNoProxyConfigNoServerConfig = z.object({route: aIGatewayMCPServerRouteWithMatcher.optional(), logging: z.object({payloads: z.boolean().optional(), audits: z.boolean().optional()}).optional(), max_request_body_size: z.number().int().optional(), url: z.string(), upstream: aIGatewayUpstreamConfig.optional()}); export const aIGatewayMCPACLs = z.object({allow: z.array(z.string()).optional(), deny: z.array(z.string()).optional()}); export const aIGatewayMCPToolAccess = z.object({acls: aIGatewayMCPACLs.optional()}); export const aIGatewayMCPToolAnnotations = z.object({destructive_hint: z.boolean().optional(), idempotent_hint: z.boolean().optional(), open_world_hint: z.boolean().optional(), read_only_hint: z.boolean().optional(), title: z.string().optional()}); export const aIGatewayMCPToolHeaders = z.record(z.string(), z.unknown()); export const aIGatewayMCPToolQuery = z.record(z.string(), z.unknown()); export const aIGatewayMCPToolRequestBody = z.record(z.string(), z.unknown()); export const aIGatewayMCPToolResponses = z.record(z.string(), z.unknown()); export const aIGatewayMCPToolParameter = z.object({name: z.string(), in: z.enum(["query", "path", "header", "body"]), description: z.string().optional(), required: z.boolean().optional(), schema: z.record(z.string(), z.unknown()).optional()}); export const aIGatewayMCPToolParameters = z.array(aIGatewayMCPToolParameter); export const aIGatewayMCPConversionTool = z.object({access: aIGatewayMCPToolAccess.optional(), annotations: aIGatewayMCPToolAnnotations.optional(), description: z.string(), name: z.string(), headers: aIGatewayMCPToolHeaders.optional(), host: z.string().nullable().optional(), method: z.enum(["DELETE", "GET", "PATCH", "POST", "PUT"]), path: z.string().nullable().optional(), query: aIGatewayMCPToolQuery.optional(), request_body: aIGatewayMCPToolRequestBody.optional(), responses: aIGatewayMCPToolResponses.optional(), scheme: z.enum(["http", "https"]).optional(), parameters: aIGatewayMCPToolParameters.optional()}); export const aIGatewayEntityIdentifier = z.string().min(1).max(256); export const aIGatewayPolicyReferences = z.array(z.string()); export const publicLabels = z.record(z.string(), z.string().min(1).max(63)); export const managedBy = z.record(z.string(), z.string().min(1).max(63)); export const aIGatewayRedisAWSAuthentication = z.object({type: z.literal("aws"), access_key_id: z.string().nullable().optional(), assume_role_arn: z.string().nullable().optional(), cache_name: z.string().nullable().optional(), is_serverless: z.boolean().optional(), region: z.string().nullable().optional(), role_session_name: z.string().nullable().optional(), secret_access_key: z.string().nullable().optional()}); export const aIGatewayRedisAzureAuthentication = z.object({type: z.literal("azure"), client_id: z.string().nullable().optional(), client_secret: z.string().nullable().optional(), tenant_id: z.string().nullable().optional()}); export const aIGatewayRedisGCPAuthentication = z.object({type: z.literal("gcp"), service_account_json: z.string().nullable().optional()}); export const aIGatewayRedisCloudConfiguration = z.object({cloud_authentication: z.discriminatedUnion("type", [aIGatewayRedisAWSAuthentication, aIGatewayRedisAzureAuthentication, aIGatewayRedisGCPAuthentication]).optional(), cluster: z.object({max_redirections: z.number().int().gte(0).lte(2147483646).optional(), nodes: z.array(z.object({ip: z.string().optional(), port: z.number().int().gte(0).lte(65535).optional()})).nullable().optional()}).nullable().optional(), connect_timeout: z.number().int().gte(0).lte(2147483646).optional(), connection_is_proxied: z.boolean().optional(), database: z.number().int().gte(0).lte(2147483646).optional(), host: z.string().optional(), keepalive: z.object({backlog: z.number().int().gte(0).lte(2147483646).nullable().optional(), pool_size: z.number().int().gte(1).lte(2147483646).optional()}).nullable().optional(), password: z.string().nullable().optional(), port: z.string().optional(), read_timeout: z.number().int().gte(0).lte(2147483646).optional(), send_timeout: z.number().int().gte(0).lte(2147483646).optional(), sentinel: z.object({master: z.string().nullable().optional(), nodes: z.array(z.object({host: z.string().optional(), port: z.number().int().gte(0).lte(65535).optional()})).nullable().optional(), password: z.string().nullable().optional(), role: z.enum(["any", "master", "slave"]).optional(), username: z.string().nullable().optional()}).nullable().optional(), server_name: z.string().nullable().optional(), ssl: z.boolean().optional(), ssl_verify: z.boolean().optional(), username: z.string().nullable().optional()}); export const aIGatewayMCPServerServerConfigBase = z.object({forward_client_headers: z.boolean().optional(), session: z.object({client: z.object({secrets: z.array(z.string().min(8)).nullable().optional()}).nullable().optional(), managed: z.boolean().optional(), redis: aIGatewayRedisCloudConfiguration.optional(), session_ttl: z.number().int().gte(0).lte(2147483646).optional(), strategy: z.enum(["client", "redis"]).optional()}).nullable().optional(), timeout: z.number().int().gte(0).lte(2147483646).optional()}); export const aIGatewayMCPServerWithUpstreamNoProxyConfig = z.object({route: aIGatewayMCPServerRouteWithMatcher.optional(), logging: z.object({payloads: z.boolean().optional(), audits: z.boolean().optional()}).optional(), max_request_body_size: z.number().int().gte(0).lte(2147483646).optional(), server: aIGatewayMCPServerServerConfigBase.optional(), url: z.string(), upstream: aIGatewayUpstreamConfig.optional()}); export const aIGatewayIdentityProviderReference = z.string(); export const aIGatewayAuthStrategyReference = z.string(); export const aIGatewayMCPServerProtectedResourceMetadata = z.object({discovery_endpoint: z.string().optional(), endpoint: z.string().optional(), authorization_servers: z.array(z.string()).optional(), resource: z.string().optional(), scopes_supported: z.array(z.string()).optional()}); export const aIGatewayMCPServerListenerAccess = z.discriminatedUnion("acl_attribute_type", [z.object({acl_attribute_type: z.literal("consumer"), acls: aIGatewayMCPACLs.optional(), default_tool_acls: aIGatewayMCPACLs.optional(), identity_providers: z.array(aIGatewayIdentityProviderReference).optional(), auth_strategies: z.array(aIGatewayAuthStrategyReference).optional(), metadata: aIGatewayMCPServerProtectedResourceMetadata.optional()}), z.object({acl_attribute_type: z.literal("oauth_access_token"), access_token_claim_field: z.string(), acls: aIGatewayMCPACLs.optional(), default_tool_acls: aIGatewayMCPACLs.optional(), identity_providers: z.array(aIGatewayIdentityProviderReference).optional(), auth_strategies: z.array(aIGatewayAuthStrategyReference).optional(), metadata: aIGatewayMCPServerProtectedResourceMetadata.optional()})]); export const aIGatewayMCPServerNoUpstreamConfig = z.object({route: aIGatewayMCPServerRouteWithMatcher.optional(), logging: z.object({payloads: z.boolean().optional(), audits: z.boolean().optional()}).optional(), max_request_body_size: z.number().int().gte(0).lte(2147483646).optional(), server: aIGatewayMCPServerServerConfigBase.optional()}); export const aIGatewayProxyConfig = z.object({http_proxy: z.object({host: z.string().nullable().optional(), port: z.number().int().gte(0).lte(65535).nullable().optional()}).optional(), https_proxy: z.object({host: z.string().nullable().optional(), port: z.number().int().gte(0).lte(65535).nullable().optional()}).optional(), proxy_scheme: z.literal("http").optional(), auth: z.object({username: z.string().nullable().optional(), password: z.string().nullable().optional()}).optional(), no_proxy: z.string().optional()}); export const aIGatewayMCPServerWithUpstreamConfig = z.object({route: aIGatewayMCPServerRouteWithMatcher.optional(), logging: z.object({payloads: z.boolean().optional(), audits: z.boolean().optional()}).optional(), max_request_body_size: z.number().int().gte(0).lte(2147483646).optional(), server: aIGatewayMCPServerServerConfigBase.optional(), url: z.string(), upstream: aIGatewayUpstreamConfig.optional(), proxy: aIGatewayProxyConfig.optional()}); export const aIGatewayMCPPassthroughTool = z.object({access: aIGatewayMCPToolAccess, name: z.string()}); export const aIGatewayMCPServerUpstreamServerServerToolAuthConfig = z.discriminatedUnion("type", [z.object({scope: z.string().nullable().optional(), access_token_header: z.string().optional(), id_token_header: z.string().nullable().optional(), type: z.literal("jwt")}), z.object({scope: z.string().nullable().optional(), access_token_header: z.string().optional(), id_token_header: z.string().nullable().optional(), type: z.literal("credentials"), token_endpoint: z.string(), client_id: z.string(), client_secret: z.string().nullable().optional()})]); export const aIGatewayMCPServerUpstreamServerServerConfig = z.object({forward_client_headers: z.boolean().optional(), session: z.object({client: z.object({secrets: z.array(z.string().min(8)).nullable().optional()}).nullable().optional(), managed: z.boolean().optional(), redis: aIGatewayRedisCloudConfiguration.optional(), session_ttl: z.number().int().gte(0).lte(2147483646).optional(), strategy: z.enum(["client", "redis"]).optional()}).nullable().optional(), timeout: z.number().int().gte(0).lte(2147483646).optional(), preserve_upstream_tool_names: z.boolean().optional(), tools_list_auth: aIGatewayMCPServerUpstreamServerServerToolAuthConfig.optional()}); export const aIGatewayMCPServerUpstreamServerConfig = z.object({route: aIGatewayMCPServerRouteWithMatcher.optional(), logging: z.object({payloads: z.boolean().optional(), audits: z.boolean().optional()}).optional(), max_request_body_size: z.number().int().gte(0).lte(2147483646).optional(), server: aIGatewayMCPServerUpstreamServerServerConfig.optional(), url: z.string(), upstream: aIGatewayUpstreamConfig.optional(), tools_cache_ttl_seconds: z.number().int().gte(0)}); export const aIGatewayMCPUpstreamTool = z.object({access: aIGatewayMCPToolAccess.optional(), annotations: aIGatewayMCPToolAnnotations.optional(), description: z.string().nullable().optional(), name: z.string(), input_schema: z.record(z.string(), z.unknown()).nullable().optional(), output_schema: z.record(z.string(), z.unknown()).nullable().optional()}); export const aIGatewayMCPServer = z.discriminatedUnion("type", [z.object({id: uUID, created_at: createdAt, updated_at: updatedAt, type: z.literal("conversion-only"), config: aIGatewayMCPServerWithUpstreamNoProxyConfigNoServerConfig, tools: z.array(aIGatewayMCPConversionTool), display_name: z.string().min(1).max(256), name: aIGatewayEntityIdentifier, enabled: z.boolean().optional(), policies: aIGatewayPolicyReferences.optional(), labels: publicLabels.optional(), managed_by: managedBy.optional()}), z.object({id: uUID, created_at: createdAt, updated_at: updatedAt, type: z.literal("conversion-listener"), config: aIGatewayMCPServerWithUpstreamNoProxyConfig, tools: z.array(aIGatewayMCPConversionTool), access: aIGatewayMCPServerListenerAccess.optional(), display_name: z.string().min(1).max(256), name: aIGatewayEntityIdentifier, enabled: z.boolean().optional(), policies: aIGatewayPolicyReferences.optional(), labels: publicLabels.optional(), managed_by: managedBy.optional()}), z.object({id: uUID, created_at: createdAt, updated_at: updatedAt, type: z.literal("listener"), config: aIGatewayMCPServerNoUpstreamConfig, sources: z.array(aIGatewayEntityIdentifier), access: aIGatewayMCPServerListenerAccess.optional(), display_name: z.string().min(1).max(256), name: aIGatewayEntityIdentifier, enabled: z.boolean().optional(), policies: aIGatewayPolicyReferences.optional(), labels: publicLabels.optional(), managed_by: managedBy.optional()}), z.object({id: uUID, created_at: createdAt, updated_at: updatedAt, type: z.literal("passthrough-listener"), config: aIGatewayMCPServerWithUpstreamConfig, tools: z.array(aIGatewayMCPPassthroughTool).optional(), access: aIGatewayMCPServerListenerAccess.optional(), display_name: z.string().min(1).max(256), name: aIGatewayEntityIdentifier, enabled: z.boolean().optional(), policies: aIGatewayPolicyReferences.optional(), labels: publicLabels.optional(), managed_by: managedBy.optional()}), z.object({id: uUID, created_at: createdAt, updated_at: updatedAt, type: z.literal("upstream-server"), config: aIGatewayMCPServerUpstreamServerConfig, tools: z.array(aIGatewayMCPUpstreamTool).optional(), display_name: z.string().min(1).max(256), name: aIGatewayEntityIdentifier, enabled: z.boolean().optional(), policies: aIGatewayPolicyReferences.optional(), labels: publicLabels.optional(), managed_by: managedBy.optional()})]); export const validateResponse = async ( schema: { readonly '~standard': { readonly validate: (value: unknown) => ({ readonly value: Output; readonly issues?: undefined } | { readonly issues: ReadonlyArray<{ readonly message: string; readonly path?: ReadonlyArray | undefined }> }) | Promise<{ readonly value: Output; readonly issues?: undefined } | { readonly issues: ReadonlyArray<{ readonly message: string; readonly path?: ReadonlyArray | undefined }> }> } }, value: unknown ): Promise => { const result = await schema['~standard'].validate(value) if (result.issues !== undefined) { const detail = result.issues .map(({ message, path }) => path?.length ? `${path.map((segment) => String(typeof segment === 'object' ? segment.key : segment)).join('.')}: ${message}` : message ) .join('; ') throw new Error(`Response does not match the schema: ${detail}`, { cause: { issues: result.issues } }) } return result.value }; /** * Get an MCP Server * * GET /v1/ai-gateways/{gatewayId}/mcp-servers/{mcpServerIdOrName} * * Also accepts auth: systemAccountAccessToken, konnectAccessToken, serviceAccessToken */ export const getApiV1AiGatewaysGatewayIdMcpServersMcpServerIdOrName = async (options?: GetApiV1AiGatewaysGatewayIdMcpServersMcpServerIdOrNameOptions) => { const {baseUrl = "https://global.api.konghq.com", fetch: fetchFn = fetch, personalAccessToken} = options ?? {} const query = new URLSearchParams() const headers = new Headers() headers.set('accept', "application/json") if (personalAccessToken !== undefined) headers.set('authorization', `Bearer ${personalAccessToken}`) const url = `${baseUrl.replace(/\/+$/, '')}/v1/ai-gateways/${encodeURIComponent(String(args.gatewayId))}/mcp-servers/${encodeURIComponent(String(args.mcpServerIdOrName))}${query.size > 0 ? `?${query}` : ''}` const res = await fetchFn(url, {method: "GET", headers}) if (!res.ok) throw new Error(`Request failed with status ${res.status}`, {cause: {status: res.status, body: await res.text()}}) return validateResponse(aIGatewayMCPServer, await res.json()) };