Give your agent
the full picture.

Bring screenshots, recorded flows and UI findings into the conversation. Less guessing. A clearer path to the fix.

Connect your agent.

claude mcp add --transport http diffraction https://app.diffraction.sh/mcp

Run this command, then open /mcp in Claude Code and authenticate Diffraction.

Or start in
your terminal.

Download evidence, follow a review or check local changes before a commit. One executable for macOS and Linux.

curl -fsSL https://api.diffraction.sh/cli | bash

Installs into ~/.local/bin. Add it to your PATH if prompted. No Node.js, npm or sudo required.

diffraction login --access read-only
diffraction repositories --json

Review local changes

Inspect the manifest first. Running without --dry-run uploads your source and requests a paid review. Replace REPOSITORY_ID with an ID from your repository list.

diffraction review-local --repo REPOSITORY_ID --dry-run

See the issue

Bring findings, screenshots and recorded browser steps into the conversation. Timestamped comments give models context even without video input.

Follow the review

Find repositories, inspect review history and follow a run from queued to complete. Request a new review when you choose.

Go deeper

Read captured performance, accessibility, SEO and link health results. Update company rules and project context with the right permissions.

Your workspace.
Your permissions.

WorkOS handles sign-in and consent. Every request respects your current workspace access.

Read only

Inspect reviews, evidence, insights and context. No review requests or settings changes.

Read & write

Also request reviews and update context or company rules where your role allows it. New reviews use workspace credits.

Admins can require read-only access for every MCP and CLI connection, including previously connected clients.

Start with
a better question.

Ask for the evidence behind a finding, then work through the fix. The agent guide covers every tool and permission.

Read the agent guide

Use Diffraction to inspect the latest review for this repository. Read its findings and timestamped comments, then fetch the relevant screenshots and steps. Explain what needs fixing, with links to the evidence. Do not start a paid review or change settings without my request.

The guide is also available inside MCP at diffraction://guide.

A few useful answers.

Do I need to install the CLI to use MCP?

No. The MCP server is hosted. Connect your client to the server URL and sign in. The CLI is a separate way to use Diffraction from your terminal.

Which permissions does a connection have?

Choose Read only or Read & write on the WorkOS consent screen. Read & write allows requests and settings changes only where your workspace role permits them. Workspace admins can require every CLI and MCP connection to remain read-only.

Does connecting spend review credits?

Connecting and reading existing evidence do not create reviews. Requesting a new review uses your workspace’s review credits and spending limits.

Can the CLI review uncommitted changes?

Yes. Start with review-local --dry-run to inspect the source manifest. Tracked working-tree changes are included; select untracked files explicitly with --include. Uploading local source does not create or push a GitHub PR.

Which systems can install the CLI?

The self-contained installer supports macOS and glibc Linux on Apple Silicon/ARM64 and x64. It does not require Node.js, npm or sudo. Windows and Alpine Linux are not supported by this installer.