Get the context you and your AI agents need to ship better code faster

Real-time local errors, traces, and logs to your agent via MCP. Download our app when you want to jump in. powered by Sentry SDKs, supporting 100+ languages.

$ claude mcp add sentry-spotlight -- npx -y @spotlightjs/spotlight --stdio-mcp
Add spotlight MCP server to Cursor
Copied to clipboard

After installing the MCP server, you'll need to configure your Sentry SDK to enable Spotlight.

Get Started with Spotlight

Instructions below are for JavaScript/TypeScript but the logic is similar for other languages: Set spotlight to true, enable all features (especially logging), and make sure these are only done for development.

1

Install a Sentry SDK

If you don't have one already, install a Sentry SDK for your framework.

View Sentry Docs →
2

Configure Sentry.init()

Add Spotlight to your Sentry configuration and enable all the features:

Sentry.init({
// your existing config
...(process.env.NODE_ENV !== "production" ? {
  spotlight: true, // Enable Spotlight
  sampleRate: 1.0, // Capture all errors in dev
  tracesSampleRate: 1.0, // Capture all traces in dev
  enableLogs: true,
  integrations: [
    Sentry.consoleLoggingIntegration({ levels: ["log", "warn", "error"] }),
    // For frontend apps, add:
    Sentry.spotlightBrowserIntegration(),
    Sentry.browserTracingIntegration(),
  ],
    }
  : {}),
});
3

Install Spotlight App

Install our app for better human-debugging and visualization. It includes an AI view to inspect your AI applications, review all messages, tool calls, and more.

Spotlight app interface
Download Spotlight App →

Powerful Features for Local Debugging

Everything you need to debug faster and ship with confidence

Real-time Error Tracking

Catch errors as they happen with instant notifications in your browser. No need to check logs or refresh pages.

Stack traces with source maps
Browser and device context
User actions breadcrumbs

Performance Tracing

Visualize the complete flow of your application with distributed tracing across frontend and backend.

Database query timing
API request waterfall
Component render times

Unified Console & Logs

Collect logs from all your services: frontend, backend, and everything in between. Capture console logs, warnings, and errors alongside your application events for complete, end-to-end debugging context.

Console.log integration
Network request logs
Custom debug messages

AI-Assisted Debugging

Connect Spotlight to your AI coding assistant through MCP for intelligent error analysis and fix suggestions.

MCP server integration
Cursor and Claude Code support, as well as other editors that support MCP.
Automated root cause analysis

Spotlight Spotlight

Developed by Sentry.io

Product

Resources

Community

© 2025 Functional Software, Inc. (d.b.a. Sentry). All rights reserved.