Set Up

Sentry MCP Observability helps you track and debug Model Context Protocol (MCP) implementations using our supported SDKs and integrations. Monitor your complete MCP workflows from client connections to server responses, including tool executions, resource access, and protocol communications.

To start sending MCP data to Sentry, make sure you've created a Sentry project for your MCP-enabled repository and follow the guide below:

Supported SDKs

JavaScript - MCP Server

The Sentry JavaScript SDK supports MCP observability by wrapping the MCP Server from the @modelcontextprotocol/sdk package. This wrapper automatically captures spans for your MCP server workflows including tool executions, resource access, and client connections.

Quick Start with MCP Server

import * as Sentry from "@sentry/node";
import { McpServer } from "@modelcontextprotocol/sdk";

// Sentry init needs to be above everything else
Sentry.init({
  dsn: "___PUBLIC_DSN___",
  tracesSampleRate: 1.0,
});

// Your MCP server with optional input/output recording
const server = Sentry.wrapMcpServerWithSentry(
  new McpServer({
    name: "my-mcp-server",
    version: "1.0.0",
  }),
  {
    recordInputs: true,
    recordOutputs: true,
  }
);

...

Options

recordInputs

Type: boolean

Records inputs to MCP tool and prompt calls (such as tool arguments and prompt parameters).

Defaults to true if sendDefaultPii is true.

recordOutputs

Type: boolean

Records outputs from MCP tool and prompt calls (such as tool results and prompt messages).

Defaults to true if sendDefaultPii is true.

Python - MCP Server

The Sentry Python SDK supports MCP observability for the MCP Python SDK (both low-level and FastMCP APIs) and standalone FastMCP. The integration automatically captures spans for your MCP server workflows including tool executions, resource access, and prompt handling.

Quick Start

import sentry_sdk
from sentry_sdk.integrations.mcp import MCPIntegration
from mcp.server.fastmcp import FastMCP

# Sentry init needs to be above everything else
sentry_sdk.init(
    dsn="___PUBLIC_DSN___",
    traces_sample_rate=1.0,
    # Optional: Enable to capture tool call arguments and results in Sentry, which may include PII
    send_default_pii=True,
    integrations=[MCPIntegration()],
)

# Create the MCP server
mcp = FastMCP("Example MCP Server")

# Define a tool
@mcp.tool()
async def calculate_sum(a: int, b: int) -> int:
    """Add two numbers together."""
    return a + b

# Run the server
mcp.run()