Skip to content
Back to search

mcp-reticle

Reticle intercepts, visualizes, and profiles JSON-RPC traffic between your LLM and MCP servers in real-time, with zero latency overhead. Stop debugging blind. Start seeing everything.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/soth-ai--mcp-reticle/badge.svg)](/listings/soth-ai--mcp-reticle)

HTML

<a href="/listings/soth-ai--mcp-reticle"><img src="/api/listings/soth-ai--mcp-reticle/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

1) Install

# npm
npm install -g mcp-reticle

# pip
pip install mcp-reticle

# Homebrew
brew install labterminal/mcp-reticle/mcp-reticle

2) Wrap your MCP server (stdio)

Replace your MCP server command with `mcp-reticle run --name <name> -- <command...>`.

Example (Claude Desktop-style config):

{
  "mcpServers": {
    "filesystem": {
      "command": "mcp-reticle",
      "args": ["run", "--name", "filesystem", "--", "npx", "-y", "@modelcontextprotocol/server-filesystem", "/Users/me/work"]
    }
  }
}

3) Launch the UI

mcp-reticle ui

Optional: log-only mode (no UI)

mcp-reticle run --log -- npx -y @modelcontextprotocol/server-memory

Optional: proxy an HTTP-based MCP server

mcp-reticle proxy --name api --upstream http://localhost:8080 --listen 3001

