For the complete documentation index, see llms.txt. This page is also available as Markdown.

What is perceptdot? πŸ‘οΈ

perceptdot gives your AI agent eyes β€” it takes a screenshot of any website and tells you exactly what's broken.

Connect it to Claude Code or any MCP-compatible AI tool, and your agent can automatically detect layout bugs, overflowing elements, clipped text, and visual glitches β€” without you having to look.


What it finds

βœ… Buttons overflowing outside their container βœ… Text getting clipped or cut off βœ… Elements overlapping and hiding each other βœ… Broken layouts and misaligned sections


How it works

1️⃣ Your AI opens the website 2️⃣ Takes a full-page screenshot (tiled at 1280Γ—1600px) 3️⃣ Analyzes each tile with Gemini 2.5 Flash 4️⃣ Reports: "The CTA button in section 3 overflows by 18px"


Two ways to use perceptdot

MCP Server
GitHub Action

Best for

AI-assisted development

CI/CD automation

Works with

Claude Code, Cursor, Windsurf, Cline

Any GitHub workflow

Trigger

Ask your AI

Every deployment

Setup

1 command

~10 lines of YAML


Performance

  • 5–20s for a first scan (depends on page height)

  • ~0.3s for cached results

  • Supports desktop (1280px) Β· tablet (768px) Β· mobile (375px)


Ready in 1 minute

Jump straight to setup πŸ‘‰ ⚑ Quick Install

Last updated

Was this helpful?