Guía

Agentes (MCP)

Conectá tu agente de IA a los datos de Vistear con el Model Context Protocol. El agente busca canales, compara audiencias y lee métricas diarias por su cuenta, con tu plan Datos. Es la misma información que la API.

URL del MCPhttps://www.vistear.com/mcp

Requiere claveOAuth o clave de API · Streamable HTTP · solo lectura

Cuota

Cada llamada a una herramienta descuenta 1 consulta de la misma cuota mensual que tus claves de API. Conectarse y listar las herramientas no descuenta. Cuando la cuota se agota se usa tu saldo de paquetes de consultas (se compran en Mi cuenta y no vencen); sin saldo, la herramienta responde un error que el agente puede leer, hasta el reinicio del día 1 del mes que viene (00:00 UTC). Ves el uso del mes y el saldo en Mi cuenta.

Herramientas

search_channels
Busca canales por nombre, handle o id y devuelve sus ids por plataforma.
query, platform, limit
get_live
Lo que está en vivo ahora: totales y transmisiones por espectadores.
limit
get_audience
Audiencia de hasta 25 canales, de 3 horas a 90 días o una ventana de calendario. Por canal (sumando plataformas) o por transmisión.
channels, range | from + to, by, detail
get_daily_metric
Un valor por día y por canal: vistas y likes ganados, suscriptores, horas en vivo, pico diario.
channels, metric, days | from + to
get_video
Resumen de una transmisión (pico, promedio, duración, chat) y su curva.
id, detail
get_video_views
Vistas y likes acumulados de un video de YouTube, por día.
id
get_ranking
Ranking por audiencia en vivo (pico, promedio u horas), vistas ganadas o crecimiento de suscriptores, de hoy, 7 o 30 días.
kind, period, metric, limit
get_schedule
La grilla de un día: transmisiones en vivo, terminadas y programadas.
day
get_channel
Perfil de un canal: cuentas y suscriptores, últimos 30 días al aire y transmisiones recientes.
id, streams

Para no llenar el contexto del agente, get_audience y get_video responden por defecto un resumen por canal (pico y su hora, promedio, horas con datos y último valor). Con detail: "points" suman la curva en hasta 200 puntos (el máximo de cada tramo), y con "full" la grilla completa.

Conectar tu agente

Claude (claude.ai, Desktop y mobile)

Configuración → Conectores → Agregar conector personalizado.
Nombre: Vistear. URL: https://www.vistear.com/mcp.
Conectar: se abre Vistear para que ingreses y permitas el acceso.

ChatGPT

Activá el modo desarrollador en Configuración → Apps y conectores y creá un conector nuevo (según tu plan de ChatGPT).
URL del servidor MCP: https://www.vistear.com/mcp. Autenticación: OAuth.
Al conectar, ingresá a Vistear y permití el acceso.

Claude Code

Con OAuth (abre el navegador la primera vez), o con una clave de API en el encabezado.

claude mcp add --transport http vistear https://www.vistear.com/mcp

Cursor, VS Code y otros clientes

Agregá un servidor MCP remoto (HTTP) con esta configuración. Sin el encabezado, el cliente ofrece el login OAuth.

{
  "mcpServers": {
    "vistear": {
      "url": "https://www.vistear.com/mcp",
      "headers": { "Authorization": "Bearer vk_live_…" }
    }
  }
}

Grok CLI

Con una clave de API en el encabezado, o sin ella para el login OAuth.

grok mcp add --transport http vistear https://www.vistear.com/mcp \
  --header "Authorization: Bearer $VISTEAR_API_KEY"

Autenticación

OAuth 2.1 (Claude, ChatGPT y cualquier cliente que lo soporte): el agente te manda a Vistear, ingresás y permitís el acceso. Soporta registro dinámico de clientes y Client ID Metadata Documents, siempre con PKCE. Los agentes conectados se ven y se desconectan en Mi cuenta.

Clave de API (Claude Code, Cursor, Grok CLI, tus scripts): mandá Authorization: Bearer vk_live_…, igual que en la API.

401Sin credencial, o token vencido o revocado. La respuesta trae WWW-Authenticate con la metadata OAuth para que el cliente inicie el login.
403El plan no incluye la API (Datos la incluye), o la cuenta está bloqueada.

Metadata OAuth

https://www.vistear.com/.well-known/oauth-protected-resource/mcp
https://www.vistear.com/.well-known/oauth-authorization-server