# Unofficial MCP Server for USWDS (npm · uswds-mcp)

Unofficial USWDS MCP: official markup, class-aware validator, and page composer for AI tools.

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

## Components

- npm · `uswds-mcp`: 67/100 (this document), [markdown](https://verifymcp.io/servers/bibekpdl-uswds-mcp/uswds-mcp.md), [page](https://verifymcp.io/servers/bibekpdl-uswds-mcp/uswds-mcp)

## Channel facts

- Registry: `npm`
- Package: `uswds-mcp`
- Version: `0.2.0`
- 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-10-17.

- **Supply Chain Security**: 98/100
  - No malware found by supply-chain analysis.
  - A known CVE affects braces, but no fixed version has been published, so there is nothing to upgrade to.
  - No install/post-install scripts declared.
  - 53 of 150 dependencies flagged as unhealthy (1 deprecated).
- **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 7 days ago).
  - Disclosure check failed: no security disclosure policy was found in the source repository.
- **Schema Quality & AI Usability**: 71/100
  - 98% of prompts and resources have a non-trivial description (not blank, and not just the item's name).
  - AI-judged instruction clarity (fair).
  - Tool/resource definitions use about 6433 tokens (~36/item across 176 items; 12 tools + 164 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**: 70/100
  - 100% of tools have a non-trivial description (not blank, and not just the tool's name).
  - 11% of tool parameters carry a description.
- **Tool Safety**: 100/100
  - No prompt-injection markers were found in the server instructions, tool names or descriptions we captured.
  - We read all 12 captured tool definition(s), and no name or description among them implies an irreversible operation.
  - An AI judge read all 13 captured unit(s) of tool text and found none that tries to manipulate the model reading it.
- **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

### How do I install the Unofficial MCP Server for USWDS server?

Unofficial MCP Server for USWDS runs locally as an npm package, launched with npx -y uswds-mcp. Ready-made configuration for Claude, Cursor, VS Code, Codex and 5 more is on this page, copied from each client's own documentation.

### Claude

```bash
claude mcp add bibekpdl-uswds-mcp -- npx -y uswds-mcp
```

### Cursor

```json
{
  "mcpServers": {
    "bibekpdl-uswds-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "uswds-mcp"
      ]
    }
  }
}
```

### VS Code

```json
{
  "servers": {
    "bibekpdl-uswds-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "uswds-mcp"
      ]
    }
  }
}
```

### Codex

```bash
codex mcp add bibekpdl-uswds-mcp -- npx -y uswds-mcp
```

### opencode

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

### OpenClaw

```bash
openclaw mcp add bibekpdl-uswds-mcp --command npx --arg -y --arg uswds-mcp
```

### Hermes

```yaml
mcp_servers:
  bibekpdl-uswds-mcp:
    command: "npx"
    args: ["-y", "uswds-mcp"]
```

### Netclaw

```json
{
  "McpServers": {
    "bibekpdl-uswds-mcp": {
      "Transport": "stdio",
      "Command": "npx",
      "Arguments": [
        "-y",
        "uswds-mcp"
      ]
    }
  }
}
```

### Vellum

```bash
assistant mcp add bibekpdl-uswds-mcp -t stdio -c npx -a -y uswds-mcp
```

### Other

```json
{
  "mcpServers": {
    "bibekpdl-uswds-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "uswds-mcp"
      ]
    }
  }
}
```

## 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-10-13 (score 67, +29)

- [security improvement] Injection markers: unverified → pass
- [security] First check of Judged manipulation: pass
- [security] Stability: Stability not yet verified: not enough scan history yet (needs a 30-day window).
- [functional improvement] Tool coverage: unverified → 100
- [functional improvement] Schema quality: unverified → 98
- [functional improvement] MCP protocol: unverified → pass
- [functional] First check of Tool coverage: 11
- [functional] First check of Schema quality: fail
- [functional] First check of Schema quality: fair
- [functional] First check of Destructive annotations: pass
- [functional] First check of Schema quality: pass

### 2026-10-12 (score 38)

First indexed and scored.

## MCP tools (12)

### `search_uswds` (~41 tokens)

Search USWDS

Search structured USWDS docs and implementation records.

Input parameters:

- `limit` (integer)
- `query` (string, required)
- `types` (array)

### `get_component` (~45 tokens)

Get USWDS Component

Return component guidance (usage, accessibility, variants) plus the official canonical HTML for the default variant. Call this before writing any component markup.

Input parameters:

- `slug_or_name` (string, required)

### `get_pattern` (~26 tokens)

Get USWDS Pattern

Return structured pattern guidance and related implementation notes.

Input parameters:

- `slug_or_name` (string, required)

### `get_template` (~25 tokens)

Get USWDS Template

Return structured template guidance and markup references.

Input parameters:

- `slug_or_name` (string, required)

### `recommend_uswds_structure` (~63 tokens)

Recommend USWDS Structure

Recommend a USWDS-first page or site structure for an agency service.

Input parameters:

- `agency_type` (string, required)
- `audience` (string, required)
- `constraints` (string)
- `framework` (string)
- `service_goal` (string, required)

### `generate_uswds_page` (~103 tokens)

Generate USWDS Page

Quick starting point: infer sections from free-text requirements and generate a validated USWDS page with [bracketed] placeholders. For real content prefer compose_uswds_page.

Input parameters:

- `agency_context` (string, required)
- `asset_path` (string): URL prefix where USWDS dist assets are served (default /uswds)
- `content_requirements` (string, required)
- `framework` (string)
- `page_type` (string, required)

### `validate_uswds_markup` (~78 tokens)

Validate USWDS Markup

Validate HTML against real USWDS class names, component structure (BEM, required children, ARIA wiring), forms, and accessibility basics. Fragment-aware. Fix every error before finalizing.

Input parameters:

- `html` (string, required)
- `mode` (string): auto detects full pages vs fragments
- `page_context` (string)

### `get_component_markup` (~135 tokens)

Get Canonical USWDS Markup

Return the official, verified USWDS HTML for a component or page template (rendered from the official @uswds/uswds templates). Use this instead of writing usa-* markup from memory. Call with no arguments to list everything available.

Input parameters:

- `all_variants` (boolean)
- `asset_path` (string): URL prefix where USWDS dist assets are served (default /uswds)
- `component` (string): Component or page-template name, e.g. accordion, button, footer, sign-in
- `variant` (string): Variant such as bordered, slim, big, outline, error

### `compose_uswds_page` (~134 tokens)

Compose USWDS Page

Build a complete, accessible USWDS page from structured sections (hero, content, alert, summary_box, card_group, process_list, step_indicator, accordion, table, form, contact). Output mirrors official markup and is validated automatically.

Input parameters:

- `agency` (string, required)
- `asset_path` (string)
- `breadcrumbs` (array)
- `contact` (object)
- `include_identifier` (boolean)
- `lang` (string)
- `nav_links` (array)
- `parent_agency` (string)
- `sections` (array)
- `title` (string, required)

### `find_uswds_classes` (~67 tokens)

Find USWDS Classes

Look up real USWDS class names, including utilities and responsive variants (e.g. "margin top 2", "tablet grid col 6", "bg primary lighter"). Prevents invented class names.

Input parameters:

- `limit` (integer)
- `query` (string, required)

### `get_uswds_integration_recipe` (~58 tokens)

Get USWDS Integration Recipe

Return framework-specific USWDS setup guidance for npm, assets, JavaScript, CSS, and migration.

Input parameters:

- `framework` (string, required)
- `migration_scope` (string)
- `no_cdn` (boolean)

### `validate_uswds_project_setup` (~88 tokens)

Validate USWDS Project Setup

Check provided project files for common USWDS framework integration issues such as import paths, assets, scripts, CDN usage, and global CSS risk.

Input parameters:

- `file_paths` (array)
- `files` (object)
- `framework` (string)
- `migration_scope` (string)
- `no_cdn` (boolean)
- `package_json` (string)

## Diagnostics

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

## Score history

- 2026-10-17: 67
- 2026-10-16: 67
- 2026-10-15: 67
- 2026-10-14: 67
- 2026-10-13: 67
- 2026-10-12: 38

## Common questions

### What is the Unofficial MCP Server for USWDS server?

Unofficial MCP Server for USWDS is listed in the public MCP registry as io.github.bibekpdl/uswds-mcp. Unofficial USWDS MCP: official markup, class-aware validator, and page composer for AI tools. This page covers its npm package (uswds-mcp).

### Is the Unofficial MCP Server for USWDS server safe to use?

Unofficial MCP Server for USWDS scores 67 out of 100 on VerifyMCP. We recorded 2 known advisories against it as of 17 October 2026. It declares no install or post-install scripts. That is a record of what we were able to check automatically, not an endorsement. The category breakdown on this page shows every signal behind the number, including the ones we could not confirm.

### What tools does the Unofficial MCP Server for USWDS server expose?

Unofficial MCP Server for USWDS exposes 12 tools: search_uswds, get_component, get_pattern, get_template, recommend_uswds_structure, and 7 more. Their descriptions and schemas cost roughly 863 tokens of context every time the server is loaded.

### Is the Unofficial MCP Server for USWDS server still maintained?

Unofficial MCP Server for USWDS is still listed as active in the MCP registry. We last reached this channel on 17 October 2026. Those dates come from our own scans of the registry and the channel itself, not from anything the publisher announced.

### What licence is the Unofficial MCP Server for USWDS server under?

Unofficial MCP Server for USWDS declares the MIT licence, which is OSI-approved. That covers the source only, and says nothing about the cost of any service it calls.

## Links

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