05 · API

Pregunta a tu analítica a través de MCP

El servidor MCP permite que un asistente como Claude haga sus propias preguntas a tu analítica, con la misma clave de solo lectura que la API REST.

01Añádelo a tu asistente

El servidor está en https://tallybyoutpost.com/mcp y acepta la misma clave que la API REST (créala en la página Setup), como Authorization: Bearer …. En Claude Code:

Claude Code

claude mcp add --transport http analytics "https://tallybyoutpost.com/mcp" \
  --header "Authorization: Bearer $TALLY_API_KEY"

Cualquier cliente que hable MCP sobre Streamable HTTP y pueda enviar una cabecera funciona igual.

02Las herramientas

Todas las herramientas solo leen. Cada una acepta como argumentos los parámetros de la ruta REST (filters es un objeto, {"country": "DE"}, y site se puede omitir):

Herramienta	Qué responde
`list_sites`	El sitio que lee esta clave de API: su ID, nombre, dominio, zona horaria y cómo se cuentan los visitantes (cookie, sin cookies o consentimiento).
`get_overview`	Visitantes, vistas de página, visitas, mediana del tiempo activo y, cuando hay pagos conectados, ingresos netos, ventas, reembolsos, tasa de conversión e ingresos por visitante, para un periodo y la ventana anterior, con el cambio entre ambos. También los visitantes en directo en este momento.
`get_breakdown`	Los valores principales de una dimensión (fuente, canal, página, país, dispositivo, campaña…) por visitantes distintos, o por ingresos, cada uno con su proporción de visitantes y los ingresos que trajeron sus visitantes.
`compare_periods`	Un periodo frente a la ventana inmediatamente anterior (previous) o frente a las mismas fechas un año antes (year): todas las cifras del resumen para ambos, y el cambio relativo. Los cambios son null cuando los registros del sitio no llegan lo bastante atrás para comparar.
`list_sales`	Pagos del más reciente al más antiguo, cada uno con su importe tal como se cobró y en dólares estadounidenses, si está vinculado a un visitante, cómo (método y confianza) y, cuando no lo está, por qué. Filtra por pagos sin vincular o por reembolsos.
`get_receipt`	El comprobante de un pago: la cadena de evidencias que lo vincula a una visita (primera visita, visitas antes de pagar, la visita atribuida, el identificador que coincidió y dónde), cada ID del proveedor y el pago del que procede.
`get_coverage`	Qué parte de los ingresos del periodo se atribuye a un visitante, por método, y la lista de arreglos para lo que no (con código para pegar).
`list_visitors`	Los visitantes (las visitas, en un sitio sin cookies) de un periodo, primero los más recientes, o por ingresos o por probabilidad de compra, con visitas, páginas, tiempo activo por visita, ingresos y su visita más reciente.
`get_visitor`	El recorrido completo de un visitante: cada visita con sus páginas, tiempo activo, objetivos y clics salientes, sus pagos, el primer contacto y el contacto al que se atribuye la venta.
`get_realtime`	Quién está en el sitio en los últimos cinco minutos (página, lugar, fuente, dispositivo) y las ventas de la última hora.
`get_goals`	Cada objetivo completado en el periodo, con conversiones, visitantes que convierten, tasa de conversión e ingresos de los visitantes que convierten; indica `goal` para ver las propiedades de un objetivo. Enumera los embudos del sitio.
`get_funnels`	Los embudos del sitio con los visitantes de cada paso, la conversión desde el paso anterior y desde el primero, y el abandono; o un solo embudo con `funnel`.
`get_customer_value`	Valor de vida del cliente según la fuente que trajo primero a cada cliente: clientes, ingresos, media por cliente, renovaciones y tasa de repetición, sobre todos los pagos registrados.
`get_peak_hours`	Visitas, ventas e ingresos por día de la semana y hora en la zona horaria del sitio, y las tres horas de más actividad cuando hay datos suficientes para decirlo.
`get_engagement`	Cómo se leen las páginas: vistas, mediana del tiempo de lectura, profundidad de scroll media y proporción leída hasta el final, por página y en total, y las páginas de entrada y de salida habituales.
`get_purchase_paths`	Cómo llegaron los compradores: tiempo desde la primera visita hasta la compra, visitas y páginas antes de pagar, flujos del primer contacto a la fuente atribuida, y las páginas que vieron los compradores antes de pagar.

03Protocolo

Streamable HTTP con JSON-RPC 2.0, en la revisión 2026-07-28; los clientes de 2025-11-25, 2025-06-18 y 2025-03-26 abren con initialize y también se atienden.
Métodos: server/discover, initialize, tools/list, tools/call y ping.
El structuredContent de un resultado es el JSON de la ruta REST; content contiene un resumen de una línea y, después, el mismo JSON como texto.
Una clave que el plan de la cuenta no cubre recibe 402, y al superar el límite de solicitudes, 429 con Retry-After, igual que en REST.

Una llamada con curl

curl -s "https://tallybyoutpost.com/mcp" \
  -H "Authorization: Bearer $TALLY_API_KEY" \
  -H "Content-Type: application/json" -H "Accept: application/json, text/event-stream" \
  -H "MCP-Protocol-Version: 2026-07-28" -H "Mcp-Method: tools/call" -H "Mcp-Name: get_overview" \
  -d '{"jsonrpc": "2.0", "id": 1, "method": "tools/call",
       "params": {"name": "get_overview", "arguments": {"period": "30d"},
         "_meta": {"io.modelcontextprotocol/protocolVersion": "2026-07-28",
                   "io.modelcontextprotocol/clientInfo": {"name": "curl", "version": "8"},
                   "io.modelcontextprotocol/clientCapabilities": {}}}}'

04Comprueba que funciona

¿Falta algo o no coincide con lo que ves? Escribe a support@tallybyoutpost.com y dinos qué página.