Mcpcat Typescript Sdk

What is Mcpcat Typescript Sdk

mcpcat-typescript-sdk is an analytics platform designed specifically for MCP server owners. It captures user intentions and behavior patterns to provide insights into what AI users need from their tools, thereby streamlining product development.

Use cases

Use cases for mcpcat-typescript-sdk include enhancing user experience on MCP servers, informing product design decisions based on user data, and optimizing AI tools to better meet user needs.

How to use

To use mcpcat-typescript-sdk, simply install it via npm with the command npm install -S mcpcat. After installation, you can integrate it into your project to start capturing user analytics.

Key features

Key features of mcpcat-typescript-sdk include user behavior tracking, intention capture, and the ability to accelerate product development with minimal code integration.

Where to use

mcpcat-typescript-sdk can be used in various domains where understanding user behavior is crucial, such as software development, product management, and AI tool optimization.

Getting Started · Features · Docs · Website · Open Source · Discord

[!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.

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.

Getting Started

To get started with MCPcat, first create an account and obtain your project ID by signing up at mcpcat.io.

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" });

// Register tools

// NOTE: track() must be called *after* tools are setup
mcpcat.track(mcpServer, "proj_0000000");

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.getUser(request.params.arguments.token);
    return {
      userId: user.id,
      userName: user.name,
      userData: { favoriteColor: user.favoriteColor },
    };
  },
});

Redacting sensitive data

MCPcat redacts all data sent to its servers and encrypts at rest, but for additional security, it offers a hook to do your own redaction on all text data returned back to our servers.

mcpcat.track(mcpServer, "proj_0000000", {
  redactSensitiveInformation: async (text) => await redact(text),
  // or
  redactSensitiveInformation: (text) => redact(text),
});

Free for open source

MCPcat is free for qualified open source projects. We believe in supporting the ecosystem that makes MCP possible. If you maintain an open source MCP server, you can access our full analytics platform at no cost.

How to apply: Email [email protected] with your repository link

Already using MCPcat? We’ll upgrade your account immediately.

Community Cats 🐱

Meet the cats behind MCPcat! Add your cat to our community by submitting a PR with your cat’s photo in the docs/cats/ directory.

Want to add your cat? Create a PR adding your cat’s photo to docs/cats/ and update this section!

Overview