Method create

python/composio/core/models/mcp.py:129–232

Create a new MCP server configuration with specified toolkits and authentication settings. :param name: Unique name for the MCP configuration :param toolkits: List of toolkit configurations. Can be either: - MCPToolkitConfig objects with detailed con

(
        self,
        name: str,
        toolkits: t.List[t.Union[ConfigToolkit, str]],
        manually_manage_connections: bool = False,
        allowed_tools: t.Optional[t.List[str]] = None,
    )

        super().__init__(client)

    def create(
        self,
        name: str,
        toolkits: t.List[t.Union[ConfigToolkit, str]],
        manually_manage_connections: bool = False,
        allowed_tools: t.Optional[t.List[str]] = None,
    ) -> MCPCreateResponse:
        """
        Create a new MCP server configuration with specified toolkits and authentication settings.

        :param name: Unique name for the MCP configuration
        :param toolkits: List of toolkit configurations. Can be either:
                        - MCPToolkitConfig objects with detailed configuration
                        - Strings representing toolkit names (for simple cases)
        :param manually_manage_connections: Whether to manually manage account connections (default: False)
        :param allowed_tools: List of specific tools to enable across all toolkits (default: None for all tools)
        :return: Created server details with generate method

        Examples:
            >>> # Using toolkit configuration objects with auth
            >>> server = composio.experimental.mcp.create(
            ...     'personal-mcp-server',
            ...     toolkits=[
            ...         {
            ...             'toolkit': 'github',
            ...             'auth_config_id': 'ac_xyz',
            ...         },
            ...         {
            ...             'toolkit': 'slack',
            ...             'auth_config_id': 'ac_abc',
            ...         },
            ...     ],
            ...     allowed_tools=['GITHUB_CREATE_ISSUE', 'GITHUB_LIST_REPOS', 'SLACK_SEND_MESSAGE'],
            ...     manually_manage_connections=False
            ... )
            >>>
            >>> # Using simple toolkit names (most common usage)
            >>> server = composio.experimental.mcp.create(
            ...     'simple-mcp-server',
            ...     toolkits=['composio_search', 'text_to_pdf'],
            ...     allowed_tools=['COMPOSIO_SEARCH_DUCK_DUCK_GO_SEARCH', 'TEXT_TO_PDF_CONVERT_TEXT_TO_PDF']
            ... )
            >>>
            >>> # Using all tools from toolkits (default behavior)
            >>> server = composio.experimental.mcp.create(
            ...     'all-tools-server',
            ...     toolkits=['composio_search', 'text_to_pdf']
            ...     # allowed_tools=None means all tools from these toolkits
            ... )
            >>>
            >>> # Get server instance for a user
            >>> mcp = server.generate('user_12345')
        """
        if not toolkits:
            raise ValidationError("At least one toolkit configuration is required")

        try:
            # Normalize toolkits to MCPToolkitConfig format