Get started with TrackMCP
TrackMCP is the observability layer for MCP servers. Add it at the server boundary, keep your tools unchanged, and turn protocol traffic into usage, reliability, and outcome signals.
Quickstart
Install the SDK, create a workspace key, wrap your server, and deploy. Data appears in your dashboard after the first telemetry flush.
# TypeScript
npm i @trackmcp/sdk
# Create a key at https://app.trackmcp.com/dashboard
# Python
python3 -m pip install trackmcp
# Create your key at https://app.trackmcp.com/dashboardimport { withTrackMCP } from "@trackmcp/sdk";
import { server } from "./mcp";
export default withTrackMCP(server, {
apiKey: process.env.TRACKMCP_KEY,
service: "acme-mcp-server",
environment: "production",
});That's the whole setup. The wrapper observes the MCP protocol layer and tool calls without changing your tool implementations. Errors returned inside a successful 200 OK are preserved in the captured result.
How TrackMCP works
MCP clients first initialize a connection and discover the server catalog. They then call tools, receive results, and may retry or stop. TrackMCP observes this lifecycle at the server boundary and sends small batched telemetry events to your workspace.
Observe
Capture protocol methods, tool calls, sessions, clients, and errors.
Protect
Redact sensitive paths in your process before telemetry leaves your server.
Explain
Group events into traces and actionable signals in the dashboard.
Choose your integration
Use the SDK that matches the language of the process hosting your MCP server. The wrapper is additive: it records telemetry without changing tool definitions or the responses your clients receive.
Verify your first event
After starting the instrumented server, make one real tool call from your MCP client. Return to the dashboard and choose Check for data. A successful connection shows an event, a session, the discovered catalog, and the client name when the client provides one.
What success looks like
The dashboard changes from the sample workspace to your live workspace. If it does not, check that the key belongs to this workspace, the server can reach the ingest URL, and the process has made a tool call.
Privacy and failure behavior
Redaction happens locally
Use redact rules for secrets and personal data. The SDK replaces matching values before sending the batch.
Telemetry is fail-open
If TrackMCP is unavailable, the SDK requeues telemetry and does not block the MCP call.
Troubleshooting
No data appears
Confirm TRACKMCP_KEY is set in the same process that runs the MCP server, then make a fresh tool call.
Invalid or revoked API key
Generate a new key in the signed-in workspace and restart the server after updating the environment.
The install command fails
Use Node.js 18 or newer for TypeScript, or Python 3.9 or newer for Python. Confirm the package name exactly.