Reticle MCP

An MCP server that checks whether the agent is really done: drives the real app and returns pass, fail or couldn't tell with the file and line

  • 1,272 ★ on the repository
  • Last commit
MCP server

Extended access

Why this level

  • Edits agent configs and the project build config, restarts the dev server
  • Drives the live app and reads its state, including network and store
All reasons and checks

reticlehq/reticle

Install

Manual install

npm install -g @reticlehq/server
npx @reticlehq/server setup mcp

Then run npx @reticlehq/server init in the project. For Codex the installer prints lines to paste manually.

Access and checks

How we review

Extended accessThe tool runs code or makes network calls and only reads external data.

  • Edits agent configs and the project build config, restarts the dev server
  • Drives the live app and reads its state, including network and store

This is third-party code. Review the repository files before installing.

What it does

Reticle checks whether the agent's claim of being done matches reality. It drives your live app, reads what actually happened and returns a verdict of pass, fail or couldn't tell with the file and line to fix. Reticle installs as an MCP server and registers with many coding agents via an installer, then an init command wires it into a specific project: it installs a dev-only SDK, edits the build config, restarts the dev server and confirms a session with the app really connected. It ships adapters for React, the browser, Electron, Tauri and build tools.

Who it is for. For developers and QA who want the agent to prove the result in the live app rather than by claim.

Good fit when

  • You need to verify that the agent's change actually works in the app
  • You need a verdict with the file and line to fix
  • You want the agent to read the app's real state, not just the screen

Not a fit when

  • The app is not a web or desktop app in the supported environments
  • You are not ready to install a dev-only SDK and change the project build config

Example request

Use Reticle to check whether the login form really works after the change, and show the file and line if not

MCP

Transport
stdio
Authentication
not required

Limitations

The installer registers the MCP server with every reachable agent and edits their configs, and for Codex it prints lines to paste manually. The init step changes the project build config and restarts the dev server. A running dev server is required. The license is non-standard (Apache-2.0 with FSL), so check the terms.

How to disable. Remove the reticle entry from the agent configs and uninstall the @reticlehq/server package; revert the build config changes and the dev-only SDK in the project.

FAQ

How is this different from ordinary browser tests?

Reticle drives the live app and reads its real state, including network and store, and returns a verdict with a file and line rather than only a screenshot.

What does the init step do?

It installs a dev-only SDK, edits the build config, restarts the dev server and confirms a session with the app really connected.

Discussion

No questions or reviews yet.

CLI, MCP server and typed Node.js API so an agent can verify its changes in a live mobile app on iOS, Android and more

CLIExtended access5.4KRepository stars
Official

An agent gets a live session of your web, iOS or Android app, sees the screen, writes tests and checks its own edits.

MCP serverExtended access13.8KRepository stars

Electron debugging MCP server: 111 tools let an agent see the window, click buttons, read console and network and audit security.

MCP serverExtended access102Repository stars

A CLI that tests AI agents end to end: derives scenarios from code, runs them live and separates unverified from failed.

CLIExtended access81Repository stars
Official

kogiQA MCP gives an agent a browser that finds page elements without selectors, for debugging web apps and writing e2e tests

MCP serverExtended access88Repository stars

Agent Reliability Analyzer statically scans AI agent code, finds reliability gaps with 340 plus rules and applies fixes

PluginExtended access88Repository stars

README in short

The README presents Reticle as a tool that checks whether the agent is really done: it drives the live app, reads real state and returns a verdict of pass, fail or couldn't tell with a file and line. The installer puts reticle on PATH and registers the MCP server with every reachable agent, printing paste lines for Codex. The init step wires the server into the project, installs a dev-only SDK, edits the build config and restarts the dev server. It ships adapters for React, the browser, Electron, Tauri and build tools. Install is also via npm and /plugin marketplace add.

README badge

Report a problem