English Français العربية

com.nyx-intelligence/val

Official registry Search and web

QA agent for vibecoded apps. Real browser checks, your AI fixes them. Ship to green.

Source code Website Documentation

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

NPM package @nyx-intelligence/val-mcp
Claude Code 
claude mcp add val -e 'VAL_LICENSE_KEY=<your val_license_key>' -- npx -y @nyx-intelligence/val-mcp@0.10.1
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "val": {
            "command": "npx",
            "args": [
                "-y",
                "@nyx-intelligence/val-mcp@0.10.1"
            ],
            "env": {
                "VAL_LICENSE_KEY": "<your val_license_key>"
            }
        }
    }
}

Environment variables

  • VAL_LICENSE_KEY required secret Your Val license key (vk_...). Subscribe at val.nyx-intelligence.com (4.99 USD per month) if you do not have one.

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. Val QA scan — GitHub Action
  2. Requires a Val subscription
  3. Quick start
  4. Inputs
  5. Outputs
  6. What Val checks
  7. Permissions

Val QA scan — GitHub Action

Run Val, the QA agent for vibecoded apps, on every PR. Val drives a real browser against your preview URL, catches broken links, dead buttons, busted layouts, accessibility violations, and posts a report as a PR comment.

Requires a Val subscription

Val is a paid product. Get a license key at val.nyx-intelligence.com, store it as a repository secret (e.g. VAL_LICENSE_KEY), and pass it to the action.

Quick start

name: Val QA
on: pull_request

jobs:
  qa:
    runs-on: ubuntu-latest
    steps:
      - name: Deploy preview
        id: deploy
        # ... your preview deployment step (Vercel, Netlify, etc.) ...
        # outputs.url should be the preview URL

      - name: Val scan
        uses: nyx-intelligence/val-action@v1
        with:
          url: ${{ steps.deploy.outputs.url }}
          license-key: ${{ secrets.VAL_LICENSE_KEY }}
          devices: 'desktop,iPhone 14'
          fail-on: 'high'

Inputs

NameDefaultDescription
url(required)The URL Val should scan. Pass your preview deployment URL.
license-key(required)Your Val license key (vk_...). Get one at val.nyx-intelligence.com.
max-pages12Maximum same-origin pages to crawl.
devicesdesktopComma-separated device profiles, e.g. desktop,iPhone 14,Pixel 7.
fail-onhighSeverity that fails the action: high, medium, low, or never.
commenttruePost the report as a PR comment (true / false).
github-token${{ github.token }}Token used to post the PR comment.

Outputs

NameDescription
highNumber of high-severity findings.
mediumNumber of medium-severity findings.
lowNumber of low-severity findings.
report-pathPath to the raw report file.

What Val checks

  • Broken links and 4xx/5xx responses
  • Uncaught JS errors and console errors
  • Broken/missing images
  • Horizontal layout overflow on mobile
  • Clipped text in fixed containers
  • Cumulative Layout Shift (janky load)
  • A11y essentials: missing alt, unnamed buttons, unlabeled inputs, missing <html lang>
  • Multi-device: catches bugs that appear only on mobile or only on desktop

Permissions

The action needs pull-requests: write to post comments:

permissions:
  contents: read
  pull-requests: write

Frequently asked questions

What is com.nyx-intelligence/val?

QA agent for vibecoded apps. Real browser checks, your AI fixes them. Ship to green.

How do I install com.nyx-intelligence/val?

It runs on your machine. In Claude Code: claude mcp add val -e 'VAL_LICENSE_KEY=<your val_license_key>' -- npx -y @nyx-intelligence/val-mcp@0.10.1. For other clients, paste the JSON configuration from this page into their MCP settings.

Does com.nyx-intelligence/val need an API key?

Yes. It expects VAL_LICENSE_KEY, which you set in its configuration.

Is com.nyx-intelligence/val open source?

Its code is public on GitHub, but the repository does not declare a standard license.

Who maintains com.nyx-intelligence/val?

It is published by Wakizara. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.