# GridProof (npm · gridproof)

Gridproof your UI — automated spacing & grid QA in the agent loop (MCP server).

- Trust score: 69/100 (medium)
- Registry status: active
- Liveness: live
- Owner verified: no
- Last scored: 2026-08-17

## Components

- npm · `gridproof`: 69/100 (this document), [markdown](https://verifymcp.io/servers/gridproof-gridproof/gridproof.md), [page](https://verifymcp.io/servers/gridproof-gridproof/gridproof)

## Channel facts

- Registry: `npm`
- Package: `gridproof`
- Version: `0.1.3`
- Transport: `stdio`

## Trust breakdown

How this component scores in each security and reliability category. Every signal is checked automatically from public evidence about the published package, including repeated runs of it in an isolated sandbox, and we only credit what we can confirm. Scores are 0–100 per category. Scoring method: https://verifymcp.io/docs/scoring (what has changed: https://verifymcp.io/docs/scoring/changelog)

Scored 2026-08-17.

- **Supply Chain Security**: 98/100
  - No malware found by supply-chain analysis.
  - No known CVEs affecting this package version or its production dependencies.
  - No install/post-install scripts declared.
  - 31 of 99 dependencies flagged as unhealthy.
- **Provenance & Transparency**: 45/100
  - Source repository is publicly reachable at the declared URL.
  - Provenance check failed: no build-provenance attestation is published.
  - Clear OSI-approved license (MIT).
  - Actively maintained (last published 3 days ago).
  - Security-disclosure policy not yet verified: we couldn't inspect the source repository.
- **Schema Quality & AI Usability**: 80/100
  - AI-judged instruction clarity (excellent).
  - Tool/resource definitions use about 485 tokens (~121/item across 4 items; 4 tools + 0 resources), lean.
  - Usage-examples check failed: none of the tools include examples.
- **Stability & Change Management**: 0/100
  - Stability not yet verified: not enough scan history yet (needs a 30-day window).
- **Tool Coverage**: 100/100
  - 100% of tools have a non-trivial description (not blank, and not just the tool's name).
  - 100% of tool parameters carry a description.
- **Capabilities**: 100/100
  - Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.

**Unverified: 1 category.** A category scored 0 because we could not verify it: a data source with nothing on this package, evidence we could not reach, or a check we could not run. We only credit what we can confirm.

## Install

### Claude

```bash
claude mcp add gridproof-gridproof -- npx -y gridproof
```

### Codex

```bash
codex mcp add gridproof-gridproof -- npx -y gridproof
```

### opencode

```json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "gridproof-gridproof": {
      "type": "local",
      "command": [
        "npx",
        "-y",
        "gridproof"
      ],
      "enabled": true
    }
  }
}
```

### OpenClaw

```bash
openclaw mcp add gridproof-gridproof --command npx --arg -y --arg gridproof
```

### Hermes

```yaml
mcp_servers:
  gridproof-gridproof:
    command: "npx"
    args: ["-y", "gridproof"]
```

### Other

```json
{
  "mcpServers": {
    "gridproof-gridproof": {
      "command": "npx",
      "args": [
        "-y",
        "gridproof"
      ]
    }
  }
}
```

## Changelog

Every change recorded for this component, newest first. Days that predate change tracking, or that we cannot explain, say so: "we were watching and nothing happened" and "we were not watching" are different claims.

### 2026-08-17 (score 69, 0)

- [functional regression] Security disclosure: fail → unverified

### 2026-08-15 (score 69, +10)

- [security improvement] Known CVEs: unverified → pass
- [functional improvement] Dependency health: unverified → 0.86

### 2026-08-14 (score 59, −10)

- [security regression] Known CVEs: pass → unverified
- [functional regression] Dependency health: 0.86 → unverified
- [functional] Package version: 0.1.2 → 0.1.3

### 2026-08-13 (score 69)

First indexed and scored.

## MCP tools (4)

### `gp_audit` (~145 tokens)

Gridproof: audit a URL

Render a running frontend and audit its spacing/grid geometry against the spacing-scale and arbitrary-value rules. Returns a structured AuditReport (violations with fix hints) plus a text summary.

Input parameters:

- `maxViolations` (integer): Cap report size to protect agent context window.
- `rules` (array): Subset of rules to run. Default: all enabled in config.
- `selector` (string): Limit audit to a DOM subtree, e.g. '#main'. Default: body.
- `url` (string, required): URL of the running frontend, e.g. http://localhost:5173
- `viewport` (object): Viewport for this audit pass. Run once per breakpoint.

### `gp_check_element` (~97 tokens)

Gridproof: re-check one element

Re-check a single element's subtree after a fix, without re-running the full audit. Returns the violations found under that selector.

Input parameters:

- `selector` (string, required): CSS selector of the single element (subtree) to re-check.
- `url` (string, required): URL of the running frontend, e.g. http://localhost:5173
- `viewport` (object): Viewport for this check. Defaults to 1440×900.

### `gp_get_config` (~71 tokens)

Gridproof: get resolved config

Return the effective Gridproof configuration (defaults merged with gridproof.config.json if present): baseUnit, allowedValues, canonicalSizes, minTapTarget, rule severities, suppressions.

Input parameters:

- `cwd` (string): Directory to search upward from for gridproof.config.json. Defaults to the server's working directory.

### `gp_report` (~172 tokens)

Gridproof: audit + write HTML report

Render a URL, audit its spacing/grid geometry, and WRITE a self-contained HTML report to disk (default ./gridproof-report.html). Returns the file path plus the same AuditReport JSON as gp_audit.

Input parameters:

- `maxViolations` (integer): Cap report size to protect agent context window.
- `outputPath` (string): Where to write the HTML report. Default: ./gridproof-report.html
- `rules` (array): Subset of rules to run. Default: all enabled in config.
- `selector` (string): Limit audit to a DOM subtree, e.g. '#main'. Default: body.
- `url` (string, required): URL of the running frontend, e.g. http://localhost:5173
- `viewport` (object): Viewport for this audit pass. Run once per breakpoint.

## Diagnostics

Captured diagnostic sections: Provenance, Dependencies. The full working is on the page: https://verifymcp.io/servers/gridproof-gridproof/gridproof#diagnostics

## Score history

- 2026-08-17: 69
- 2026-08-16: 69
- 2026-08-15: 69
- 2026-08-14: 59
- 2026-08-13: 69

## Links

- npm package: https://www.npmjs.com/package/gridproof
- Socket report: https://socket.dev/npm/package/gridproof
- Repository: https://github.com/gridproof/gridproof
- Website: https://www.npmjs.com/package/gridproof
- Changelog RSS feed: https://verifymcp.io/servers/gridproof-gridproof/gridproof.xml
- Changelog JSON feed: https://verifymcp.io/servers/gridproof-gridproof/gridproof.json
- HTML version of this page: https://verifymcp.io/servers/gridproof-gridproof/gridproof