Skip to content
MCP server

Reticle

Verify a running web app from inside: look, act, observe and assert, without screenshots

Runs locallyStatus and history
Pricing
Open source
Platforms
Web, CLI, self-hosted
Runs
Locally
Version
3.10.6
Listing updated
2 days ago

About Reticle

Reticle is an open-source MCP server for developer tools. It runs locally on your machine and is started by your AI client.

Reticle's server hosts a localhost WebSocket bridge that the app's @reticlehq/browser SDK connects to, then gives a coding agent ten default tools to navigate, look at, act on, observe and assert against the live app. Only act-and-wait and assert return a verdict; the rest move or read.

The site argues that agents often claim done on mock data or a broken neighbouring flow, so Reticle reads network calls, app state and console rather than the screen. Verified flows are recorded and replayed after each change; the site says a four-flow replay costs about 480 tokens against roughly 120,000 for an LLM re-driving them. On its benchmark of 88 seeded bugs, Reticle reports 85 caught against 59 for Playwright.

More tools (screenshots and visual diff, saved flows, baselines, clock control, network mocking, crawl and coverage) are not advertised by default; reach them through reticle_run. The server is Apache-2.0 and starts with npx @reticlehq/server init.

Install

Run in a terminal

claude mcp add reticle -- npx -y @reticlehq/server

Add to claude_desktop_config.json

{
  "mcpServers": {
    "reticle": {
      "command": "npx",
      "args": [
        "-y",
        "@reticlehq/server"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "reticle": {
      "command": "npx",
      "args": [
        "-y",
        "@reticlehq/server"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "reticle": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@reticlehq/server"
      ]
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "reticle": {
      "command": "npx",
      "args": [
        "-y",
        "@reticlehq/server"
      ]
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "reticle": {
      "command": "npx",
      "args": [
        "-y",
        "@reticlehq/server"
      ]
    }
  }
}

Tools this server provides (10)

Taken from the project documentation; the running server may differ.

reticle_navigate
Navigates the app.
reticle_look
Reads the current app view.
reticle_act
Acts on the app.
reticle_act_and_wait
Acts and waits, returning a verdict.
reticle_observe
Observes network, state and console.
reticle_assert
Asserts a condition and returns a verdict.
reticle_session
Manages the session.
reticle_tools
Lists additional tools.
reticle_run
Runs a non-advertised tool by name.
reticle_verify
Verifies a flow.

What it does

In-app verification
Reads network, state and console from inside the running app.
Verdict tools
reticle_act_and_wait and reticle_assert return a pass or fail.
Remembered flows
Records a verified flow and re-checks it on each change.
Cheap replays
Re-running recorded flows uses no model in the loop.
Hidden extra tools
Screenshots, mocking and coverage are reachable by name.
Failure pointers
The site says failures name the file and line.

Good for

  • Make a coding agent confirm checkout still works after an edit
  • Catch hardcoded mock responses
  • Re-run key flows on every commit cheaply
  • Check that a card is charged once, not twice

Pricing

Open source

Open-source SDK; hosted platform prices not published

Prices change. Check reticle.sh before you buy.

Reticle FAQ

How do I set it up?

Run npx @reticlehq/server init, then register npx @reticlehq/server mcp with your agent.

What is the licence?

The server is Apache-2.0.

Does it need screenshots?

No, though screenshot and visual diff tools exist among the unadvertised ones.

How is it benchmarked?

The site reports 85 of 88 seeded bugs caught versus 59 for Playwright.

Is there a hosted option?

The site mentions a platform that tests every preview and PR in a real browser; prices are not published.

Is Reticle free?

Yes. Reticle is open source, so you can use and self-host it for free.

How do I add Reticle to Claude Code?

Run this command in your terminal: claude mcp add reticle -- npx -y @reticlehq/server

What are the best alternatives to Reticle?

The closest alternatives to Reticle are REA, Browser Use, Scrapling MCP Server, Codebase Memory and GitHub.

Alternatives to Reticle

  1. REA

    MCP server

    CLI and MCP server that lets coding agents reverse engineer apps and binaries

    Runs locally
    • Open source
    • 464K GitHub stars
    • Developer tools
  2. Browser Use

    MCP server

    Browser agents and cloud browsers for AI, with an MCP server for web tasks

    • 7 tools
    • Remote
    • Freemium
    • 121K GitHub stars
    • Browser automation
  3. MCP server for AI clients to scrape sites with HTTP and stealth browser sessions

    Runs locally
    • 17 tools
    • Open source
    • 104K GitHub stars
    • Web search and scraping
  4. Codebase Memory

    MCP server

    Local MCP server that builds a code knowledge graph for AI coding agents

    Runs locally
    • Open source
    • 48.7K GitHub stars
    • Knowledge and memory
  5. GitHub

    MCP server

    Official MCP server connecting AI assistants to GitHub repos, issues and workflows

    Not checked yet
    • Remote
    • Open source
    • 34.5K GitHub stars
    • Developer tools
  6. MCP toolkit giving coding agents symbol-level code retrieval and editing

    Runs locally
    • Open source
    • 31.5K GitHub stars
    • Developer tools