Riffle — Claude Code MCP server: what it does, how to install
Gives your agent text-based browser control without screenshots or HTML markup. Runs multi-step actions in one turn and reports only interface diffs.
claude mcp add riffle -- npx -y @noetive/riffleWhat Riffle does
Riffle operates an automated Chrome instance with full JavaScript execution, transforming the live page structure into plain text statements. The model reads states like disabled inputs, covered buttons, and strikethrough prices directly from attribute tags, bypassing raw DOM trees or pixel recognition.
Interaction happens through two primary tools: browser_run executes chained steps like clicks or typing in a single round-trip, while browser_view inspects current content. Instead of retransmitting identical trees, updates deliver text diffs to preserve prompt budgets during prolonged workflows.
The host machine requires a local Chrome or Chromium installation; riffle doctor verifies this dependency. The background manager caps concurrent instances at four browsers and automatically drops sessions idling past 15 minutes.
What it helps with
- interact with web interfaces without generating screenshots or calculating click coordinates
- execute complete multi-step sign-in routines in a single model turn
- reduce token consumption by streaming page changes instead of full snapshots
- detect overlapping dialogs before dispatching clicks to covered buttons
Example prompts for the agent
- Dismiss the cookie banner and press the checkout button on the current page.
- Fill in the login credentials, submit the form, and confirm that the account dashboard loaded.
- Inspect the interactive elements on this page using browser_view with an 800 token budget.
How to install Riffle
Platform CLI
claude mcp add riffle -- npx -y @noetive/rifflePlatform CLI
codex mcp add riffle -- npx -y @noetive/riffleConfig file
{
"mcpServers": {
"riffle": {
"command": "npx",
"args": [
"-y",
"@noetive/riffle"
]
}
}
}Config file
{
"servers": {
"riffle": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@noetive/riffle"
]
}
}
}Platform CLI
gemini mcp add riffle npx -y @noetive/riffleStep by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about Riffle
How do I install Riffle in Claude Code?
Run claude mcp add riffle -- npx -y @noetive/riffle in your terminal.
How does Riffle represent web pages to the agent?
It converts rendered DOM elements into plain text lines indicating element labels, states, and coverage. After the initial inspection, the server delivers diffs showing only what changed.
What prerequisites does Riffle need on the system?
It requires Chrome or Chromium installed on your system. Run riffle doctor in your terminal to confirm the browser is detected.
