# AgentCat

> Analytics for MCP servers. AgentCat tells you exactly what AI agents are doing on your product and where they're getting stuck.

AgentCat is an analytics platform for companies building MCP (Model Context Protocol) servers. It captures agent intent, replays sessions, tracks errors, and forwards telemetry to your existing observability tools.

## Key Features

- **Session Replay**: Step through exactly what agents did and why they made each tool call
- **Agent Intent Capture**: Understand *why* agents call your tools, not just what they call
- **Automatic Issue Detection**: Track errors, hallucinations, and problems agents encounter
- **Dashboard Analytics**: Visualize traffic by client, server, location, model, and more
- **Telemetry Forwarding**: Send enriched data to Datadog, Sentry, PostHog via OpenTelemetry
- **Privacy Controls**: Client-side and server-side redaction, encryption at rest

## SDKs

Available for TypeScript/JavaScript, Python, and Go:

- npm: `npm i agentcat`
- pip: `pip install agentcat`
- go: `go get github.com/mcpcat/mcpcat-go-sdk/officialsdk@latest`

## Quick Start

```typescript
import * as agentcat from "agentcat";
agentcat.track(mcpServer, "proj_YOUR_PROJECT_ID");
```

## Documentation

- [Full Documentation](https://docs.agentcat.com)
- [LLMs.txt (docs index)](https://docs.agentcat.com/llms.txt)
- [LLMs-full.txt (complete docs)](https://docs.agentcat.com/llms-full.txt)

## Doc Pages

- [Introduction](https://docs.agentcat.com/): Overview of AgentCat and what it helps with
- [Quickstart](https://docs.agentcat.com/quickstart): Install the AgentCat SDK in 1 minute
- [How It Works](https://docs.agentcat.com/how-it-works): Architecture, agent intent capture, request tracing, sessions
- [Identifying Users](https://docs.agentcat.com/sdk/identifying-users): Associate sessions with your users
- [Tool Call Context](https://docs.agentcat.com/sdk/tool-call-context): Customize what context AgentCat captures
- [Debug Mode](https://docs.agentcat.com/sdk/debug-mode): Enable extra logging for troubleshooting
- [Custom Events](https://docs.agentcat.com/sdk/custom-events): Track your own events alongside AgentCat's
- [Dashboard](https://docs.agentcat.com/features/dashboard): Real-time KPIs and usage analytics
- [Session Replay](https://docs.agentcat.com/features/session-replay): Debug individual agent sessions
- [Goals](https://docs.agentcat.com/features/goals): Understand what agents were trying to accomplish
- [Issues](https://docs.agentcat.com/features/issues): Find common errors and hallucinations
- [Integrations](https://docs.agentcat.com/integrations): Overview of integration options
- [OpenTelemetry](https://docs.agentcat.com/integrations/open-telemetry): Forward traces via OTLP
- [Datadog](https://docs.agentcat.com/integrations/datadog): Send data to Datadog
- [Sentry](https://docs.agentcat.com/integrations/sentry): Send data to Sentry
- [PostHog](https://docs.agentcat.com/integrations/posthog): Send data to PostHog
- [Privacy & Security](https://docs.agentcat.com/privacy-security): How AgentCat protects data
- [Client-Side Redaction](https://docs.agentcat.com/privacy-security/client-side-redaction): Scrub sensitive data before sending
- [Server-Side Redaction](https://docs.agentcat.com/privacy-security/server-side-redaction): Redact data on the server
- [Certifications](https://docs.agentcat.com/privacy-security/certifications): Compliance and encryption details
- [Deployment Options](https://docs.agentcat.com/deployment): Cloud, self-hosted, and single-tenant options
- [Self-Hosted](https://docs.agentcat.com/deployment/self-hosted): Run AgentCat in your own infrastructure
- [Single-Tenant](https://docs.agentcat.com/deployment/single-tenant): Dedicated AgentCat instance

## Links

- [Website](https://agentcat.com)
- [Pricing](https://agentcat.com/pricing.md)
- [Dashboard](https://agentcat.com/app/)
- [GitHub](https://github.com/mcpcat)