import { APIResource } from "../../../../../resource.js"; import * as Core from "../../../../../core.js"; import { V4PagePaginationArray, type V4PagePaginationArrayParams } from "../../../../../pagination.js"; export declare class Servers extends APIResource { /** * Creates a new MCP portal for managing AI tool access through Cloudflare Access. * * @example * ```ts * const server = * await client.zeroTrust.access.aiControls.mcp.servers.create( * { * account_id: 'a86a8f5c339544d7bdc89926de14fb8c', * id: 'my-mcp-server', * auth_type: 'unauthenticated', * hostname: 'https://example.com/mcp', * name: 'My MCP Server', * }, * ); * ``` */ create(params: ServerCreateParams, options?: Core.RequestOptions): Core.APIPromise; /** * Updates an MCP portal configuration. * * @example * ```ts * const server = * await client.zeroTrust.access.aiControls.mcp.servers.update( * 'my-mcp-server', * { account_id: 'a86a8f5c339544d7bdc89926de14fb8c' }, * ); * ``` */ update(id: string, params: ServerUpdateParams, options?: Core.RequestOptions): Core.APIPromise; /** * Lists all MCP portals configured for the account. * * @example * ```ts * // Automatically fetches more pages as needed. * for await (const serverListResponse of client.zeroTrust.access.aiControls.mcp.servers.list( * { account_id: 'a86a8f5c339544d7bdc89926de14fb8c' }, * )) { * // ... * } * ``` */ list(params: ServerListParams, options?: Core.RequestOptions): Core.PagePromise; /** * Deletes an MCP portal from the account. * * @example * ```ts * const server = * await client.zeroTrust.access.aiControls.mcp.servers.delete( * 'my-mcp-server', * { account_id: 'a86a8f5c339544d7bdc89926de14fb8c' }, * ); * ``` */ delete(id: string, params: ServerDeleteParams, options?: Core.RequestOptions): Core.APIPromise; /** * Retrieves gateway configuration for MCP portals. * * @example * ```ts * const response = * await client.zeroTrust.access.aiControls.mcp.servers.read( * 'my-mcp-server', * { account_id: 'a86a8f5c339544d7bdc89926de14fb8c' }, * ); * ``` */ read(id: string, params: ServerReadParams, options?: Core.RequestOptions): Core.APIPromise; /** * Syncs an MCP server's capabilities and returns the updated server state, * including any connection errors. * * @example * ```ts * const response = * await client.zeroTrust.access.aiControls.mcp.servers.sync( * 'my-mcp-portal', * { account_id: 'a86a8f5c339544d7bdc89926de14fb8c' }, * ); * ``` */ sync(id: string, params: ServerSyncParams, options?: Core.RequestOptions): Core.APIPromise; } export declare class ServerListResponsesV4PagePaginationArray extends V4PagePaginationArray { } export interface ServerCreateResponse { /** * server id */ id: string; auth_type: 'oauth' | 'bearer' | 'unauthenticated'; hostname: string; name: string; prompts: Array<{ [key: string]: unknown; }>; tools: Array<{ [key: string]: unknown; }>; created_at?: string; created_by?: string; description?: string | null; error?: string; error_details?: ServerCreateResponse.ErrorDetails; /** * When true, the gateway worker uses the shared Cloudflare-owned OAuth callback * endpoint as the redirect_uri for upstream on-behalf OAuth, instead of the * customer portal hostname. New servers default to true; existing servers default * to false. Effective behavior is gated by the gateway worker's per-env rollout * mode KV key. */ is_shared_oauth_callback_enabled?: boolean; last_successful_sync?: string; last_synced?: string; modified_at?: string; modified_by?: string; status?: string; updated_prompts?: Array; updated_tools?: Array; } export declare namespace ServerCreateResponse { interface ErrorDetails { /** * Underlying error message */ cause?: string; /** * True = MCP server returned an error. False = couldn't reach the server */ is_upstream?: boolean; /** * MCP protocol error code */ mcp_code?: number; /** * Whether the error is transient and worth retrying */ retryable?: boolean; /** * HTTP status code from the server */ status_code?: number; } interface UpdatedPrompt { name: string; alias?: string; description?: string; enabled?: boolean; } interface UpdatedTool { name: string; alias?: string; description?: string; enabled?: boolean; } } export interface ServerUpdateResponse { /** * server id */ id: string; auth_type: 'oauth' | 'bearer' | 'unauthenticated'; hostname: string; name: string; prompts: Array<{ [key: string]: unknown; }>; tools: Array<{ [key: string]: unknown; }>; created_at?: string; created_by?: string; description?: string | null; error?: string; error_details?: ServerUpdateResponse.ErrorDetails; /** * When true, the gateway worker uses the shared Cloudflare-owned OAuth callback * endpoint as the redirect_uri for upstream on-behalf OAuth, instead of the * customer portal hostname. New servers default to true; existing servers default * to false. Effective behavior is gated by the gateway worker's per-env rollout * mode KV key. */ is_shared_oauth_callback_enabled?: boolean; last_successful_sync?: string; last_synced?: string; modified_at?: string; modified_by?: string; status?: string; updated_prompts?: Array; updated_tools?: Array; } export declare namespace ServerUpdateResponse { interface ErrorDetails { /** * Underlying error message */ cause?: string; /** * True = MCP server returned an error. False = couldn't reach the server */ is_upstream?: boolean; /** * MCP protocol error code */ mcp_code?: number; /** * Whether the error is transient and worth retrying */ retryable?: boolean; /** * HTTP status code from the server */ status_code?: number; } interface UpdatedPrompt { name: string; alias?: string; description?: string; enabled?: boolean; } interface UpdatedTool { name: string; alias?: string; description?: string; enabled?: boolean; } } export interface ServerListResponse { /** * server id */ id: string; auth_type: 'oauth' | 'bearer' | 'unauthenticated'; hostname: string; name: string; prompts: Array<{ [key: string]: unknown; }>; tools: Array<{ [key: string]: unknown; }>; created_at?: string; created_by?: string; description?: string | null; error?: string; error_details?: ServerListResponse.ErrorDetails; /** * When true, the gateway worker uses the shared Cloudflare-owned OAuth callback * endpoint as the redirect_uri for upstream on-behalf OAuth, instead of the * customer portal hostname. New servers default to true; existing servers default * to false. Effective behavior is gated by the gateway worker's per-env rollout * mode KV key. */ is_shared_oauth_callback_enabled?: boolean; last_successful_sync?: string; last_synced?: string; modified_at?: string; modified_by?: string; status?: string; updated_prompts?: Array; updated_tools?: Array; } export declare namespace ServerListResponse { interface ErrorDetails { /** * Underlying error message */ cause?: string; /** * True = MCP server returned an error. False = couldn't reach the server */ is_upstream?: boolean; /** * MCP protocol error code */ mcp_code?: number; /** * Whether the error is transient and worth retrying */ retryable?: boolean; /** * HTTP status code from the server */ status_code?: number; } interface UpdatedPrompt { name: string; alias?: string; description?: string; enabled?: boolean; } interface UpdatedTool { name: string; alias?: string; description?: string; enabled?: boolean; } } export interface ServerDeleteResponse { /** * server id */ id: string; auth_type: 'oauth' | 'bearer' | 'unauthenticated'; hostname: string; name: string; prompts: Array<{ [key: string]: unknown; }>; tools: Array<{ [key: string]: unknown; }>; created_at?: string; created_by?: string; description?: string | null; error?: string; error_details?: ServerDeleteResponse.ErrorDetails; /** * When true, the gateway worker uses the shared Cloudflare-owned OAuth callback * endpoint as the redirect_uri for upstream on-behalf OAuth, instead of the * customer portal hostname. New servers default to true; existing servers default * to false. Effective behavior is gated by the gateway worker's per-env rollout * mode KV key. */ is_shared_oauth_callback_enabled?: boolean; last_successful_sync?: string; last_synced?: string; modified_at?: string; modified_by?: string; status?: string; updated_prompts?: Array; updated_tools?: Array; } export declare namespace ServerDeleteResponse { interface ErrorDetails { /** * Underlying error message */ cause?: string; /** * True = MCP server returned an error. False = couldn't reach the server */ is_upstream?: boolean; /** * MCP protocol error code */ mcp_code?: number; /** * Whether the error is transient and worth retrying */ retryable?: boolean; /** * HTTP status code from the server */ status_code?: number; } interface UpdatedPrompt { name: string; alias?: string; description?: string; enabled?: boolean; } interface UpdatedTool { name: string; alias?: string; description?: string; enabled?: boolean; } } export interface ServerReadResponse { /** * server id */ id: string; auth_type: 'oauth' | 'bearer' | 'unauthenticated'; hostname: string; name: string; prompts: Array<{ [key: string]: unknown; }>; tools: Array<{ [key: string]: unknown; }>; created_at?: string; created_by?: string; description?: string | null; error?: string; error_details?: ServerReadResponse.ErrorDetails; /** * When true, the gateway worker uses the shared Cloudflare-owned OAuth callback * endpoint as the redirect_uri for upstream on-behalf OAuth, instead of the * customer portal hostname. New servers default to true; existing servers default * to false. Effective behavior is gated by the gateway worker's per-env rollout * mode KV key. */ is_shared_oauth_callback_enabled?: boolean; last_successful_sync?: string; last_synced?: string; modified_at?: string; modified_by?: string; status?: string; updated_prompts?: Array; updated_tools?: Array; } export declare namespace ServerReadResponse { interface ErrorDetails { /** * Underlying error message */ cause?: string; /** * True = MCP server returned an error. False = couldn't reach the server */ is_upstream?: boolean; /** * MCP protocol error code */ mcp_code?: number; /** * Whether the error is transient and worth retrying */ retryable?: boolean; /** * HTTP status code from the server */ status_code?: number; } interface UpdatedPrompt { name: string; alias?: string; description?: string; enabled?: boolean; } interface UpdatedTool { name: string; alias?: string; description?: string; enabled?: boolean; } } export interface ServerSyncResponse { error?: string; error_details?: ServerSyncResponse.ErrorDetails; status?: string; } export declare namespace ServerSyncResponse { interface ErrorDetails { /** * Underlying error message */ cause?: string; /** * True = MCP server returned an error. False = couldn't reach the server */ is_upstream?: boolean; /** * MCP protocol error code */ mcp_code?: number; /** * Whether the error is transient and worth retrying */ retryable?: boolean; /** * HTTP status code from the server */ status_code?: number; } } export interface ServerCreateParams { /** * Path param */ account_id: string; /** * Body param: server id */ id: string; /** * Body param */ auth_type: 'oauth' | 'bearer' | 'unauthenticated'; /** * Body param */ hostname: string; /** * Body param */ name: string; /** * Body param */ auth_credentials?: string; /** * Body param */ description?: string | null; /** * Body param: When true, the gateway worker uses the shared Cloudflare-owned OAuth * callback endpoint as the redirect_uri for upstream on-behalf OAuth, instead of * the customer portal hostname. New servers default to true; existing servers * default to false. Effective behavior is gated by the gateway worker's per-env * rollout mode KV key. */ is_shared_oauth_callback_enabled?: boolean; /** * Body param */ updated_prompts?: Array; /** * Body param */ updated_tools?: Array; } export declare namespace ServerCreateParams { interface UpdatedPrompt { name: string; alias?: string; description?: string; enabled?: boolean; } interface UpdatedTool { name: string; alias?: string; description?: string; enabled?: boolean; } } export interface ServerUpdateParams { /** * Path param */ account_id: string; /** * Body param */ auth_credentials?: string; /** * Body param */ description?: string | null; /** * Body param: When true, the gateway worker uses the shared Cloudflare-owned OAuth * callback endpoint as the redirect_uri for upstream on-behalf OAuth, instead of * the customer portal hostname. New servers default to true; existing servers * default to false. Effective behavior is gated by the gateway worker's per-env * rollout mode KV key. */ is_shared_oauth_callback_enabled?: boolean; /** * Body param */ name?: string; /** * Body param */ updated_prompts?: Array; /** * Body param */ updated_tools?: Array; } export declare namespace ServerUpdateParams { interface UpdatedPrompt { name: string; alias?: string; description?: string; enabled?: boolean; } interface UpdatedTool { name: string; alias?: string; description?: string; enabled?: boolean; } } export interface ServerListParams extends V4PagePaginationArrayParams { /** * Path param */ account_id: string; /** * Query param: Search by id, name */ search?: string; } export interface ServerDeleteParams { account_id: string; } export interface ServerReadParams { account_id: string; } export interface ServerSyncParams { account_id: string; } export declare namespace Servers { export { type ServerCreateResponse as ServerCreateResponse, type ServerUpdateResponse as ServerUpdateResponse, type ServerListResponse as ServerListResponse, type ServerDeleteResponse as ServerDeleteResponse, type ServerReadResponse as ServerReadResponse, type ServerSyncResponse as ServerSyncResponse, ServerListResponsesV4PagePaginationArray as ServerListResponsesV4PagePaginationArray, type ServerCreateParams as ServerCreateParams, type ServerUpdateParams as ServerUpdateParams, type ServerListParams as ServerListParams, type ServerDeleteParams as ServerDeleteParams, type ServerReadParams as ServerReadParams, type ServerSyncParams as ServerSyncParams, }; } //# sourceMappingURL=servers.d.ts.map