← Home

MCP Server

Connect Include Lens to your assistant or try a tool below.

This checks the app API; it does not check the separate stdio MCP process.

Checking…

Health checks

AppUnavailable
DatabaseUnavailable
BrowserUnavailable
Model guardUnavailable

Tools

Descriptions and inputs are generated from the server’s tool definitions.

include_lens_audit_url

Audit a live URL for WCAG accessibility violations and design-token drift. Deterministic findings (axe-core) are verified; findings marked AI are advisory. Returns a compact report with violations, severity and code fixes.

url: string, viewport?: object, standard?: wcag21aa | wcag22aa, designTokens?: object, skipAi?: boolean, minSeverity?: CRITICAL | HIGH | MEDIUM | LOW | INFO, maxViolations?: number

include_lens_audit_screenshot

Audit a screenshot image for accessibility and design issues. Screenshot-only audits have no DOM, so results are AI-estimated. Provide exactly one absolute imagePath or imageBase64.

imagePath?: string, imageBase64?: string, designTokens?: object, skipAi?: boolean, minSeverity?: CRITICAL | HIGH | MEDIUM | LOW | INFO, maxViolations?: number

include_lens_get_audit

Retrieve a previous audit by ID with violations and fix suggestions.

auditId: string, minSeverity?: CRITICAL | HIGH | MEDIUM | LOW | INFO, maxViolations?: number, includeDismissed?: boolean

include_lens_get_fixes

Get code fix suggestions for specific violation IDs. Set generateMissing to request and store missing fixes; this may use AI.

violationIds: array, generateMissing?: boolean

include_lens_validate_code

Validate an HTML or JSX/TSX snippet for accessibility violations without capturing a full page. Deterministic (axe-core); JSX is converted statically, so dynamic content is replaced by placeholders.

code: string, language: html | jsx | tsx, standard?: wcag21aa | wcag22aa

include_lens_list_audits

List recent audits with status, score and violation counts.

limit?: number, status?: PENDING | CAPTURING | ANALYZING | COMPLETED | FAILED | CANCELLED | RUNNING, url?: string

Client configuration

Replace the executable path with the absolute path on your machine. Keep your token private.

{
  "mcpServers": {
    "include-lens": {
      "command": "node",
      "args": [
        "/absolute/path/to/include-lens/dist/start-mcp.js"
      ],
      "env": {
        "INCLUDE_LENS_API_URL": "http://127.0.0.1:3000",
        "INCLUDE_LENS_API_TOKEN": "<INCLUDE_LENS_API_TOKEN>"
      }
    }
  }
}

Automatic token copying is disabled because this deployment cannot verify the network peer. Copy INCLUDE_LENS_API_TOKEN from .env.local manually.

Resources

Prompts

audit-page
Audit the page at {{url}} using include_lens_audit_url. Focus on {{focusArea}}. Report violations sorted by severity, and distinguish verified (axe/drift) findings from AI-advisory ones.
fix-violations
Using include_lens_get_audit for audit {{auditId}}, review the critical and high severity violations and propose a single change set that fixes them. Fix verified findings first. Treat AI-advisory findings as suggestions to confirm. After applying changes, re-run the audit and report the score change.
design-review
Read include-lens://design-tokens, then audit {{url}} with include_lens_audit_url and report all design-drift violations, grouped by token category.

Install

  1. Run npm run setup.
  2. Run npm run build:mcp.
  3. Add the configuration above to your MCP client.

The Include Lens app must be running for tools to work.