Filter components by numeric scoring thresholds (1-10 scale).

All parameters are optional. Only components passing every specified threshold are returned.

Scoring dimensions:

• visualIntensity: How visually dominant (1=subtle, 10=dramatic)

• animationIntensity: How much animation/motion (1=static, 10=heavy)

• layoutImportance: How critical to page structure (1=decorative, 10=essential)

• customizationEase: How easy to customise (1=rigid, 10=very flexible)

• landingPageFit: Suitability for landing pages (1=poor, 10=perfect)

• dashboardFit: Suitability for dashboards (1=poor, 10=perfect)

• performanceImpact: Runtime cost (1=lightweight, 10=heavy)

Args: min_visual_intensity: Minimum visual intensity (1-10) max_visual_intensity: Maximum visual intensity (1-10) min_animation_intensity: Minimum animation intensity (1-10) max_animation_intensity: Maximum animation intensity (1-10) min_landing_page_fit: Minimum landing page fit (1-10) min_dashboard_fit: Minimum dashboard fit (1-10) max_performance_impact: Maximum performance impact (1-10) min_customization_ease: Minimum customization ease (1-10) include_pro: Include pro components (default True)

Generate a complete page layout with component recommendations.

Analyses the description to detect the page type, selects the best template, and fills each section with recommended components. Returns an ordered layout with install commands and dependency summary.

Supported page types (auto-detected if not specified):

• landing: Conversion-focused landing page

• saas: SaaS product marketing page

• dashboard: Data-rich admin dashboard

• portfolio: Creative portfolio or showcase

• ecommerce: E-commerce product store

• blog: Blog or content publication

• documentation: Documentation or knowledge base

Example descriptions:

• "premium AI SaaS product page with dark theme"

• "fintech dashboard with analytics and charts"

• "designer portfolio with 3D effects"

• "online clothing store with product grid"

• "developer blog with code examples"

Args: page_description: Free-text description of the page to build page_type: Explicit page type (auto-detected if omitted) include_pro: Include pro components (default True) components_per_section: Components per section (default 2, max 10)

Get search cache statistics for monitoring and debugging.

Returns cache performance metrics including:

• size: Current number of cached entries

• max_size: Maximum cache capacity

• hits: Number of cache hits

• misses: Number of cache misses

• evictions: Number of evicted entries

• hit_rate_percent: Cache hit rate as percentage

Use this to monitor cache effectiveness and tune cache parameters.

Get all components in a specific category.

Returns the category info and full summaries of every component that belongs to it.

Args: slug: Category slug (e.g. "hero-sections", "backgrounds", "cards")

Get the full detailed entry for a single component.

Returns ALL metadata including the 60+ word detailed description, purpose, behavior, visual characteristics, dependencies, install commands, props, compatibility, and scoring.

Args: slug: Component slug (e.g. "spotlight", "bento-grid", "hero-parallax")

Get full installation instructions for a component.

Returns the install command, dependencies, registry URL, documentation link, and step-by-step setup instructions.

Args: slug: Component slug (e.g. "spotlight", "sidebar", "bento-grid")

List all component categories with descriptions and component counts.

List all available Aceternity UI components.

Optionally filter by category slug. Returns a compact summary for each component (slug, name, category, tags, summary).

Args: category: Optional category slug (e.g. "hero-sections") include_pro: Include pro-only components (default: True)

Match components to a whole project description.

Similar to recommend_components but biased toward layout-critical components and returns more results for full project planning.

Args: project_description: Project description (e.g. "dashboard with dark mode") max_results: Number of results (default 15, max 100) include_pro: Include pro components (default True)

Recommend a full-page component combination.

Given a project or page description, returns recommended components for each page section: navigation, hero, features, background, cards, CTA, footer, and text effects.

Args: description: Description of the page or project (e.g. "AI SaaS landing page") include_pro: Include pro components (default True)

Recommend components for a specific use case or design goal.

Analyses the description against component metadata, categories, tags, and scoring dimensions to find the best matches.

Example descriptions:

• "premium AI SaaS landing page with dark theme"

• "subtle background effect for a login page"

• "testimonial section for a marketing site"

• "animated hero for a startup landing page"

Args: description: Free-text description of what you need max_results: Number of recommendations to return (default 10, max 100) include_pro: Include pro components (default True)

Search components by text query with optional filters.

Searches across names, descriptions, tags, categories, purposes, behaviors, and visual characteristics. Results are ranked by relevance.

Args: query: Search query (e.g. "animated hero", "dark card") category: Optional category slug to narrow results tags: Optional comma-separated tags to filter by max_results: Max results to return (default 15, max 100) include_pro: Include pro components (default True)