PageLens AI — MCP Server

AI agents can run senior-level website audits in seconds.

An MCP (Model Context Protocol) server that gives AI agents direct access to PageLens AI — automated website reviews covering UX, SEO, Performance, Accessibility, Security, and Conversion.

Plug it into Cursor, Claude, or any MCP-compatible client and your agent can read scan results, drill into findings, surface quick wins, and close the fix loop — all without leaving the IDE.

MCP Endpoint

https://www.pagelensai.com/api/mcp

This is a remote MCP server — no local install required.

Quick Start

Cursor

Add to your ~/.cursor/mcp.json (or workspace .cursor/mcp.json):

{
  "mcpServers": {
    "pagelens": {
      "url": "https://www.pagelensai.com/api/mcp"
    }
  }
}

Claude Desktop

Add to claude_desktop_config.json:

{
  "mcpServers": {
    "pagelens": {
      "url": "https://www.pagelensai.com/api/mcp"
    }
  }
}

Authentication

This server uses OAuth 2.0. Your MCP client will open a browser window to authorize with your PageLens account on first connect. No API keys to manage.

Scopes granted on authorization:

Scope	What it unlocks
`read:scans`	List and read your scan results
`read:findings`	Read findings and quick wins
`write:feedback`	Submit false-positive reports

Available Tools

`whoami`

Confirm which PageLens account this MCP session is operating on, plus granted OAuth scopes.

{}

`list_domains`

List the domains you've verified ownership of, along with badge tier and the scan currently anchored to the public badge.

{
  "include_unverified": false
}

`list_scans`

List your most recent PageLens scans. Filter by status, domain, or date. Returns a slim summary per scan (id, URL, score, grade, severity counts).

{
  "limit": 20,
  "status": "COMPLETE",
  "domain": "example.com",
  "since": "2026-01-01T00:00:00Z"
}

Status values: PENDING · RUNNING · COMPLETE · FAILED · CANCELLED

`get_scan`

Read the full summary for a single scan: score, grade, severity counts, executive summary, top-5 highest-priority findings, and per-persona reviews.

{
  "scan_id": "clxxxxxxxxxxxxxxx"
}

`list_findings`

Page through all findings for a scan. Filter by severity, category, persona, page URL, or rule ID. Use format: "full" to include descriptions, suggestions, and evidence.

{
  "scan_id": "clxxxxxxxxxxxxxxx",
  "severity": "HIGH",
  "category": "SECURITY",
  "format": "full",
  "limit": 50
}

Severity levels: CRITICAL · HIGH · MEDIUM · LOW · INFO

Categories: UX · SEO · PERFORMANCE · ACCESSIBILITY · SECURITY · CONTENT · HEADERS · DESIGN · ERROR

Personas: MARKETER · CRO · UX · ACCESSIBILITY · BRAND · EXECUTIVE · PERFORMANCE · SEO

`get_quick_wins`

Return the top N quick-win findings — high impact, low-to-moderate effort — ranked by the same Impact × Effort scorer used in the PageLens dashboard. Optionally override the scan's preset to re-rank under a different lens.

{
  "scan_id": "clxxxxxxxxxxxxxxx",
  "limit": 5,
  "preset_override": "CONVERSION"
}

Presets: PRE_SALES · PRE_LAUNCH · CONVERSION · INVESTOR · BRAND_POLISH

`report_finding_feedback`

Flag a finding as a false positive, wrong severity, wrong category, or not actionable. Requires a paragraph of reasoning and a concrete evidence snippet.

{
  "finding_id": "clxxxxxxxxxxxxxxx",
  "kind": "FALSE_POSITIVE",
  "reason": "The selector .pointer-events-auto matches 100+ utility classes, not a single offending element.",
  "evidence": "<div class=\"pointer-events-auto ...\"> — Tailwind utility, not an event-handler.",
  "proposed_severity": "LOW"
}

Feedback kinds: FALSE_POSITIVE · INCORRECT_SEVERITY · INCORRECT_CATEGORY · NOT_ACTIONABLE · OTHER

What PageLens Checks

Each scan runs a deterministic rule engine + AI reviewer pipeline across every page:

Area	Examples
SEO	Title/meta length, canonical URL, Open Graph, heading hierarchy
Performance	Core Web Vitals (LCP, CLS, INP), page weight, render-blocking resources, DOM size, third-party load
Security	HTTP→HTTPS redirect, exposed `.env`/`.git` files, SSL expiry, XSS surfaces, source maps, exposed secrets in page source
Accessibility	Focus-visible CSS, reduced-motion support, ARIA patterns
UX	Hero hierarchy, mobile menu patterns, CTA structure
Content	Placeholder text, stale copyright year, mixed-content references

Findings include severity, effort estimate, copy-pasteable evidence, and a one-line fix suggestion.

Example Agent Workflows

Pre-launch audit in Cursor:

"Run PageLens on my staging site, list all CRITICAL and HIGH findings, and create GitHub issues for the top 5."

CRO review:

"Fetch the latest scan for example.com, get the CONVERSION quick wins, and summarise what to fix before the campaign launch."

Security sweep:

"List all SECURITY findings with severity HIGH or above from my last scan and show me the evidence for each."

Post-fix validation:

"After I've fixed the findings, start a new scan and compare the score to the previous one."

Pricing

PageLens is pay-per-scan — no subscription required for one-off audits.

Tier	Price	Pages per scan
Starter	$1	3 pages
Professional	$15	25 pages
Monitor	$5 / month	Weekly automated scans · 5 pages

Every tier produces the same full report — Starter through Professional differ only by page-count cap, not report depth. The Monitor subscription runs weekly scans automatically and surfaces drift between runs.

See full pricing →

PageLens AI