@composio/client 0.1.0-alpha.11 → 0.1.0-alpha.13

package/src/resources/mcp/mcp.ts

@@ -1,15 +1,33 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
 import { APIResource } from '../../core/resource';
-import * as CommandAPI from './command';
-import { Command } from './command';
+import * as CustomAPI from './custom';
+import { Custom, CustomCreateParams, CustomCreateResponse } from './custom';
 import { APIPromise } from '../../core/api-promise';
-import { buildHeaders } from '../../internal/headers';
 import { RequestOptions } from '../../internal/request-options';
 import { path } from '../../internal/utils/path';
 
 export class Mcp extends APIResource {
-  command: CommandAPI.Command = new CommandAPI.Command(this._client);
+  custom: CustomAPI.Custom = new CustomAPI.Custom(this._client);
+
+  /**
+   * Creates a new Model Control Protocol (MCP) server instance for the authenticated
+   * project. An MCP server provides a connection point for AI assistants to access
+   * your applications and services. The server is configured with specific
+   * authentication and tool permissions that determine what actions the connected
+   * assistants can perform.
+   *
+   * @example
+   * ```ts
+   * const mcp = await client.mcp.create({
+   *   name: 'GitHub Integration Server',
+   *   auth_config_id: 'auth_cfg_abc123def456',
+   * });
+   * ```
+   */
+  create(body: McpCreateParams, options?: RequestOptions): APIPromise<McpCreateResponse> {
+    return this._client.post('/api/v3/mcp/servers', { body, ...options });
+  }
 
   /**
    * Retrieves detailed configuration information for a specific Model Control
@@ -48,6 +66,22 @@ export class Mcp extends APIResource {
     return this._client.patch(path`/api/v3/mcp/${id}`, { body, ...options });
   }
 
+  /**
+   * Retrieves a paginated list of MCP servers associated with the authenticated
+   * project. Results can be filtered by name, toolkit, or authentication
+   * configuration ID. MCP servers are used to provide Model Control Protocol
+   * integration points for connecting AI assistants to your applications and
+   * services.
+   *
+   * @example
+   * ```ts
+   * const mcps = await client.mcp.list();
+   * ```
+   */
+  list(query: McpListParams | null | undefined = {}, options?: RequestOptions): APIPromise<McpListResponse> {
+    return this._client.get('/api/v3/mcp/servers', { query, ...options });
+  }
+
   /**
    * Performs a soft delete on a Model Control Protocol (MCP) server, making it
    * unavailable for future use. This operation is reversible in the database but
@@ -83,31 +117,74 @@ export class Mcp extends APIResource {
   ): APIPromise<McpRetrieveAppResponse> {
     return this._client.get(path`/api/v3/mcp/app/${appKey}`, { query, ...options });
   }
+}
 
+/**
+ * MCP server configuration and connection details
+ */
+export interface McpCreateResponse {
   /**
-   * Admin-only endpoint that validates a Model Control Protocol (MCP) server and
-   * retrieves its complete configuration details, including authentication
-   * information. This endpoint is typically used by the MCP service itself to
-   * authenticate and authorize connection requests from clients.
-   *
-   * @example
-   * ```ts
-   * const response = await client.mcp.validate(
-   *   '550e8400-e29b-41d4-a716-446655440000',
-   *   { 'x-composio-admin-token': 'admin_tk_12345abcdef' },
-   * );
-   * ```
+   * UUID of the MCP server instance
    */
-  validate(
-    uuid: string,
-    params: McpValidateParams,
-    options?: RequestOptions,
-  ): APIPromise<McpValidateResponse> {
-    const { 'x-composio-admin-token': xComposioAdminToken } = params;
-    return this._client.get(path`/api/v3/mcp/validate/${uuid}`, {
-      ...options,
-      headers: buildHeaders([{ 'x-composio-admin-token': xComposioAdminToken }, options?.headers]),
-    });
+  id: string;
+
+  /**
+   * Array of tool slugs that this MCP server is allowed to use
+   */
+  allowed_tools: Array<string>;
+
+  /**
+   * ID reference to the auth configuration used by this server
+   */
+  auth_config_id: string;
+
+  /**
+   * Set of command line instructions for connecting various clients to this MCP
+   * server
+   */
+  commands: McpCreateResponse.Commands;
+
+  /**
+   * Date and time when this server was initially created
+   */
+  created_at: string;
+
+  /**
+   * URL endpoint for establishing SSE connection to this MCP server
+   */
+  mcp_url: string;
+
+  /**
+   * User-defined descriptive name for this MCP server
+   */
+  name: string;
+
+  /**
+   * Date and time when this server configuration was last modified
+   */
+  updated_at: string;
+}
+
+export namespace McpCreateResponse {
+  /**
+   * 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;
   }
 }
 
@@ -259,20 +336,10 @@ export namespace McpUpdateResponse {
   }
 }
 
-/**
- * Response indicating the success of the delete operation
- */
-export interface McpDeleteResponse {
-  /**
-   * Indicates whether the MCP server was successfully deleted
-   */
-  success: boolean;
-}
-
 /**
  * Paginated response containing MCP servers
  */
-export interface McpRetrieveAppResponse {
+export interface McpListResponse {
   /**
    * Current page number being returned
    */
@@ -281,7 +348,7 @@ export interface McpRetrieveAppResponse {
   /**
    * Array of MCP server configurations
    */
-  items: Array<McpRetrieveAppResponse.Item>;
+  items: Array<McpListResponse.Item>;
 
   /**
    * Total number of pages in the paginated response
@@ -289,7 +356,7 @@ export interface McpRetrieveAppResponse {
   total_pages: string;
 }
 
-export namespace McpRetrieveAppResponse {
+export namespace McpListResponse {
   /**
    * MCP server configuration and connection details
    */
@@ -361,97 +428,130 @@ export namespace McpRetrieveAppResponse {
 }
 
 /**
- * Complete validation and connection details for an MCP server
+ * Response indicating the success of the delete operation
  */
-export interface McpValidateResponse {
-  /**
-   * Unique identifier of the validated MCP server
-   */
-  id: string;
-
-  /**
-   * Client information for the MCP server
-   */
-  client: McpValidateResponse.Client;
-
+export interface McpDeleteResponse {
   /**
-   * Human-readable name of the MCP server
+   * Indicates whether the MCP server was successfully deleted
    */
-  name: string;
+  success: boolean;
+}
 
+/**
+ * Paginated response containing MCP servers
+ */
+export interface McpRetrieveAppResponse {
   /**
-   * URL endpoint for connecting to this MCP server
+   * Current page number being returned
    */
-  url: string;
+  current_page: string;
 
   /**
-   * User authentication data for the MCP server
+   * Array of MCP server configurations
    */
-  userData: McpValidateResponse.UserData;
+  items: Array<McpRetrieveAppResponse.Item>;
 
   /**
-   * List of action identifiers enabled for this server
+   * Total number of pages in the paginated response
    */
-  actions?: Array<string> | null;
+  total_pages: string;
+}
 
+export namespace McpRetrieveAppResponse {
   /**
-   * List of application identifiers this server is configured for
+   * MCP server configuration and connection details
    */
-  apps?: Array<string>;
+  export interface Item {
+    /**
+     * UUID of the MCP server instance
+     */
+    id: string;
 
-  /**
-   * List of connected account identifiers this server can use for authentication
-   */
-  connectedAccountIds?: Array<string> | null;
+    /**
+     * Array of tool slugs that this MCP server is allowed to use
+     */
+    allowed_tools: Array<string>;
 
-  /**
-   * Flag indicating if this server uses custom authentication headers
-   */
-  customAuthHeaders?: boolean;
+    /**
+     * ID reference to the auth configuration used by this server
+     */
+    auth_config_id: string;
 
-  /**
-   * List of entity identifiers this MCP server can interact with
-   */
-  entityIds?: Array<string> | null;
-}
+    /**
+     * Set of command line instructions for connecting various clients to this MCP
+     * server
+     */
+    commands: Item.Commands;
 
-export namespace McpValidateResponse {
-  /**
-   * Client information for the MCP server
-   */
-  export interface Client {
     /**
-     * Project identifier that owns this MCP server
+     * Date and time when this server was initially created
      */
-    id: string;
+    created_at: string;
 
     /**
-     * Organization identifier that owns the project
+     * URL endpoint for establishing SSE connection to this MCP server
      */
-    orgId: string;
-  }
+    mcp_url: string;
 
-  /**
-   * User authentication data for the MCP server
-   */
-  export interface UserData {
     /**
-     * User identifier for API access
+     * User-defined descriptive name for this MCP server
      */
-    id: string;
+    name: string;
 
     /**
-     * API key for authenticating requests to the Composio API
+     * Date and time when this server configuration was last modified
      */
-    apiKey: string;
+    updated_at: string;
+  }
 
+  export namespace Item {
     /**
-     * Email address associated with the API key user
+     * Set of command line instructions for connecting various clients to this MCP
+     * server
      */
-    email: string;
+    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 McpCreateParams {
+  /**
+   * Human-readable name to identify this MCP server instance (4-25 characters,
+   * alphanumeric and hyphens only)
+   */
+  name: string;
+
+  /**
+   * List of tool slugs that should be allowed for this server. If not provided, all
+   * available tools for the authentication configuration will be enabled.
+   */
+  allowed_tools?: Array<string>;
+
+  /**
+   * ID reference to an existing authentication configuration
+   */
+  auth_config_id?: string;
+
+  /**
+   * Time-to-live duration for this MCP server
+   */
+  ttl?: '1d' | '3d' | '1 month' | 'no expiration';
+}
+
 export interface McpUpdateParams {
   /**
    * List of action identifiers that should be enabled for this server
@@ -470,7 +570,7 @@ export interface McpUpdateParams {
   name?: string;
 }
 
-export interface McpRetrieveAppParams {
+export interface McpListParams {
   /**
    * Filter MCP servers by authentication configuration ID
    */
@@ -497,26 +597,52 @@ export interface McpRetrieveAppParams {
   toolkit?: string;
 }
 
-export interface McpValidateParams {
+export interface McpRetrieveAppParams {
+  /**
+   * Filter MCP servers by authentication configuration ID
+   */
+  auth_config_id?: string;
+
+  /**
+   * Number of items per page (default: 10)
+   */
+  limit?: number | null;
+
   /**
-   * Administrative access token required for validating MCP servers
+   * Filter MCP servers by name (case-insensitive partial match)
+   */
+  name?: string;
+
+  /**
+   * Page number for pagination (1-based)
+   */
+  page_no?: number | null;
+
+  /**
+   * Filter MCP servers by toolkit slug
    */
-  'x-composio-admin-token': string;
+  toolkit?: string;
 }
 
-Mcp.Command = Command;
+Mcp.Custom = Custom;
 
 export declare namespace Mcp {
   export {
+    type McpCreateResponse as McpCreateResponse,
     type McpRetrieveResponse as McpRetrieveResponse,
     type McpUpdateResponse as McpUpdateResponse,
+    type McpListResponse as McpListResponse,
     type McpDeleteResponse as McpDeleteResponse,
     type McpRetrieveAppResponse as McpRetrieveAppResponse,
-    type McpValidateResponse as McpValidateResponse,
+    type McpCreateParams as McpCreateParams,
     type McpUpdateParams as McpUpdateParams,
+    type McpListParams as McpListParams,
     type McpRetrieveAppParams as McpRetrieveAppParams,
-    type McpValidateParams as McpValidateParams,
   };
 
-  export { Command as Command };
+  export {
+    Custom as Custom,
+    type CustomCreateResponse as CustomCreateResponse,
+    type CustomCreateParams as CustomCreateParams,
+  };
 }

package/src/resources/org/project/api-keys.ts

@@ -97,6 +97,12 @@ export interface APIKeyCreateResponse {
   /**
    * UTC timestamp indicating when the API key was created
    */
+  created_at: string;
+
+  /**
+   * @deprecated UTC timestamp indicating when the API key was created. DEPRECATED:
+   * Use created_at instead.
+   */
   createdAt: string;
 
   /**
@@ -114,7 +120,7 @@ export interface APIKeyCreateResponse {
    * UTC timestamp indicating when the API key was last used for authentication. Will
    * be null for newly created keys.
    */
-  lastUsed?: string;
+  last_used_at?: string;
 }
 
 /**
@@ -185,6 +191,12 @@ export interface APIKeyCreateAPIKeyResponse {
   /**
    * UTC timestamp indicating when the API key was created
    */
+  created_at: string;
+
+  /**
+   * @deprecated UTC timestamp indicating when the API key was created. Use
+   * created_at instead.
+   */
   createdAt: string;
 
   /**
@@ -193,6 +205,12 @@ export interface APIKeyCreateAPIKeyResponse {
    */
   key: string;
 
+  /**
+   * @deprecated UTC timestamp indicating when the API key was created. Use
+   * last_used_at instead.
+   */
+  lastUsedAt: string;
+
   /**
    * Name assigned to help identify the key's purpose. For auto-generated keys, this
    * will be a random name.
@@ -203,7 +221,7 @@ export interface APIKeyCreateAPIKeyResponse {
    * UTC timestamp indicating when the API key was last used for authentication. Will
    * be null for newly created keys.
    */
-  lastUsed?: string;
+  last_used_at?: string;
 }
 
 export interface APIKeyCreateParams {

package/src/resources/team-members.ts

@@ -42,7 +42,7 @@ export class TeamMembers extends APIResource {
 export interface TeamMemberUpdateResponse {
   id: string;
 
-  createdAt: string;
+  created_at: string;
 
   email: string;
 
@@ -50,7 +50,7 @@ export interface TeamMemberUpdateResponse {
 
   role: string;
 
-  updatedAt: string;
+  updated_at: string;
 }
 
 export interface TeamMemberListResponse {
@@ -61,7 +61,7 @@ export namespace TeamMemberListResponse {
   export interface Item {
     id: string;
 
-    createdAt: string;
+    created_at: string;
 
     email: string;
 
@@ -69,14 +69,14 @@ export namespace TeamMemberListResponse {
 
     role: string;
 
-    updatedAt: string;
+    updated_at: string;
   }
 }
 
 export interface TeamMemberInviteResponse {
   id: string;
 
-  createdAt: string;
+  created_at: string;
 
   email: string;
 
@@ -84,7 +84,7 @@ export interface TeamMemberInviteResponse {
 
   role: string;
 
-  updatedAt: string;
+  updated_at: string;
 }
 
 export interface TeamMemberRemoveResponse {
@@ -108,7 +108,7 @@ export interface TeamMemberInviteParams {
 
   role: string;
 
-  verifyHost?: string;
+  verify_host?: string;
 }
 
 export declare namespace TeamMembers {

package/src/resources/tools.ts

@@ -45,15 +45,15 @@ export class Tools extends APIResource {
    *
    * @example
    * ```ts
-   * const response = await client.tools.execute('action');
+   * const response = await client.tools.execute('tool_slug');
    * ```
    */
   execute(
-    action: string,
+    toolSlug: string,
     body: ToolExecuteParams | null | undefined = {},
     options?: RequestOptions,
   ): APIPromise<ToolExecuteResponse> {
-    return this._client.post(path`/api/v3/tools/execute/${action}`, { body, ...options });
+    return this._client.post(path`/api/v3/tools/execute/${toolSlug}`, { body, ...options });
   }
 
   /**
@@ -64,17 +64,17 @@ export class Tools extends APIResource {
    *
    * @example
    * ```ts
-   * const response = await client.tools.getInput('actionName', {
+   * const response = await client.tools.getInput('tool_slug', {
    *   text: 'I need to trigger the main workflow in the octocat/Hello-World repository to deploy to production',
    * });
    * ```
    */
   getInput(
-    actionName: string,
+    toolSlug: string,
     body: ToolGetInputParams,
     options?: RequestOptions,
   ): APIPromise<ToolGetInputResponse> {
-    return this._client.post(path`/api/v3/tools/execute/${actionName}/input`, { body, ...options });
+    return this._client.post(path`/api/v3/tools/execute/${toolSlug}/input`, { body, ...options });
   }
 
   /**
@@ -481,13 +481,13 @@ export interface ToolGetInputParams {
    * Custom description of the tool to help guide the LLM in generating more accurate
    * inputs
    */
-  customDescription?: string;
+  custom_description?: string;
 
   /**
    * System prompt to control and guide the behavior of the LLM when generating
    * inputs
    */
-  systemPrompt?: string;
+  system_prompt?: string;
 
   /**
    * Tool version to use when generating inputs (defaults to "latest" if not

package/src/resources/trigger-instances/index.ts

@@ -9,8 +9,11 @@ export {
 } from './handle';
 export {
   TriggerInstances,
+  type TriggerInstanceDeleteResponse,
   type TriggerInstanceListActiveResponse,
+  type TriggerInstanceUpdateStatusResponse,
   type TriggerInstanceUpsertResponse,
   type TriggerInstanceListActiveParams,
+  type TriggerInstanceUpdateStatusParams,
   type TriggerInstanceUpsertParams,
 } from './trigger-instances';