@composio/client 0.1.0-alpha.5 → 0.1.0-alpha.51

package/src/resources/mcp/custom.ts

@@ -0,0 +1,122 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { APIResource } from '../../core/resource';
+import { APIPromise } from '../../core/api-promise';
+import { RequestOptions } from '../../internal/request-options';
+
+export class Custom extends APIResource {
+  /**
+   * Creates a new Model Control Protocol (MCP) server instance that can integrate
+   * with multiple applications or toolkits simultaneously. This endpoint allows you
+   * to create a server that can access tools from different applications, making it
+   * suitable for complex workflows that span multiple services.
+   *
+   * @example
+   * ```ts
+   * const custom = await client.mcp.custom.create({
+   *   name: 'Development Integration Server',
+   *   toolkits: ['github', 'jira'],
+   * });
+   * ```
+   */
+  create(body: CustomCreateParams, options?: RequestOptions): APIPromise<CustomCreateResponse> {
+    return this._client.post('/api/v3/mcp/servers/custom', { body, ...options });
+  }
+}
+
+/**
+ * Response for a successfully created custom MCP server with multiple applications
+ */
+export interface CustomCreateResponse {
+  /**
+   * Unique identifier for the newly created custom MCP server
+   */
+  id: string;
+
+  /**
+   * List of tool identifiers that are enabled for this server
+   */
+  allowed_tools: Array<string>;
+
+  /**
+   * ID references to the auth configurations used by this server
+   */
+  auth_config_ids: Array<string>;
+
+  /**
+   * Set of command line instructions for connecting various clients to this MCP
+   * server
+   */
+  commands: CustomCreateResponse.Commands;
+
+  /**
+   * URL endpoint for establishing connection to this MCP server
+   */
+  mcp_url: string;
+
+  /**
+   * Human-readable name of the custom MCP server
+   */
+  name: string;
+}
+
+export namespace CustomCreateResponse {
+  /**
+   * Set of command line instructions for connecting various clients to this MCP
+   * server
+   */
+  export interface Commands {
+    /**
+     * Command line instruction for Claude client setup
+     */
+    claude: string;
+
+    /**
+     * Command line instruction for Cursor client setup
+     */
+    cursor: string;
+
+    /**
+     * Command line instruction for Windsurf client setup
+     */
+    windsurf: string;
+  }
+}
+
+export interface CustomCreateParams {
+  /**
+   * Human-readable name to identify this custom MCP server (4-30 characters,
+   * alphanumeric, spaces, and hyphens only)
+   */
+  name: string;
+
+  /**
+   * Tool identifiers to enable that aren't part of standard toolkits
+   */
+  allowed_tools?: Array<string>;
+
+  /**
+   * ID references to existing authentication configurations
+   */
+  auth_config_ids?: Array<string>;
+
+  /**
+   * DEPRECATED: Use allowed_tools instead. Tool identifiers to enable that aren't
+   * part of standard toolkits
+   */
+  custom_tools?: Array<string>;
+
+  /**
+   * Whether to manage authentication via Composio
+   */
+  managed_auth_via_composio?: boolean;
+
+  /**
+   * List of application/toolkit identifiers to enable for this server
+   */
+  toolkits?: Array<string>;
+}
+
+export declare namespace Custom {
+  export { type CustomCreateResponse as CustomCreateResponse, type CustomCreateParams as CustomCreateParams };
+}

package/src/resources/mcp/generate.ts

@@ -0,0 +1,71 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { APIResource } from '../../core/resource';
+import { APIPromise } from '../../core/api-promise';
+import { RequestOptions } from '../../internal/request-options';
+
+export class Generate extends APIResource {
+  /**
+   * Generates a Model Control Protocol (MCP) URL for an existing server with custom
+   * query parameters. The URL includes user-specific parameters and configuration
+   * flags that control the behavior of the MCP connection.
+   *
+   * @example
+   * ```ts
+   * const response = await client.mcp.generate.url({
+   *   mcp_server_id: '550e8400-e29b-41d4-a716-446655440000',
+   *   connected_account_ids: ['account_1', 'account_2'],
+   *   user_ids: ['user_123456'],
+   * });
+   * ```
+   */
+  url(body: GenerateURLParams, options?: RequestOptions): APIPromise<GenerateURLResponse> {
+    return this._client.post('/api/v3/mcp/servers/generate', { body, ...options });
+  }
+}
+
+/**
+ * Response containing the generated MCP URLs
+ */
+export interface GenerateURLResponse {
+  /**
+   * List of URLs generated for each connected account ID
+   */
+  connected_account_urls: Array<string>;
+
+  /**
+   * Base MCP URL without any query parameters
+   */
+  mcp_url: string;
+
+  /**
+   * List of URLs generated for each user ID
+   */
+  user_ids_url: Array<string>;
+}
+
+export interface GenerateURLParams {
+  /**
+   * Unique identifier of the MCP server to generate URL for
+   */
+  mcp_server_id: string;
+
+  /**
+   * List of connected account identifiers
+   */
+  connected_account_ids?: Array<string>;
+
+  /**
+   * Flag indicating if Composio manages authentication
+   */
+  managed_auth_by_composio?: boolean;
+
+  /**
+   * List of user identifiers for whom the URL is generated
+   */
+  user_ids?: Array<string>;
+}
+
+export declare namespace Generate {
+  export { type GenerateURLResponse as GenerateURLResponse, type GenerateURLParams as GenerateURLParams };
+}

package/src/resources/mcp/index.ts

@@ -1,6 +1,7 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
-export { Command, type CommandGenerateResponse, type CommandGenerateParams } from './command';
+export { Custom, type CustomCreateResponse, type CustomCreateParams } from './custom';
+export { Generate, type GenerateURLResponse, type GenerateURLParams } from './generate';
 export {
   Mcp,
   type McpCreateResponse,
@@ -9,9 +10,8 @@ export {
   type McpListResponse,
   type McpDeleteResponse,
   type McpRetrieveAppResponse,
-  type McpValidateResponse,
   type McpCreateParams,
   type McpUpdateParams,
   type McpListParams,
-  type McpValidateParams,
+  type McpRetrieveAppParams,
 } from './mcp';