trackmcp
Docs

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/dashboard
import { 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.

1

Observe

Capture protocol methods, tool calls, sessions, clients, and errors.

2

Protect

Redact sensitive paths in your process before telemetry leaves your server.

3

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.

Explore