Skip to content

Getting Started

Jump to bottom
Apoorv Raj Saxena edited this page Jan 6, 2026 · 1 revision

Getting Started

Fastest path to seeing MCP traffic in Reticle.

Install

Choose one:

npm install -g mcp-reticle
# or
pip install mcp-reticle
# or
brew install labterminal/mcp-reticle/mcp-reticle

Verify:

mcp-reticle --help

Quick start (stdio)

1) Wrap your MCP server

Wrap your existing server command with:

mcp-reticle run --name <server-name> -- <server command...>

Example (Claude Desktop-style config):

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

2) Launch the UI

mcp-reticle ui

You should now see JSON-RPC messages, correlated request/response pairs, stderr output, and profiling data.

Log-only mode (no UI)

mcp-reticle run --log -- <server command...>

Example:

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

Proxy mode (HTTP/SSE/WebSocket)

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

Next steps

Reticle · MCP inspection & profiling · MIT licensed

Reticle

Clone this wiki locally