npm @nyx-intelligence/val-mcpstdioupdated 3mo ago
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.
O que dá para fazer com val?
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
| Name | Default | Description |
|---|---|---|
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-pages |
12 |
Maximum same-origin pages to crawl. |
devices |
desktop |
Comma-separated device profiles, e.g. desktop,iPhone 14,Pixel 7. |
fail-on |
high |
Severity that fails the action: high, medium, low, or never. |
comment |
true |
Post the report as a PR comment (true / false). |
github-token |
${{ github.token }} |
Token used to post the PR comment. |
Outputs
| Name | Description |
|---|---|
high |
Number of high-severity findings. |
medium |
Number of medium-severity findings. |
low |
Number of low-severity findings. |
report-path |
Path 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
Instalação
Adicione val ao seu cliente. Escolha o que você usa.
claude mcp add val-mcp -- npx -y @nyx-intelligence/val-mcpcodex mcp add val-mcp -- npx -y @nyx-intelligence/val-mcpamp mcp add val-mcp -- npx -y @nyx-intelligence/val-mcp{
"mcpServers": {
"val-mcp": {
"command": "npx",
"args": [
"-y",
"@nyx-intelligence/val-mcp"
]
}
}
}Add to `claude_desktop_config.json`, then restart Claude Desktop.
{
"mcpServers": {
"val-mcp": {
"command": "npx",
"args": [
"-y",
"@nyx-intelligence/val-mcp"
]
}
}
}Add to `~/.cursor/mcp.json`, or `.cursor/mcp.json` for a single project.
code --add-mcp '{"name":"val-mcp","command":"npx","args":["-y","@nyx-intelligence/val-mcp"]}'Or add the block manually to `.vscode/mcp.json` under `servers`.
{
"mcpServers": {
"val-mcp": {
"command": "npx",
"args": [
"-y",
"@nyx-intelligence/val-mcp"
]
}
}
}Add to `~/.codeium/windsurf/mcp_config.json`.
{
"mcpServers": {
"val-mcp": {
"command": "npx",
"args": [
"-y",
"@nyx-intelligence/val-mcp"
]
}
}
}Add to `cline_mcp_settings.json` via the MCP Servers panel.
{
"mcpServers": {
"val-mcp": {
"command": "npx",
"args": [
"-y",
"@nyx-intelligence/val-mcp"
]
}
}
}Add to `~/.gemini/settings.json`.
{
"mcpServers": {
"val-mcp": {
"type": "local",
"command": "npx",
"args": [
"-y",
"@nyx-intelligence/val-mcp"
],
"tools": [
"*"
]
}
}
}Add to `~/.copilot/mcp-config.json`, or run `/mcp add` inside the CLI.
{
"context_servers": {
"val-mcp": {
"command": {
"path": "npx",
"args": [
"-y",
"@nyx-intelligence/val-mcp"
]
}
}
}
}Add to your Zed `settings.json`.
npx -y @nyx-intelligence/val-mcpRun `goose configure`, choose **Add Extension → Command-line Extension**, and paste this command.
Pontuação
39 / 100
Incompleta
- Documentação17/25
- Manutenção13/25
- Confiança6/20
- Capacidade0/15
- Instalação12/15
- Documents what it does and how to connect
- Has a resolvable package or endpoint
- Exposes at least one tool, prompt or resource
- README has substantive content
- Includes a code example
- Documents its configuration
- Mentions credentials or security posture
- Last commit 96 days ago
- Has a release history
- Repository is not archived
- No licence detected
- Namespace verified in the official MCP registry
- Claimed by its owner
- Published under an organisation
- 0 tool(s) documented
- Provides prompt templates
- Provides resources
- 12 documented install method(s)
- Published to a package registry
- Offers a hosted endpoint — no local install
Histórico de versões
| Versões | Publicada |
|---|---|
| 0.10.1Mais recente | 29 de mai. de 2026 |