Rastreo de MCP

Rastree qué herramientas llaman los clientes de IA en su servidor MCP, con qué frecuencia, qué clientes (Claude, Cursor, Windsurf) generan más uso y las tasas de error.

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

Qué se rastrea

Nombres de herramientas, nombres de clientes, duración, éxito/fallo y conteos opcionales de tokens. Los parámetros de entrada y el contenido de salida de las herramientas nunca se envían.

Referencia de herramientas MCP

BetterMeter funciona como un servidor MCP para asistentes de IA. Cada comando CLI tiene una herramienta MCP correspondiente con el prefijo bettermeter_.

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

Las herramientas MCP que modifican datos requieren una frase de confirmación exacta (CONFIRM <action> <target>) para la acción y el objetivo específicos antes de crear, actualizar, eliminar, escanear o enviar solicitudes pagadas.

Todas las herramientas de analíticas aceptan site_id (string) y range (today|7d|30d|90d|12m) — salvo bettermeter_all_sites, que abarca toda la cuenta: no declara ningún site_id y su range acepta además una ventana personalizada YYYY-MM-DD..YYYY-MM-DD. limit (number, 1-100, opcional) solo lo declaran las herramientas de lista que devuelven filas clasificadas; las herramientas de resumen, tendencia y detalle no lo aceptan. La herramienta MCP bettermeter_export soporta los formatos json y md (el comando CLI export también soporta csv). Ejemplos de uso para asistentes de IA:

Lista completa de herramientas

Las herramientas de tráfico humano excluyen por defecto el tráfico automatizado conocido y detectado con alta confianza. Usa include_bots=true cuando necesites explícitamente los totales sin filtrar.

Las herramientas que aceptan limit son bettermeter_pages, bettermeter_sources, bettermeter_bots, bettermeter_countries, bettermeter_browsers, bettermeter_visitors, bettermeter_sessions, bettermeter_events, bettermeter_campaigns, bettermeter_conversions, bettermeter_keywords, bettermeter_campaign_visitors, bettermeter_export, bettermeter_cli_commands, bettermeter_mcp_tools, bettermeter_mcp_clients y bettermeter_api_endpoints. Si lo omites, el endpoint devuelve su propia página por defecto, que varía según el conjunto de datos; envíalo solo para pedir un número concreto de filas. En bettermeter_sources (con filter) y bettermeter_bots (con category) el límite se aplica antes del filtro, por lo que un resultado filtrado puede contener menos filas que el límite.

El gasto de Meta es comercialmente sensible y requiere acceso EDITOR o ADMIN tanto en las herramientas directas como en Pulse; el catálogo Pulse de VIEWER omite únicamente la herramienta de gasto. bettermeter_ad_spend_sync llama a Meta y actualiza el gasto almacenado, por lo que también requiere la frase exacta CONFIRM sync ad spend <site_id>.