Overview

What is MCPeek SDK?

MCPeek is an analytics SDK for MCP servers and ChatGPT app widgets. It instruments both sides, sends structured events to the ingest API, and powers usage, engagement, and adoption metrics

Server SDK

withMcpServerAnalytics(...) wraps StreamableHTTPServerTransport and emits MCP server lifecycle events such as tool calls, responses, errors, and list/read operations.

Client SDK

withOpenAiClientAnalytics(...) wraps window.openai in the ChatGPT app widget and tracks user-side events such as modal requests, external opens, display mode changes, and widget close.

What you get

Active user metrics (DAU/WAU/MAU/New Users)
Engagement metrics (sessions, retention, session length)
Tooling metrics (tool calls, per-user/per-session ratios, power users)
Feature and audience breakdowns (adoption + dimensions)

Next step

Start with Installation, then configure API keys, integrate server + widget wrappers, and verify data in dashboard views.

Scope

This documentation covers the SDKs, ingest API, and metrics API currently present in this repository.