MCP Server

Monocle Studio includes a built-in MCP server. This lets AI coding assistants like Claude Code, Cursor, or Codex query your local telemetry data directly — find errors, inspect traces, and debug performance issues without leaving your editor.

Setup

The MCP server is available at http://localhost:4200/mcp when Monocle Studio is running.

Claude Code
Cursor
Codex
Other

npx add-mcp monocle --url http://localhost:4200/mcp -a claude-code

npx add-mcp monocle --url http://localhost:4200/mcp -a cursor

npx add-mcp monocle --url http://localhost:4200/mcp -a codex

add-mcp supports 15+ clients. Run npx add-mcp --all to install for all detected clients, or configure manually:

{
  "mcpServers": {
    "monocle": {
      "type": "url",
      "url": "http://localhost:4200/mcp"
    }
  }
}

Available tools

Tool	Description
`list_traces`	List recent traces with entry point, duration, and status. Supports filtering by trace ID.
`get_trace`	Get the complete span waterfall for a trace — parent/child relationships, durations, attributes.
`list_logs`	List logs filtered by severity, search text, or trace ID.
`list_errors`	List exceptions with type, message, stacktrace, and trace context.
`list_queries`	List database queries with SQL statement, duration, and system. Filter by database type.
`clear_data`	Clear all collected telemetry for a fresh debugging session.

Examples

Once connected, you can ask your AI assistant things like:

“What errors happened in the last few requests?”
“Show me the trace for the slow /api/users endpoint”
“Find all database queries slower than 200ms”
“What’s the overall health of my app right now?”
“Clear all data and start a fresh debugging session”

The assistant will call the appropriate MCP tools, query Monocle Studio, and give you the answer in context.

Getting Started

Monocle Studio

Frameworks

Features

Setup

Available tools

Examples

Getting Started

Monocle Studio

Frameworks

Features

​Setup

​Available tools

​Examples

Setup

Available tools

Examples