Mcpcat Typescript Sdk

Getting Started · Features · Docs · Website · Open Source · Schedule a Demo

[!NOTE] Looking for the Python SDK? Check it out here mcpcat-python.

MCPcat is an analytics platform for MCP server owners 🐱. It captures user intentions and behavior patterns to help you understand what AI users actually need from your tools — eliminating guesswork and accelerating product development all with one-line of code.

This SDK also provides a free and simple way to forward telemetry like logs, traces, and errors to any Open Telemetry collector or popular tools like Datadog, Sentry, and PostHog.

npm install -S mcpcat

To learn more about us, check us out here. For detailed guides visit our documentation.

Why use MCPcat? 🤔

MCPcat helps developers and product owners build, improve, and monitor their MCP servers by capturing user analytics and tracing tool calls.

Use MCPcat for:

• User session replay 🎬. Follow alongside your users to understand why they're using your MCP servers, what functionality you're missing, and what clients they're coming from.
• Trace debugging 🔍. See where your users are getting stuck, track and find when LLMs get confused by your API, and debug sessions across all deployments of your MCP server.
• Existing platform support 📊. Get logging and tracing out of the box for your existing observability platforms (OpenTelemetry, Datadog, Sentry) — eliminating the tedious work of implementing telemetry yourself.

Getting Started

To get started with MCPcat, first create an account and obtain your project ID by signing up at mcpcat.io. For detailed setup instructions visit our documentation.

Once you have your project ID, integrate MCPcat into your MCP server:

import * as mcpcat from "mcpcat";

const mcpServer = new Server({ name: "echo-mcp", version: "0.1.0" });

// Track the server with MCPCat
mcpcat.track(mcpServer, "proj_0000000");

// Register your tools

Identifying users

You can identify your user sessions with a simple callback MCPcat exposes, called identify.

mcpcat.track(mcpServer, "proj_0000000", {
  identify: async (request, extra) => {
    const user = await myapi.getUs

... [View full README on GitHub](https://github.com/MCPCat/mcpcat-typescript-sdk#readme)