Quickstart

AgentCat adds analytics to your MCP server with one package and one track() call. Each language has a setup page that covers the supported MCP libraries, identity, and a test of your setup.

Choose your language

TypeScript

@modelcontextprotocol/sdk 1.x and @modelcontextprotocol/server 2.x

Python

Official mcp 1.x and 2.x, and community fastmcp

Go

Official go-sdk and mark3labs/mcp-go

PHP

mcp/sdk, Laravel, and Symfony

C#

The official C# MCP SDK, with ASP.NET Core or the generic host

Rust

rmcp 3.x

Java

MCP Java SDK, Spring Boot, Quarkus, and Micronaut

Ruby

The mcp gem

A first example

These are the TypeScript and Python examples from their setup pages. Install the package, then call track() where your code creates the server:

npm install agentcat

pip install agentcat

import { createMcpHandler, McpServer } from "@modelcontextprotocol/server";
import * as agentcat from "agentcat";

const handler = createMcpHandler(() => {
  const server = new McpServer({ name: "my-server", version: "1.0.0" });
  // server.registerTool(...)
  return agentcat.track(server, process.env.AGENTCAT_PROJECT_ID!);
});

import os

import agentcat
from mcp.server.mcpserver import MCPServer

def create_server() -> MCPServer:
    server = MCPServer("my-server", version="1.0.0")
    # @server.tool() ...
    agentcat.track(server, os.environ["AGENTCAT_PROJECT_ID"])
    return server

server = create_server()
server.run(transport="streamable-http", stateless_http=True)

You can find your project ID in the AgentCat dashboard. We recommend that you also identify your users: the setup page of your language shows how, in its “Identifying users” section.

Using without an AgentCat account

You can send events only to your own observability platform, with no AgentCat project. In TypeScript, a null project ID with an exporter does this:

agentcat.track(server, null, {
  exporters: {
    otlp: {
      type: "otlp",
      endpoint: "http://localhost:4318/v1/traces",
    },
  },
});

Each reference page explains this mode for its language: TypeScript, Python, Go, PHP, C#, Rust, Java, and Ruby. The Rust and Java SDKs have no exporters yet. Learn more about integration options.

Next steps

Identify users

Know which user is behind each session

Debug mode

Find the AgentCat log for your language

Tool call context

Learn why agents call each tool

Custom events

Send your own events next to the ones AgentCat captures

Getting Started

Connect your agent

Languages

SDK concepts

Features

Integrations

Privacy & Security

Deployment Options