de en es ja ko ru zh

vturb-mcp

Name: vturb-mcp
Author: hiperbold

by hiperbold

Overview Schema Related Servers Score Discussions

TypeScript

Remote

vturb-mcp

Servidor MCP para la API de Analytics de vTurb — expone 15 herramientas para consultar analíticas de video en tiempo real e históricas directamente desde Claude.

Construido con el mismo patrón que hotmart-mcp: TypeScript + @modelcontextprotocol/sdk + zod.

Características

15 herramientas de analítica que cubren sesiones, eventos, interacción, clics, conversiones, origen del tráfico y más.
Limitador de tasa integrado — token bucket que aplica el límite del plan Pro de 120 peticiones/min (sin errores 429).
Detección inteligente de reproductores — find_active_players descubre automáticamente qué video está activo hoy.
Archivos .env por cliente — gestión limpia de credenciales entre múltiples cuentas.

Related MCP server: MCP YouTube Intelligence

Requisitos

Node.js ≥ 18
Una cuenta de vTurb con acceso a la API de Analytics
Tu token de API desde app.vturb.com/settings/analytics-api
Claude Code (CLI o extensión de VSCode)

Instalación

1. Clonar el repositorio

git clone https://github.com/hiperbold/vturb-mcp.git
cd vturb-mcp
npm install
npm run build

2. Crear tu archivo `.env` para cada cliente

El MCP utiliza un archivo .env por cliente para que puedas gestionar múltiples cuentas de vTurb de forma limpia. Nombra el archivo según el cliente:

# Copy the example
cp .env.example .env.nome-do-cliente

# Edit and paste your token
# .env.paula-ardanza
VTURB_API_TOKEN=your_token_here

El formato del archivo es sencillo — una variable por línea:

VTURB_API_TOKEN=eyJ...

Seguridad: Nunca subas archivos .env.* al repositorio. Ya están incluidos en .gitignore.

3. Registrar el servidor MCP en Claude Code

Abre ~/.claude/mcp.json (créalo si no existe) y añade:

{
  "mcpServers": {
    "vturb-mcp": {
      "command": "node",
      "args": ["/absolute/path/to/vturb-mcp/dist/index.js"],
      "env": {
        "VTURB_ENV_FILE": "/absolute/path/to/vturb-mcp/.env.nome-do-cliente"
      }
    }
  }
}

Ejemplo en Windows:

{
  "mcpServers": {
    "vturb-mcp": {
      "command": "node",
      "args": ["F:\\local-mcps\\vturb-mcp\\dist\\index.js"],
      "env": {
        "VTURB_ENV_FILE": "F:\\local-mcps\\vturb-mcp\\.env.paula-ardanza"
      }
    }
  }
}

4. Reiniciar Claude Code

El servidor MCP se inicia automáticamente en la siguiente sesión. Lo verás listado en tus herramientas disponibles.

Cambiar entre clientes

Para cambiar de cuenta, simplemente actualiza VTURB_ENV_FILE en mcp.json para apuntar a un archivo .env diferente y reinicia Claude:

"VTURB_ENV_FILE": "F:\\local-mcps\\vturb-mcp\\.env.outro-cliente"

Herramientas disponibles

Descubrimiento y monitoreo

Herramienta	Descripción
`list_players`	Lista todos los reproductores de la cuenta con `id`, `name`, `duration` y `pitch_time`. Soporta filtros opcionales por nombre y rango de fechas.
`find_active_players`	Herramienta inteligente. Lista todos los reproductores, comprueba cuáles tienen actividad hoy y devuelve solo los activos con sus metadatos. Úsala primero para descubrir el `player_id` correcto.
`get_quota_usage`	Devuelve el estado actual de la cuota de la API: consultas utilizadas, restantes y tiempo de reinicio. Úsala para monitorear el consumo y evitar alcanzar el límite de 120 peticiones/min.
`get_live_users`	Devuelve el número de usuarios viendo actualmente, desglosado por dominio. Ventana de tiempo configurable (1–720 minutos).

Analíticas de sesión

Herramienta	Descripción
`get_session_stats`	Panel principal de analíticas para un reproductor: total de vistas, reproducciones, sesiones/dispositivos únicos, tasa de interacción, clics, conversiones e ingresos en BRL/USD/EUR.
`get_session_stats_by_day`	Las mismas métricas que `get_session_stats` pero desglosadas día a día. Ideal para análisis de tendencias históricas.

Eventos

Herramienta	Descripción
`get_events_total`	Devuelve totales para eventos `started`, `finished` y/o `viewed` con conteos únicos de sesión y dispositivo.
`get_events_by_day`	Los mismos totales de eventos desglosados por día para análisis de tendencias.

Interacción y retención

Herramienta	Descripción
`get_user_engagement`	Devuelve la curva de retención del video: cuántos usuarios siguen viendo en cada segundo. También devuelve `average_watched_time` y `engagement_rate`.
`get_user_engagement_by_day`	Devuelve la tasa de interacción por día durante el periodo seleccionado.

Clics

Herramienta	Descripción
`get_clicks_timed`	Devuelve conteos de clics en CTA agrupados por segundo de video. Identifica el momento en el video que genera más intención.
`get_clicks_by_day`	Totales de clics en CTA desglosados por día.

Conversiones

Herramienta	Descripción
`get_conversions_by_day`	Totales de conversión agrupados por día, con conteos únicos de sesión y dispositivo.

Origen del tráfico

Herramienta	Descripción
`get_traffic_origin_stats`	Desglosa las métricas de sesión por fuente de tráfico. Soporta `utm_source`, `utm_medium`, `utm_campaign`, `utm_content`, `utm_term`, `src`, `sck`.

