{
  "schema_version": 1,
  "server_id": "hyperiux-immersion-labs-hyperiux-mcp-server",
  "package": "hyperiux-mcp-server",
  "version": "0.3.0",
  "collected_at": "2026-11-17T00:39:16.226Z",
  "analyzed_at": "2026-11-17T00:39:16.226Z",
  "modelara_version": "v0.1.8",
  "fingerprint": "sha256:7a35236c81de388023ef0a8f90ed77a57ba85dc5708d64b53e429060dba41f99",
  "tool_count": 3,
  "interface": {
    "format": "modelara.inspect/v0",
    "capability_set": {
      "source": {
        "type": "mcp",
        "name": "hyperiux-mcp-server",
        "version": "0.3.0",
        "protocol_version": "2025-11-25"
      },
      "discovered_at": "2026-11-17T00:39:15.912269487Z",
      "capabilities": [
        {
          "id": "mcp:hyperiux-mcp-server/hyperiux_get_effect",
          "name": "hyperiux_get_effect",
          "title": "Get Hyperiux Effect Details",
          "description": "Get full details for one Hyperiux Vault effect by its exact slug - description, tier (free/pro), npm dependencies, version, changelog, and install instructions. Optionally includes full source code.\n\nArgs:\n  - name (string): exact effect slug\n  - include_source (boolean, default false): also return component source. Needs a signed-in account for every effect (see below) and counts as one of the day's installs; details-only lookups (false) don't.\n\nReturns JSON: { name, title, description, tier, version, dependencies, changelog, install_command, preview_url, import_path, target, main, import_statement, files: [{ path, content? }] }\n  - changelog: array of { version, date, summary, breaking }, newest first\n  - files[].content is omitted unless include_source=true AND the caller is signed in (and on Pro, for a Pro effect)\n  - import_statement is the exact import line to use after installing (e.g. `import DottedGrid from \"@/components/effects/dotted-grid\";`), built from exportKind/exportName/import_path the same way the CLI's own `hyperiux add` output does - omitted if the registry entry has no import_path\n  - install_limit/install_remaining: present on a normal (non-rate-limited) lookup, telling you how many more distinct effects this identity can fetch today - mention this to the user when remaining is low, same as the website's copy toast and the CLI's own \"N of M daily installs left\" line\n\nNo token (or an invalid one) with include_source=true: the response still includes metadata, but files have no content and sign_in_required/sign_in_required_reason tell the user to run `npx hyperiux login` - every install needs a free account. Don't retry; ask the user to sign in.\n\nPro effects without a Pro subscription: metadata only, and source_locked explains the effect needs Hyperiux Pro - expected, not an error.\n\nFree effects past the caller's daily install cap: the response still includes metadata but files have no content, and rate_limited/rate_limit_reason explain the daily limit and when to retry - also not an error, it's expected once the cap is hit.\n\nExamples:\n  - \"What does the dotted-grid effect need?\" -> name=\"dotted-grid\" (dependencies field)\n  - \"Show me the code for dotted-grid\" -> name=\"dotted-grid\", include_source=true\n  - Don't use when: you don't have an exact slug yet - use hyperiux_list_effects first.\n\nError Handling:\n  - Returns \"Effect '<name>' not found\" if the slug doesn't exist - check hyperiux_list_effects for the correct spelling.",
          "source": {
            "type": "mcp",
            "server": "hyperiux-mcp-server",
            "operation": "hyperiux_get_effect"
          },
          "input_schema": {
            "$schema": "http://json-schema.org/draft-07/schema#",
            "additionalProperties": false,
            "properties": {
              "include_source": {
                "default": false,
                "description": "Include full component source in the response. Needs a signed-in Hyperiux account for every effect, free ones included (HYPERIUX_TOKEN env var, or a saved `hyperiux login` session); Pro effects also need a Pro subscription. Fetching source counts as one of the day's installs; leave it false for a details-only lookup.",
                "type": "boolean"
              },
              "name": {
                "description": "Exact effect slug, e.g. 'dotted-grid', 'rectangular-text-reveal'. Get this from hyperiux_list_effects.",
                "minLength": 1,
                "type": "string"
              }
            },
            "required": [
              "name"
            ],
            "type": "object"
          },
          "declared": {
            "read_only": "true",
            "destructive": "false",
            "idempotent": "true",
            "open_world": "true"
          },
          "effects": {
            "kind": "read",
            "destructive": "false",
            "external": "true"
          },
          "safety": {
            "idempotent": "true",
            "retry_safe": "true"
          },
          "effect_assessment": {
            "kind": "read",
            "basis": "declared"
          },
          "metadata": {
            "mcp.annotations": "present"
          },
          "fingerprint": "sha256:0c3ad2fe9749a02ab3c309a3cc044537707f8bad37d562b0f25a10b040fd932f"
        },
        {
          "id": "mcp:hyperiux-mcp-server/hyperiux_list_categories",
          "name": "hyperiux_list_categories",
          "title": "List Hyperiux Effect Categories",
          "description": "List every effect category in the Hyperiux Vault catalog with how many effects are in each - useful before calling hyperiux_list_effects with a category filter, to confirm the exact category slug and see relative size.\n\nReturns JSON: { categories: [{ category, count }] }, sorted by count descending.\n\nExamples:\n  - \"What kinds of effects does Hyperiux have?\" -> call with no args\n  - Don't use when: you already know the category slug and just want its effects - call hyperiux_list_effects directly.",
          "source": {
            "type": "mcp",
            "server": "hyperiux-mcp-server",
            "operation": "hyperiux_list_categories"
          },
          "input_schema": {
            "$schema": "http://json-schema.org/draft-07/schema#",
            "properties": {},
            "type": "object"
          },
          "declared": {
            "read_only": "true",
            "destructive": "false",
            "idempotent": "true",
            "open_world": "true"
          },
          "effects": {
            "kind": "read",
            "destructive": "false",
            "external": "true"
          },
          "safety": {
            "idempotent": "true",
            "retry_safe": "true"
          },
          "effect_assessment": {
            "kind": "read",
            "basis": "declared"
          },
          "metadata": {
            "mcp.annotations": "present"
          },
          "fingerprint": "sha256:818d54ebc7cdc2209cc19431f1daf69c59c45b544fa8ac20e2446a001ac7ee7a"
        },
        {
          "id": "mcp:hyperiux-mcp-server/hyperiux_list_effects",
          "name": "hyperiux_list_effects",
          "title": "List Hyperiux Vault Effects",
          "description": "Browse or search the Hyperiux Vault catalog of React/Next.js interaction effects (scroll systems, cursor trails, WebGL scenes, animated buttons, page transitions, etc).\n\nEach result includes tier (\"free\" or \"pro\") - use this to answer \"how many free/pro effects are there\" or \"which of these are free\" directly from one call, by filtering/counting the returned list yourself. Don't estimate or guess these counts, and don't call hyperiux_get_effect per-item just to total them up - it's unnecessary here. hyperiux_get_effect is still the right call for one specific effect's full description/props/changelog.\n\nArgs:\n  - query (string, optional): substring match against effect name\n  - category (string, optional): filter to one category slug\n  - limit (number, default 30, max 100)\n  - offset (number, default 0)\n\nReturns JSON: { total, count, offset, effects: [{ name, category, categories, dependencies, version, tier }], has_more, next_offset? }\n\nExamples:\n  - \"What cursor effects are available?\" -> category=\"cursor\"\n  - \"Is there anything with 'particles' in the name?\" -> query=\"particles\"\n  - \"How many free effects are there?\" -> call with a limit high enough to cover total (check total/has_more first), then count tier === \"free\" yourself.\n  - Don't use when: you need one effect's full description/props/changelog - use hyperiux_get_effect instead.",
          "source": {
            "type": "mcp",
            "server": "hyperiux-mcp-server",
            "operation": "hyperiux_list_effects"
          },
          "input_schema": {
            "$schema": "http://json-schema.org/draft-07/schema#",
            "additionalProperties": false,
            "properties": {
              "category": {
                "description": "Filter to one category, e.g. 'text', 'cursor', 'scroll', 'webgl', 'buttons', 'carousels', 'components', 'navigation', 'backgrounds', 'loaders', 'transitions'. Use hyperiux_list_categories to see all valid values with counts.",
                "type": "string"
              },
              "limit": {
                "default": 30,
                "description": "Maximum results to return.",
                "maximum": 100,
                "minimum": 1,
                "type": "integer"
              },
              "offset": {
                "default": 0,
                "description": "Number of results to skip for pagination.",
                "minimum": 0,
                "type": "integer"
              },
              "query": {
                "description": "Case-insensitive substring match against effect name (e.g. 'cursor', 'text-reveal'). Omit to list all.",
                "maxLength": 200,
                "type": "string"
              }
            },
            "type": "object"
          },
          "declared": {
            "read_only": "true",
            "destructive": "false",
            "idempotent": "true",
            "open_world": "true"
          },
          "effects": {
            "kind": "read",
            "destructive": "false",
            "external": "true"
          },
          "safety": {
            "idempotent": "true",
            "retry_safe": "true"
          },
          "effect_assessment": {
            "kind": "read",
            "basis": "declared"
          },
          "metadata": {
            "mcp.annotations": "present"
          },
          "fingerprint": "sha256:c450738f10b3d8023c3bb4c6b5b3a558ffc0486abdc7c02f4207b7dac62cf3ba"
        }
      ],
      "discovery_order": [
        "mcp:hyperiux-mcp-server/hyperiux_list_effects",
        "mcp:hyperiux-mcp-server/hyperiux_get_effect",
        "mcp:hyperiux-mcp-server/hyperiux_list_categories"
      ],
      "fingerprint": "sha256:7a35236c81de388023ef0a8f90ed77a57ba85dc5708d64b53e429060dba41f99"
    },
    "summary": {
      "total": 3,
      "read_only": 3,
      "potential_writes": 0,
      "destructive": 0,
      "unknown_effects": 0,
      "retry_safe": 3
    },
    "schema_stats": {
      "mcp:hyperiux-mcp-server/hyperiux_get_effect": {
        "input": {
          "properties": 2,
          "required": 1,
          "total_properties": 2,
          "nested_objects": 0,
          "arrays": 0,
          "max_depth": 1,
          "combinators": 0,
          "refs": 0,
          "complexity": 2
        }
      },
      "mcp:hyperiux-mcp-server/hyperiux_list_categories": {
        "input": {
          "properties": 0,
          "required": 0,
          "total_properties": 0,
          "nested_objects": 0,
          "arrays": 0,
          "max_depth": 0,
          "combinators": 0,
          "refs": 0,
          "complexity": 0
        }
      },
      "mcp:hyperiux-mcp-server/hyperiux_list_effects": {
        "input": {
          "properties": 4,
          "required": 0,
          "total_properties": 4,
          "nested_objects": 0,
          "arrays": 0,
          "max_depth": 1,
          "combinators": 0,
          "refs": 0,
          "complexity": 4
        }
      }
    }
  },
  "source": {
    "registry": "npm",
    "package": "hyperiux-mcp-server",
    "version": "0.3.0",
    "published_at": "2026-10-19T12:43:45.858Z",
    "integrity": "sha512-8ux6N3Jat79Dla+IcEHOk7MUC5s9cLhm+XUXcv0Zfbq7BWXDcenp0q/HnXztfJu+gzFL/8gZG4nwJ4F/6qW5Xg==",
    "repository": "https://github.com/Hyperiux-Immersion-Labs/hyperiux-components"
  },
  "analyzer": {
    "name": "modelara",
    "version": "v0.1.8",
    "policy_version": null
  },
  "capability_hash_version": 2,
  "capability_hashes": {
    "hyperiux-immersion-labs-hyperiux-mcp-server:tool:hyperiux_get_effect": {
      "description": "sha256:51e6e8f2bb62c4081184560d04065d0227ac4493dd417ab7869409976ee536ec",
      "input_schema": "sha256:fde1ae410af7e3bae94330baf3d933b55f0374e3005fe6d2eb18e40e59d561a8",
      "output_schema": "sha256:398b676e47d03a29016ee92fe378b8b4f1b3e965390c4c64ce78d27f79df74d1",
      "interface": "sha256:05f7f4955829b34ae0342e882cf141334d4622fcb0591da675001993ae7d702e"
    },
    "hyperiux-immersion-labs-hyperiux-mcp-server:tool:hyperiux_list_categories": {
      "description": "sha256:805b282ba186eaf503717f656151ce78f9968cc399efc0c9d85dbfcbf399c006",
      "input_schema": "sha256:73fc3af6ba54a1293c44f954cf944c40d069a764ef7974e6fc74addd4231b225",
      "output_schema": "sha256:398b676e47d03a29016ee92fe378b8b4f1b3e965390c4c64ce78d27f79df74d1",
      "interface": "sha256:d7115428db1574aed217fae2994a71224cda3ef24180a3e2ae5eca28a0f8e225"
    },
    "hyperiux-immersion-labs-hyperiux-mcp-server:tool:hyperiux_list_effects": {
      "description": "sha256:06537a29fd1c15792727c91380414bca45359a1f436ed3f73cc42f5dca709bcb",
      "input_schema": "sha256:84fec8d511f23c54fc0152cbc1e2301b6694c7628eddfc04e7e33bc792a16589",
      "output_schema": "sha256:398b676e47d03a29016ee92fe378b8b4f1b3e965390c4c64ce78d27f79df74d1",
      "interface": "sha256:b7fd6e0e3744eb49980b574460ac98a8a0dfaa65d8de1e66c43a954d2390a744"
    }
  }
}
