Phyll MCP server

Phyll

UX review for apps built with AI, inside the agent you already use.

Leia em português

Phyll walks through your app the way a first-time user would. It collects screenshots, measurements from the live page and the clicks each job took, then tells you what makes the product hard to understand or use. It knows the defaults that code generators leave behind, in how an app looks and in how its flows work, and it can fix them for you.

Phyll keeps your design. Colors, gradients, fonts and layout stay as they are. The changes go where people get stuck: forms that ask for more than the job needs, steps that fit on one screen, buttons that lead nowhere and text too faint to read.

The review runs in Codex or Claude Code, on your own plan. Phyll adds a browser, a scanner and its review engine, and never charges for AI tokens.

To try it with no account, run the scanner in your project. It gives an AI tell index from 0 to 100, lower is better, and points to each tell by file and line:

npx phyll scan

The same app, a ManyChat-style tool for Instagram creators, before and after a Phyll review. The review of the left side is in examples/dm-automation/review/report.md: 12 findings, an AI tell index of 79, and a first job that could not be finished.

Start

Create a free account at agentphyll.com, or from the terminal, and connect Phyll to your agent:

npx phyll signup you@example.com
npx phyll setup codex        # or claude, cursor, windsurf, gemini

Then ask your agent: "review my app at http://localhost:3000". It opens the app, walks the core jobs, writes the report in .phyll/reports// and gives you a link to it.

Built in Lovable, Bolt or v0, with no agent on your computer? agentphyll.com/check checks a public page for free, with no account: one page load at laptop and phone size, the index and what it found, in half a minute.

Every report, your keys and your plan are also at agentphyll.com/account, and npx phyll account opens it already signed in. If you lose the key, sign in there with your email and create a new one.

Already have an account? npx phyll login connects this computer: you allow it in the browser, and the terminal gets a key of its own. Every command, with examples, is at agentphyll.com/commands.

In Claude Code you can also install the plugin, which adds /phyll:review, /phyll:fix and /phyll:scan:

/plugin marketplace add carlosphyll/phyll
/plugin install phyll@carlosphyll

The plugin starts the connector by itself, so with it you skip npx phyll setup claude. You need Node 20 or newer. setup installs the Chromium build that Phyll's browser uses. For an agent not on the list, npx phyll setup other prints the MCP entry to paste into its settings.

Free and Phyll Pro

The price is in Brazilian reais, and checkout shows it in your currency. npx phyll pro opens the checkout, and npx phyll billing changes the card or cancels. The AI work always runs on your agent's plan.

Four apps, before and after

Each example is a small app written the way a code generator tends to write it, the same app after the review, and the full review of the first version. Three of them are Brazilian businesses, reviewed in Portuguese.

Shortened. The full README is on GitHub.