MCP Tracking

Track which tools AI clients call on your MCP server, how often, which clients (Claude, Cursor, Windsurf) drive the most usage, and error rates.

import { BetterMeter } from "@bettermeter/node";
import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";

const bm = new BetterMeter({
  siteId: "my-mcp-server",
  apiKey: "bm_...",
});

const server = new McpServer({
  name: "my-server",
  version: "1.0.0",
});

// Wraps server.tool() — auto-tracks every invocation
bm.wrapMcpServer(server);

// Tools registered after wrapping are automatically tracked
server.tool("search_docs", { query: z.string() }, async (args) => {
  // ... your tool logic (unchanged)
});

bm.trackTool({
  tool: "search_docs",
  client: "claude-code",
  protocolVersion: "2024-11-05",
  durationMs: 250,
  success: true,
  inputTokens: 150,
  outputTokens: 800,
});

What gets tracked

Tool names, client names, duration, success/failure, and optional token counts. Tool input parameters and output content are never sent.

MCP Tools Reference

BetterMeter runs as an MCP server for AI assistants. Every CLI command has a matching MCP tool with the bettermeter_ prefix.

{
  "mcpServers": {
    "bettermeter": {
      "command": "npx",
      "args": ["bettermeter"]
    }
  }
}

Mutating MCP tools require an exact confirmation phrase (CONFIRM <action> <target>) for the specific action and target before they create, update, delete, scan, or send paid requests.

All analytics tools accept site_id (string), range (today|7d|30d|90d|12m), and limit (number). The bettermeter_export MCP tool supports json and md formats (the CLI export command also supports csv). Usage examples for AI assistants:

Full Tool List

Human-traffic tools exclude known and high-confidence automated traffic by default. Set include_bots=true when you explicitly need the unfiltered totals.

Meta spend is commercially sensitive and requires EDITOR or ADMIN access in both direct tools and Pulse; VIEWER Pulse catalogs omit only the spend tool. bettermeter_ad_spend_sync calls Meta and updates stored spend, so it also requires the exact phrase CONFIRM sync ad spend <site_id>.