Resumen del panel

Herramienta	Descripción
`get_headlines_stats`	Devuelve un resumen precalculado (vistas, reproducciones, tasa de interacción, clics y tasa de conversión) — los mismos números que se muestran en el encabezado del panel de vTurb.

Flujo de trabajo típico

1. find_active_players          → discover which player_id is in use today
2. get_session_stats            → get the main KPIs for a date range
3. get_user_engagement          → inspect the retention curve
4. get_clicks_timed             → find when viewers click the CTA
5. get_conversions_by_day       → track conversion trends
6. get_traffic_origin_stats     → compare traffic sources

Limitación de tasa

El cliente utiliza un algoritmo de token bucket configurado para el nivel Pro:

Límite: 120 peticiones por minuto
Tasa de recarga: 2 tokens por segundo
Comportamiento: las peticiones esperan automáticamente si el bucket está vacío — no se lanzan errores, no se necesitan reintentos

Usa get_quota_usage para comprobar el consumo en tiempo real desde el lado de vTurb.

Estructura del proyecto

vturb-mcp/
  src/
    env.ts          — loads .env.* file at startup (via VTURB_ENV_FILE)
    client.ts       — rate-limited HTTP client (token bucket, 120 req/min)
    index.ts        — MCP server, registers all 15 tools
    tools/          — one file per tool
      list-players.ts
      find-active-players.ts
      get-quota-usage.ts
      get-session-stats.ts
      get-session-stats-by-day.ts
      get-events-total.ts
      get-events-by-day.ts
      get-user-engagement.ts
      get-user-engagement-by-day.ts
      get-clicks-timed.ts
      get-clicks-by-day.ts
      get-conversions-by-day.ts
      get-live-users.ts
      get-headlines-stats.ts
      get-traffic-origin-stats.ts
  dist/             — compiled output (run npm run build)
  .env.example      — template for creating client-specific env files

Referencia de la API

Documentación de la API de Analytics de vTurb
URL base: https://analytics.vturb.net
Cabeceras de autenticación: X-Api-Token + X-Api-Version: v1

Licencia

MIT

This server cannot be installed

license - not found

Not graded

quality - not tested

maintenance

How are these scores calculated?

Maintenance

–Maintainers

–Response time

–Release cycle

–Releases (12mo)

Commit activity

Resources

GitHub Repository

Need Help?

Related Servers

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Servers

YouTube Analytics MCP Serverofficial
Databases RAG Systems
CDataSoftware
A
license
Not graded
quality
D
maintenance
This read-only MCP Server allows you to connect to YouTube Analytics data from Claude Desktop through CData JDBC Drivers. Free (beta) read/write servers available at https://www.cdata.com/solutions/mcp
Updated 10 months ago (2025-10-18 19:19 UTC)
1
MIT
MCP YouTube Intelligence
Multimedia Processing Text Summarization Search
JangHyuckYun
A
license
A
quality
C
maintenance
An MCP server for intelligent YouTube video analysis that provides token-optimized summaries, sentiment analysis, and entity extraction from transcripts. It enables AI assistants to perform video reporting, channel monitoring, and comprehensive YouTube searches through structured data tools.
Updated 6 months ago (2026-02-19 01:40 UTC)
10
50
Apache 2.0
wasabi-wacm-connect-mcp
Cloud Platforms Cloud Storage Monitoring
myst3k
A
license
Not graded
quality
D
maintenance
MCP server for the Wasabi WACM Connect API, enabling management of account hierarchy, storage, and billing data through Claude with 18 read-only and 12 opt-in write tools.
Updated 6 months ago (2026-02-26 16:03 UTC)
1
Apache 2.0
mcp-video-vision
Image & Video Processing Multimedia Processing
danusiojr
F
license
B
quality
C
maintenance
MCP server that enables video analysis capabilities to Claude, including frame extraction, scene detection, and video metadata retrieval.
Updated 2 months ago (2026-06-22 22:25 UTC)
8

View all related MCP servers

Related MCP Connectors

clipkit
MCP server for Clipkit — gives AI agents a video toolbox via the Clipkit schema.
DataDoe MCP
Hosted Amazon Seller and Vendor MCP server for Claude, ChatGPT, Cursor, Codex, Gemini, Copilot.
nyc-property-intel
MCP server giving Claude AI access to 22+ NYC public-record databases for real estate due diligence

View all MCP Connectors

Latest Blog Posts

Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)
By Om-Shree-0709 on July 25, 2026.
mcp
Agent Identity
OAuth 2.1
Your AI Chatbot Just Exposed Your CEO's Salary to an Intern
By Om-Shree-0709 on July 2, 2026.
Agent Identity
MCP Security
OAuth Delegation
Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)
By Om-Shree-0709 on June 30, 2026.
Agentic Ai
Prompt Injection
WebAssembly

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/hiperbold/vturb-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server

vturb-mcp

Características

Requisitos

Instalación

1. Clonar el repositorio

2. Crear tu archivo .env para cada cliente

3. Registrar el servidor MCP en Claude Code

4. Reiniciar Claude Code

Cambiar entre clientes

Herramientas disponibles

Descubrimiento y monitoreo

Analíticas de sesión

Eventos

Interacción y retención

Clics

Conversiones

Origen del tráfico

Resumen del panel

Flujo de trabajo típico

Limitación de tasa

Estructura del proyecto

Referencia de la API

Licencia

Maintenance

Resources

Looking for Admin?

Related MCP Servers

YouTube Analytics MCP Serverofficial

MCP YouTube Intelligence

wasabi-wacm-connect-mcp

mcp-video-vision

Related MCP Connectors

Latest Blog Posts

MCP directory API

2. Crear tu archivo `.env` para cada cliente