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

MCP-Server für die vTurb Analytics API — stellt 15 Tools bereit, um Echtzeit- und historische Videoanalysen direkt aus Claude abzufragen.

Entwickelt nach dem gleichen Muster wie hotmart-mcp: TypeScript + @modelcontextprotocol/sdk + zod.

Funktionen

15 Analyse-Tools für Sitzungen, Ereignisse, Engagement, Klicks, Conversions, Traffic-Herkunft und mehr
Integriertes Rate-Limiting — Token-Bucket-Algorithmus zur Einhaltung des Pro-Tier-Limits von 120 Anfragen/Min (keine 429-Fehler)
Intelligente Player-Erkennung — find_active_players erkennt automatisch, welches Video heute live ist
Client-spezifische .env-Dateien — saubere Verwaltung von Anmeldedaten für mehrere Konten

Related MCP server: MCP YouTube Intelligence

Anforderungen

Node.js ≥ 18
Ein vTurb-Konto mit Zugriff auf die Analytics API
Ihr API-Token von app.vturb.com/settings/analytics-api
Claude Code (CLI oder VSCode-Erweiterung)

Installation

1. Repository klonen

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

2. `.env`-Datei für jeden Client erstellen

Das MCP verwendet eine .env-Datei pro Client, damit Sie mehrere vTurb-Konten sauber verwalten können. Benennen Sie die Datei nach dem Client:

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

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

Das Dateiformat ist einfach — eine Variable pro Zeile:

VTURB_API_TOKEN=eyJ...

Sicherheit: Committen Sie niemals .env.*-Dateien. Sie sind bereits in der .gitignore enthalten.

3. MCP-Server in Claude Code registrieren

Öffnen Sie ~/.claude/mcp.json (erstellen Sie die Datei, falls sie nicht existiert) und fügen Sie Folgendes hinzu:

{
  "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"
      }
    }
  }
}

Windows-Beispiel:

{
  "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. Claude Code neu starten

Der MCP-Server startet automatisch bei der nächsten Sitzung. Sie sehen ihn in Ihren verfügbaren Tools aufgelistet.

Wechseln zwischen Clients

Um das Konto zu wechseln, aktualisieren Sie einfach VTURB_ENV_FILE in der mcp.json, um auf eine andere .env-Datei zu verweisen, und starten Sie Claude neu:

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

Verfügbare Tools

Erkennung & Überwachung

Tool	Beschreibung
`list_players`	Listet alle Player im Konto mit `id`, `name`, `duration` und `pitch_time` auf. Unterstützt optionale Filter nach Name und Datumsbereich.
`find_active_players`	Intelligentes Tool. Listet alle Player auf, prüft, welche heute aktiv sind, und gibt nur die aktiven Player mit ihren Metadaten zurück. Verwenden Sie dies zuerst, um die korrekte `player_id` zu finden.
`get_quota_usage`	Gibt den aktuellen API-Kontingentstatus zurück: verbrauchte Abfragen, verbleibende Abfragen und Rücksetzzeit. Verwenden Sie dies, um den Verbrauch zu überwachen und das Limit von 120 Anfragen/Min nicht zu überschreiten.
`get_live_users`	Gibt die Anzahl der aktuell zuschauenden Benutzer zurück, aufgeschlüsselt nach Domain. Konfigurierbares Zeitfenster (1–720 Minuten).

Sitzungsanalysen

Tool	Beschreibung
`get_session_stats`	Haupt-Dashboard für einen Player: Gesamtansichten, Wiedergaben, eindeutige Sitzungen/Geräte, Engagement-Rate, Klicks, Conversions und Umsatz in BRL/USD/EUR.
`get_session_stats_by_day`	Gleiche Metriken wie `get_session_stats`, aber tageweise aufgeschlüsselt. Ideal für historische Trendanalysen.

Ereignisse

Tool	Beschreibung
`get_events_total`	Gibt Summen für `started`-, `finished`- und/oder `viewed`-Ereignisse mit eindeutigen Sitzungs- und Gerätezahlen zurück.
`get_events_by_day`	Gleiche Ereignissummen tageweise aufgeschlüsselt für Trendanalysen.

Engagement & Bindung

Tool	Beschreibung
`get_user_engagement`	Gibt die Video-Retentionskurve zurück: wie viele Benutzer pro Sekunde noch zuschauen. Gibt auch `average_watched_time` und `engagement_rate` zurück.
`get_user_engagement_by_day`	Gibt die Engagement-Rate pro Tag über den ausgewählten Zeitraum zurück.

Klicks

Tool	Beschreibung
`get_clicks_timed`	Gibt die Anzahl der CTA-Klicks gruppiert nach Videosekunde zurück. Identifiziert den Moment im Video, der die meiste Interaktion erzeugt.
`get_clicks_by_day`	CTA-Klicksummen tageweise aufgeschlüsselt.

Conversions

Tool	Beschreibung
`get_conversions_by_day`	Conversion-Summen gruppiert nach Tag, mit eindeutigen Sitzungs- und Gerätezahlen.

Traffic-Herkunft

Tool	Beschreibung
`get_traffic_origin_stats`	Schlüsselt Sitzungsmetriken nach Traffic-Quelle auf. Unterstützt `utm_source`, `utm_medium`, `utm_campaign`, `utm_content`, `utm_term`, `src`, `sck`.

Dashboard-Zusammenfassung

Tool	Beschreibung
`get_headlines_stats`	Gibt eine vorausberechnete Zusammenfassung zurück (Ansichten, Wiedergaben, Engagement-Rate, Klicks und Conversion-Rate) — dieselben Zahlen, die im vTurb-Dashboard-Header angezeigt werden.

Typischer Arbeitsablauf

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

Rate Limiting

Der Client verwendet einen Token-Bucket-Algorithmus, der für das Pro-Tier konfiguriert ist:

Limit: 120 Anfragen pro Minute
Auffüllrate: 2 Token pro Sekunde
Verhalten: Anfragen warten automatisch, wenn der Bucket leer ist — keine Fehler, keine Wiederholungsversuche erforderlich

Verwenden Sie get_quota_usage, um den Live-Verbrauch von der vTurb-Seite aus zu überprüfen.

Projektstruktur

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

API-Referenz

vTurb Analytics API Docs
Basis-URL: https://analytics.vturb.net
Auth-Header: X-Api-Token + X-Api-Version: v1

Lizenz

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

Funktionen

Anforderungen

Installation

1. Repository klonen

2. .env-Datei für jeden Client erstellen

3. MCP-Server in Claude Code registrieren

4. Claude Code neu starten

Wechseln zwischen Clients

Verfügbare Tools

Erkennung & Überwachung

Sitzungsanalysen

Ereignisse

Engagement & Bindung

Klicks

Conversions

Traffic-Herkunft

Dashboard-Zusammenfassung

Typischer Arbeitsablauf

Rate Limiting

Projektstruktur

API-Referenz

Lizenz

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. `.env`-Datei für jeden Client erstellen