---

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 179 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. <p align="center">
  2. <picture>
  3. <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/labterminal/mcp-reticle/main/frontend/src/assets/logo-white.png" />
  4. <source media="(prefers-color-scheme: light)" srcset="https://raw.githubusercontent.com/labterminal/mcp-reticle/main/frontend/src/assets/logo.png" />
  5. <img src="https://raw.githubusercontent.com/labterminal/mcp-reticle/main/frontend/src/assets/logo.png" alt="Reticle Logo" width="120" />
  6. </picture>
  7. </p>
  8. <h1 align="center">RETICLE</h1>
  9. <p align="center">
  10. <strong>The Wireshark for the Model Context Protocol (MCP)</strong>
  11. </p>
  12. <p align="center">
  13. <a href="LICENSE">
  14. <img src="https://img.shields.io/badge/License-MIT-blue.svg" alt="License: MIT" />
  15. </a>
  16. <a href="https://www.npmjs.com/package/mcp-reticle">
  17. <img src="https://img.shields.io/npm/v/mcp-reticle.svg" alt="npm" />
  18. </a>
  19. <a href="https://pypi.org/project/mcp-reticle/">
  20. <img src="https://img.shields.io/pypi/v/mcp-reticle.svg" alt="PyPI" />
  21. </a>
  22. <a href="https://github.com/labterminal/mcp-reticle/wiki">
  23. <img src="https://img.shields.io/badge/docs-wiki-informational" alt="Docs (Wiki)" />
  24. </a>
  25. <img src="https://img.shields.io/badge/Platform-macOS%20%7C%20Linux%20%7C%20Windows-lightgrey.svg" alt="Platform" />
  26. </p>
  27. <p align="center">
  28. <em>See what your agent sees.</em>
  29. </p>
  30. <p align="center">
  31. Reticle intercepts, visualizes, and profiles MCP JSON-RPC traffic in real time — designed for microsecond-level overhead.
  32. </p>
  33. <p align="center">
  34. <a href="#quick-start">Quick start</a> ·
  35. <a href="#installation">Install</a> ·
  36. <a href="#documentation">Docs</a> ·
  37. <a href="#security--privacy">Security</a> ·
  38. <a href="#contributing">Contributing</a>
  39. </p>
  40. <p align="center">
  41. <img
  42. src="https://raw.githubusercontent.com/labterminal/mcp-reticle/main/frontend/src/styles/reticle.png"
  43. alt="Reticle Screenshot"
  44. width="900"
  45. />
  46. </p>
  47. ---
  48. ## What is Reticle?
  49. Reticle is a proxy + UI for debugging MCP integrations:
  50. - inspect raw JSON-RPC messages (requests / notifications / responses)
  51. - correlate request ↔ response instantly
  52. - profile latency and token estimates
  53. - capture server stderr and crashes
  54. - record sessions and export logs
  55. Supported transports: **stdio**, **Streamable HTTP**, **WebSocket**, **HTTP/SSE**.
  56. ---
  57. ## Quick start
  58. ### 1) Install
  59. ```bash
  60. # npm
  61. npm install -g mcp-reticle
  62. # pip
  63. pip install mcp-reticle
  64. # Homebrew
  65. brew install labterminal/mcp-reticle/mcp-reticle
  66. ```
  67. ### 2) Wrap your MCP server (stdio)
  68. Replace your MCP server command with `mcp-reticle run --name <name> -- <command...>`.
  69. Example (Claude Desktop-style config):
  70. ```json
  71. {
  72. "mcpServers": {
  73. "filesystem": {
  74. "command": "mcp-reticle",
  75. "args": ["run", "--name", "filesystem", "--", "npx", "-y", "@modelcontextprotocol/server-filesystem", "/Users/me/work"]
  76. }
  77. }
  78. }
  79. ```
  80. ### 3) Launch the UI
  81. ```bash
  82. mcp-reticle ui
  83. ```
  84. ### Optional: log-only mode (no UI)
  85. ```bash
  86. mcp-reticle run --log -- npx -y @modelcontextprotocol/server-memory
  87. ```
  88. ### Optional: proxy an HTTP-based MCP server
  89. ```bash
  90. mcp-reticle proxy --name api --upstream http://localhost:8080 --listen 3001
  91. ```
  92. ---
  93. ## Installation
  94. If you prefer building from source:
  95. ```bash
  96. git clone https://github.com/labterminal/mcp-reticle.git
  97. cd mcp-reticle
  98. just build
  99. ```
  100. ---
  101. ## Documentation
  102. All guides and deep dives are in the [GitHub Wiki](https://github.com/labterminal/mcp-reticle/wiki):
  103. - [Getting started](https://github.com/labterminal/mcp-reticle/wiki/Getting-Started)
  104. - [CLI reference](https://github.com/labterminal/mcp-reticle/wiki/CLI)
  105. - [Client configuration](https://github.com/labterminal/mcp-reticle/wiki/Client-Configuration)
  106. - [Troubleshooting](https://github.com/labterminal/mcp-reticle/wiki/Troubleshooting)
  107. - [Architecture](https://github.com/labterminal/mcp-reticle/wiki/Architecture)
  108. - [Security & privacy](https://github.com/labterminal/mcp-reticle/wiki/Security)
  109. - [Development](https://github.com/labterminal/mcp-reticle/wiki/Development)
  110. - [Exports](https://github.com/labterminal/mcp-reticle/wiki/Exports)
  111. ---
  112. ## CLI overview
  113. | Command | Purpose |
  114. |---|---|
  115. | `mcp-reticle run` | Wrap stdio MCP servers and inspect traffic |
  116. | `mcp-reticle proxy` | Reverse proxy HTTP/SSE/WebSocket transports |
  117. | `mcp-reticle ui` | Launch the desktop UI |
  118. | `mcp-reticle daemon` | Headless telemetry hub |
  119. Full details: [CLI reference](https://github.com/labterminal/mcp-reticle/wiki/CLI)
  120. ---
  121. ## Security & privacy
  122. Reticle can capture tool inputs/outputs and server stderr. Treat recordings and exports as **sensitive** artifacts.
  123. Recommended reading: [Security & privacy](https://github.com/labterminal/mcp-reticle/wiki/Security)
  124. ---
  125. ## Contributing
  126. - Repo guidelines: `CONTRIBUTING.md`
  127. - Dev setup and commands: [Development guide](https://github.com/labterminal/mcp-reticle/wiki/Development)
  128. ---
  129. ## License
  130. MIT — see `LICENSE`.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.